{
  "openapi": "3.1.0",
  "info": {
    "title": "SportsDesk & Fantasy402 Wire API (evidence-labelled)",
    "version": "2026.10.31",
    "description": "Evidence model: every operation carries x-evidence.tier — A means a captured request and response are verified, B means observed first-party evidence (a captured request or a handler-verified route) without a captured response, C means inferred only with no capture, and D means a real surface missing from the spec; tier-A rows are backed by live capture records in docs/evidence/captures and publish capture-derived response schemas (see docs/EVIDENCE.md).\n\n## GSLive Manager (Partner 118): operator deep links\n\nGSLive is a third-party operator console, **not** a server of this API. The links below are\ndeep links an operator opens in a browser; they carry no request contract of ours. Every\nper-account link is produced by `lib/gslive_manager_deeplink_sidecar.ts` and can be generated\nwith `./bin/dx gslive <LOGIN>`.\n\n| Surface | Route | What it answers |\n| :--- | :--- | :--- |\n| Account report (batch) | `#/reports/users` | Profit, bets, hold %, wager and leg counts for one `player_<LOGIN>` over a day window. |\n| Live settling stream (`calcTime`) | `#/events/bet-history` | Tickets as they settle/populate for the current desk day. |\n| Live placement stream (`betTime`) | `#/events/bet-history` | Tickets as they are placed. |\n\n### Account report rules\n\n- `bot=true` is mandatory. The SPA defaults the bot switch off, which hides syndicate accounts such as `player_CHURN_003` and `player_NOISE_BOT_77`.\n- `from` and `to` must be explicit ISO-8601 UTC desk-day boundaries (`00:00:00` to `23:59:59` in `America/Chicago`). A bare `text=` search renders an empty grid.\n- `searchBy=player` and `text=player_<LOGIN>`; `partnerId=118`.\n\nExample (fixed churn window; the CLI emits today's rolling window):\n\n```text\nhttps://plive.sportswidgets.pro/manager-tools/#/reports/users?bot=true&eventId=&from=2026-10-18T05%3A00%3A00.000Z&partnerId=118&searchBy=player&text=player_CHURN_003&to=2026-10-26T04%3A59%3A59.000Z\n```\n\n### Live bet-history rules\n\n- `from` and `to` are the desk-day start in **epoch seconds**; `toTime` is the offset to the last second of that day (`86399`, or `89999`/`82799` on US DST transition days).\n- `minVolume=0` and `maxTimeUntilScore=0` disable volume/score-time filtering so live tickets appear immediately.\n- `t` is an epoch-millisecond cache-buster and must be fresh on every open.\n- `dateFilterBy=calcTime` follows settlement; `dateFilterBy=betTime` follows placement.\n- `partnerUserId=<LOGIN>` (raw login, e.g. `AF12`) filters to one player; the live console emits the unprefixed form. It is **unverified** as a server-side filter — confirm by row count, and if the grid is not filtered, filter in the console.\n\n```text\nhttps://plive.sportswidgets.pro/manager-tools/#/events/bet-history?minVolume=0&maxTimeUntilScore=0&from=1793422800&to=1793422800&toTime=86399&dateFilterBy=calcTime&t=1793469958152\nhttps://plive.sportswidgets.pro/manager-tools/#/events/bet-history?minVolume=0&maxTimeUntilScore=0&from=1793422800&to=1793422800&toTime=86399&dateFilterBy=betTime&t=1793469958152\n```\n\nPer-player variant (adds `partnerUserId`):\n\n```text\nhttps://plive.sportswidgets.pro/manager-tools/#/events/bet-history?minVolume=0&maxTimeUntilScore=0&from=1793422800&to=1793422800&toTime=86399&dateFilterBy=calcTime&t=1793469958152&partnerUserId=CHURN_003\n```\n\n### Related documentation\n\n- `docs/gs-manager-contracts.md` — observed payloads and open questions.\n- `docs/OPERATOR_QUICKSTART_AND_10_MODE_RUNBOOK.md` — which surface to use for Modes 1, 6, 7, 8, 9 and 10.\n"
  },
  "servers": [
    {
      "url": "https://www.fantasy402.com",
      "description": "Fantasy402 cloud portal (Manager/Report/System API). Tier-A rows carry live request+response captures; other rows are request-side evidence only."
    },
    {
      "url": "http://127.0.0.1:4020",
      "description": "SportsDesk local daemon (Bun.serve; binds 0.0.0.0 by default, PORT=4020)."
    }
  ],
  "tags": [
    {
      "name": "Forensic Surveillance",
      "description": "Cloud Manager surveillance operations with first-party evidence; tier-A rows carry a live request+response capture."
    },
    {
      "name": "Customer State Mutations",
      "description": "Cloud Manager customer state operations with first-party evidence; tier-A rows carry a live request+response capture."
    },
    {
      "name": "Local Desk & Telegram Gateway",
      "description": "Routes served by sportsdesk_webview_server.ts, verified against the handler source rather than an HTTP capture."
    },
    {
      "name": "Downline Accounting",
      "description": "Downline accounting reports (weekly figure, agent performance). The agent-performance request was observed on 2026-11-01; no response body has been captured for any of them."
    },
    {
      "name": "Settlement History",
      "description": "Upstream settlement-history poll wired in code; the request contract and response rows are uncaptured."
    },
    {
      "name": "Inferred (Unverified)",
      "description": "Tier C operations: inferred or authored only. No request or response was ever observed; path and method are candidates, not contracts."
    },
    {
      "name": "Live-captured (request unverified)",
      "description": "Tier-A operations whose path/method were previously inferred (tier C): the response is live-captured, while the request field template is not observed and remains unverified."
    }
  ],
  "paths": {
    "/cloud/api/System/authenticateCustomer": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Authenticate agent/customer session",
        "description": "UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiSystemAuthenticateCustomer",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": [
            "none",
            "docs/runbooks/operational_guardrails_runbook.md:153",
            "docs/openapi.json"
          ],
          "capturedResponse": false,
          "requiredCapture": "Capture one authenticateCustomer POST (redacted credentials): status, Set-Cookie vs body token, response envelope/code field, lifetime, and whether Manager calls then send Authorization or the cookie. Upgrades C->A and validates the whole auth model."
        }
      }
    },
    "/cloud/api/Manager/getBetTicker": {
      "post": {
        "tags": ["Live-captured (request unverified)"],
        "summary": "Live-captured /cloud/api/Manager/getBetTicker (request template unverified)",
        "parameters": [],
        "description": "Live-captured contract: 2026-10-31/getBetTicker.post.json (schemaVersion 1, mode live) recorded POST /cloud/api/Manager/getBetTicker at 2026-10-31T00:19:51.608Z with a 200 response (response body sha256 6476f3f36fde99907c849cc28e3e8ccd7b1b63de43a3f659636c9664054bff5d). Request and response were captured live with redaction clean (policy v1). The response schema is derived from the captured body skeleton and the request schema from the captured request skeleton; no field values are published. The endpoint path/method were previously inferred (tier C); the live capture now evidences both, while the request field template remains unverified.",
        "responses": {
          "200": {
            "description": "Captured live 200 response from 2026-10-31/getBetTicker.post.json; schema derived from the captured body skeleton.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "LIST": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "AgentID": {
                            "type": "string"
                          },
                          "AgentLogin": {
                            "type": "string"
                          },
                          "AmountWagered": {
                            "type": "number"
                          },
                          "CustomerID": {
                            "type": "string"
                          },
                          "InsertDateTime": {
                            "type": "string"
                          },
                          "Login": {
                            "type": "string"
                          },
                          "ShortDesc": {
                            "type": "string"
                          },
                          "TicketWriter": {
                            "type": "string"
                          },
                          "ToWinAmount": {
                            "type": "number"
                          },
                          "VIP": {
                            "type": "string"
                          },
                          "VolumeAmount": {
                            "type": "number"
                          },
                          "WagerNumber": {
                            "type": "number"
                          },
                          "WagerType": {
                            "type": "string",
                            "enum": ["L", "M", "P", "S", "T"]
                          }
                        }
                      },
                      "x-capture-truncated": true
                    }
                  }
                }
              }
            }
          },
          "default": {
            "description": "Other status codes were not captured by this record."
          }
        },
        "x-evidence": {
          "tier": "A",
          "sources": [
            "capture:2026-10-31/getBetTicker.post.json",
            "sha256:7812193f3ba148e79626a877a33a7bdadd1bb6aa8ed61b21cb576511126a5f02"
          ],
          "capturedResponse": true
        },
        "x-capture": {
          "file": "2026-10-31/getBetTicker.post.json",
          "sha256": "7812193f3ba148e79626a877a33a7bdadd1bb6aa8ed61b21cb576511126a5f02",
          "capturedAt": "2026-10-31T00:19:51.608Z",
          "status": 200,
          "samples": 1
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "RRO": {
                    "type": "string"
                  },
                  "agentID": {
                    "type": "string"
                  },
                  "agentOwner": {
                    "type": "string"
                  },
                  "operation": {
                    "type": "string"
                  },
                  "wagerNumber": {
                    "type": "string"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/cloud/api/Manager/getBetTickerConfig": {
      "post": {
        "tags": ["Live-captured (request unverified)"],
        "summary": "Live-captured /cloud/api/Manager/getBetTickerConfig (request template unverified)",
        "parameters": [],
        "description": "Live-captured contract: 2026-10-31/getBetTickerConfig.post.json (schemaVersion 1, mode live) recorded POST /cloud/api/Manager/getBetTickerConfig at 2026-10-31T00:19:51.741Z with a 200 response (response body sha256 8e8fedd17bfabe36c7753dbdf7c5e71f5748adb1fd5b13fe4d8a1993b7ff686e). Request and response were captured live with redaction clean (policy v1). The response schema is derived from the captured body skeleton and the request schema from the captured request skeleton; no field values are published. The endpoint path/method were previously inferred (tier C); the live capture now evidences both, while the request field template remains unverified.",
        "responses": {
          "200": {
            "description": "Captured live 200 response from 2026-10-31/getBetTickerConfig.post.json; schema derived from the captured body skeleton.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "INFO": {
                      "type": "object",
                      "properties": {
                        "AgentID": {
                          "type": "string"
                        },
                        "color1-499": {
                          "type": "string"
                        },
                        "color1000-1999": {
                          "type": "string"
                        },
                        "color10000-100000": {
                          "type": "string"
                        },
                        "color2000-4999": {
                          "type": "string"
                        },
                        "color500-999": {
                          "type": "string"
                        },
                        "color5000-9999": {
                          "type": "string"
                        },
                        "play1-499": {
                          "type": "string"
                        },
                        "play1000-1999": {
                          "type": "string"
                        },
                        "play10000-100000": {
                          "type": "string"
                        },
                        "play2000-4999": {
                          "type": "string"
                        },
                        "play500-999": {
                          "type": "string"
                        },
                        "play5000-9999": {
                          "type": "string"
                        },
                        "showHorses": {
                          "type": "string"
                        },
                        "showIfbets": {
                          "type": "string"
                        },
                        "showParlays": {
                          "type": "string"
                        },
                        "showStraights": {
                          "type": "string"
                        },
                        "showTeasers": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "default": {
            "description": "Other status codes were not captured by this record."
          }
        },
        "x-evidence": {
          "tier": "A",
          "sources": [
            "capture:2026-10-31/getBetTickerConfig.post.json",
            "sha256:d0bf271bd072308af85c0b857b03aa59a42a338f49f479511b4dbffeef39a0c9"
          ],
          "capturedResponse": true
        },
        "x-capture": {
          "file": "2026-10-31/getBetTickerConfig.post.json",
          "sha256": "d0bf271bd072308af85c0b857b03aa59a42a338f49f479511b4dbffeef39a0c9",
          "capturedAt": "2026-10-31T00:19:51.741Z",
          "status": 200,
          "samples": 1
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "RRO": {
                    "type": "string"
                  },
                  "agentID": {
                    "type": "string"
                  },
                  "agentOwner": {
                    "type": "string"
                  },
                  "operation": {
                    "type": "string"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/cloud/api/Manager/getPending": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Pending wager legs snapshot",
        "description": "UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. Repo type evidence: services/simulate_bettor_churn_suite.ts:104-117 (a consumer type declaration, not a capture). See the RawPendingLeg component; it records the field names only and is not used as a response schema here. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiManagerGetPending",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": [
            "services/simulate_bettor_churn_suite.ts:104-117",
            "lib/fantasy402_wager_universe_scope.ts:13-21",
            "docs/openapi.json",
            "docs/evidence/captures/pending-500s/diagnostics.json"
          ],
          "capturedResponse": false,
          "requiredCapture": "Prefix-divergent from /cloud/api/Report/Pending (Tier A, 200 41-46 KB). In Manager report bundle (Blob A7FD1C99), Manager/getPending sends form-urlencoded {agentID, type, operation: \"getPending\", RRO} and reads {LIST, TOTAL}. Re-probe with {agentID, type: \"\", operation: \"getPending\", RRO: \"1\"} or retire in favor of /cloud/api/Report/Pending.",
          "contradicted": true
        }
      }
    },
    "/cloud/api/Manager/getWebLog": {
      "post": {
        "tags": ["Forensic Surveillance"],
        "summary": "Manager getWebLog (mode B request observed; request + response captured)",
        "description": "Live-captured contract: 2026-10-31/getWebLog.post.json (schemaVersion 1, mode live) recorded POST /cloud/api/Manager/getWebLog at 2026-10-31T00:19:51.204Z with a 200 response (response body sha256 979266c4b6abea5fff0de99966ece0363c5354859c92f5260870ea9507d2abaf). Request and response were captured live with redaction clean (policy v1). The response schema is derived from the captured body skeleton and the request schema from the captured request skeleton; no field values are published. The request template is the previously observed Manager envelope.",
        "operationId": "postCloudApiManagerGetWebLog",
        "parameters": [
          {
            "$ref": "#/components/parameters/XRequestedWith"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "RRO": {
                    "type": "string"
                  },
                  "actions": {
                    "type": "string"
                  },
                  "agentID": {
                    "type": "string"
                  },
                  "agentOwner": {
                    "type": "string"
                  },
                  "customerID": {
                    "type": "string"
                  },
                  "end": {
                    "type": "string"
                  },
                  "ip": {
                    "type": "string"
                  },
                  "operation": {
                    "type": "string"
                  },
                  "start": {
                    "type": "string"
                  },
                  "type": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "fantasy402Cookie": []
          }
        ],
        "responses": {
          "200": {
            "description": "Captured live 200 response from 2026-10-31/getWebLog.post.json; schema derived from the captured body skeleton.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "INFO": {
                      "type": "string"
                    },
                    "LIST": {
                      "type": "array"
                    }
                  }
                }
              }
            }
          },
          "default": {
            "description": "Other status codes were not captured by this record."
          }
        },
        "x-evidence": {
          "tier": "A",
          "sources": [
            "capture:2026-10-31/getWebLog.post.json",
            "sha256:3b9a7c7061285460ca36b821af59741f44ea79277ae8bfbe4d100e011f1185ac"
          ],
          "capturedResponse": true
        },
        "x-capture": {
          "file": "2026-10-31/getWebLog.post.json",
          "sha256": "3b9a7c7061285460ca36b821af59741f44ea79277ae8bfbe4d100e011f1185ac",
          "capturedAt": "2026-10-31T00:19:51.204Z",
          "status": 200,
          "samples": 1
        }
      }
    },
    "/cloud/api/Manager/search": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Global account omnisearch",
        "description": "UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiManagerSearch",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": [
            "docs/runbooks/operational_guardrails_runbook.md:205-209",
            "docs/runbooks/operational_guardrails_runbook.md:214",
            "docs/openapi.json"
          ],
          "capturedResponse": false,
          "requiredCapture": "In app/manager/manager.js:49675 (v1.0.280), the omnisearch handler calls POST /cloud/api/Manager/searchCustomerAdmin with {agentID, filter, operation: \"searchCustomerAdmin\", RRO: 1}. Capture searchCustomerAdmin on the wire and reconcile this candidate_url.",
          "candidateUrl": true
        }
      }
    },
    "/cloud/api/Manager/updateByColumn": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Padded-field customer mutation",
        "description": "UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. Repo type evidence: design/domain-branded-types.ts:10,137-155 (a consumer type declaration, not a capture). The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiManagerUpdateByColumn",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": [
            "docs/runbooks/operational_guardrails_runbook.md:215",
            "design/domain-branded-types.ts:10,137-155",
            "docs/openapi.json"
          ],
          "capturedResponse": false,
          "requiredCapture": "Highest-value mutation capture: one updateByColumn with a safe column (confirmationDelaySeconds) plus the getInfoPlayer read-back. Record exact form fields, content type, padding width actually required (11 vs the observed 10), sub-agent vs master scope, and the Result envelope. Upgrades C->A and is the only way to validate the SILENT_NO_OP / REJECTED_SCOPE claims."
        }
      }
    },
    "/cloud/api/Manager/getInfoPlayer": {
      "post": {
        "tags": ["Customer State Mutations"],
        "summary": "Manager getInfoPlayer (request + response captured)",
        "description": "Live-captured contract: 2026-10-31/getInfoPlayer.post.json (schemaVersion 1, mode live) recorded POST /cloud/api/Manager/getInfoPlayer at 2026-10-31T00:19:51.314Z with a 200 response (response body sha256 3eeb9db890d90b53b1c51cf04b7d9c3a47cba5f4c64eac3b541e7f50d39a37e1). Request and response were captured live with redaction clean (policy v1). The response schema is derived from the captured body skeleton and the request schema from the captured request skeleton; no field values are published. The request template is the previously observed Manager envelope.",
        "operationId": "postCloudApiManagerGetInfoPlayer",
        "requestBody": {
          "required": true,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "RRO": {
                    "type": "string"
                  },
                  "agentID": {
                    "type": "string"
                  },
                  "agentOwner": {
                    "type": "string"
                  },
                  "customerID": {
                    "type": "string"
                  },
                  "operation": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "fantasy402Cookie": []
          }
        ],
        "responses": {
          "200": {
            "description": "Captured live 200 response from 2026-10-31/getInfoPlayer.post.json; schema derived from the captured body skeleton.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "INFO": {
                      "type": "null"
                    }
                  }
                }
              }
            }
          },
          "default": {
            "description": "Other status codes were not captured by this record."
          }
        },
        "x-evidence": {
          "tier": "A",
          "sources": [
            "capture:2026-10-31/getInfoPlayer.post.json",
            "sha256:79a5b83c3c818fe6f7356b334c7703839336c4de0857b6ca6f9f62df0938a49e"
          ],
          "capturedResponse": true
        },
        "x-capture": {
          "file": "2026-10-31/getInfoPlayer.post.json",
          "sha256": "79a5b83c3c818fe6f7356b334c7703839336c4de0857b6ca6f9f62df0938a49e",
          "capturedAt": "2026-10-31T00:19:51.314Z",
          "status": 200,
          "samples": 1
        }
      }
    },
    "/cloud/api/Manager/vigSetupInsert": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Insert sport vig setup",
        "description": "UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiManagerVigSetupInsert",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": ["none", "docs/openapi.json"],
          "capturedResponse": false,
          "requiredCapture": "Capture one vigSetupInsert (application/json claimed, 20-char padded sportType) plus getSportsVigSetup read-back; verify content type, padding widths and Result envelope. Upgrades C->A."
        }
      }
    },
    "/cloud/api/Manager/getSportsVigSetup": {
      "post": {
        "tags": ["Live-captured (request unverified)"],
        "summary": "Live-captured /cloud/api/Manager/getSportsVigSetup (request template unverified)",
        "parameters": [],
        "description": "Live-captured contract: 2026-10-31/getSportsVigSetup.post.json (schemaVersion 1, mode live) recorded POST /cloud/api/Manager/getSportsVigSetup at 2026-10-31T00:19:53.742Z with a 200 response (response body sha256 9e34409b3ae72b41bea2421597ae611453b419fa9ff197ccd09ca6627fb4b677). Request and response were captured live with redaction clean (policy v1). The response schema is derived from the captured body skeleton and the request schema from the captured request skeleton; no field values are published. The endpoint path/method were previously inferred (tier C); the live capture now evidences both, while the request field template remains unverified.",
        "responses": {
          "200": {
            "description": "Captured live 200 response from 2026-10-31/getSportsVigSetup.post.json; schema derived from the captured body skeleton.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "LIST": {
                      "type": "array"
                    },
                    "SCHEDULE": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "DisplayLineType": {
                            "type": "string"
                          },
                          "Order": {
                            "type": "number"
                          },
                          "lineType": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "default": {
            "description": "Other status codes were not captured by this record."
          }
        },
        "x-evidence": {
          "tier": "A",
          "sources": [
            "capture:2026-10-31/getSportsVigSetup.post.json",
            "sha256:061bc4d62e351f56c76cb510d012b2e53e2a1db293806a5b70728725139667b8"
          ],
          "capturedResponse": true
        },
        "x-capture": {
          "file": "2026-10-31/getSportsVigSetup.post.json",
          "sha256": "061bc4d62e351f56c76cb510d012b2e53e2a1db293806a5b70728725139667b8",
          "capturedAt": "2026-10-31T00:19:53.742Z",
          "status": 200,
          "samples": 1
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "RRO": {
                    "type": "string"
                  },
                  "agentID": {
                    "type": "string"
                  },
                  "agentOwner": {
                    "type": "string"
                  },
                  "operation": {
                    "type": "string"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/cloud/api/Manager/getInfoManager": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Manager dashboard header",
        "description": "UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiManagerGetInfoManager",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": [
            "docs/evidence/captures/2026-10-31/getInfoManager.post.json",
            "docs/openapi.json",
            "docs/evidence/captures/pending-500s/diagnostics.json"
          ],
          "capturedResponse": false,
          "requiredCapture": "Last observed 500 (0 B) on 2026-10-31. In app/manager/manager.js (v1.0.280, Blob 610B48F7), no getInfoManager operation exists: manager.html boot calls POST /cloud/api/Manager/getAccountInfoOwner (application/json, {agentID, operation}) for accountInfo and POST /cloud/api/Manager/getWeeklyFigureByAgentLite for [data-field=\"grand-total-weekly\"]. Retrieve upstream 500 log or replace with getAccountInfoOwner."
        }
      }
    },
    "/cloud/api/Report/getWeeklyFigure": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Weekly figure report",
        "description": "UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiReportGetWeeklyFigure",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": ["none", "tests/fixtures/portal-left-menu-actions.html"],
          "capturedResponse": false,
          "requiredCapture": "On manager.html (v1.0.280) boot, weekly figures are fetched via POST /cloud/api/Manager/getWeeklyFigureByAgentLite ({agentID, week: 0, type: \"A\", layout: \"byDay\", operation: \"getWeeklyFigureByAgentLite\", RRO: 1} at manager.js:52703) and POST /cloud/api/Manager/getMasterSheet (manager.js:43955). Capture getWeeklyFigureByAgentLite and reconcile."
        }
      }
    },
    "/cloud/api/Manager/getAgentPerformance": {
      "post": {
        "tags": ["Downline Accounting"],
        "summary": "Agent performance report (request observed; response not captured)",
        "description": "Request observed 2026-11-01 on the agent-performance screen: a form-urlencoded POST whose fields are published below in wire order (tests/fixtures/f402-report-requests-observed-2026-11-01.json). Three calls were seen — CP and CPS report kinds — and two details matter: `sport` is padded to 20 characters, and `tipo` is not a constant (0 for CP, -1 for CPS). No response body was ever observed, so no response schema is published and nothing here describes the report's columns.",
        "operationId": "postCloudApiManagerGetAgentPerformance",
        "requestBody": {
          "required": true,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "required": [
                  "start",
                  "end",
                  "agentID",
                  "type",
                  "freePlay",
                  "store",
                  "sport",
                  "subsport",
                  "period",
                  "wagerType",
                  "betType",
                  "tipo",
                  "debug",
                  "operation",
                  "RRO",
                  "agentOwner"
                ],
                "properties": {
                  "start": {
                    "type": "string",
                    "description": "M/D/YYYY."
                  },
                  "end": {
                    "type": "string",
                    "description": "M/D/YYYY."
                  },
                  "agentID": {
                    "type": "string"
                  },
                  "type": {
                    "type": "string",
                    "description": "Report kind: CP (customer performance) or CPS (sport performance) observed."
                  },
                  "freePlay": {
                    "type": "string",
                    "enum": ["Y", "N"]
                  },
                  "store": {
                    "type": "string",
                    "description": "Equals agentID in every observed call."
                  },
                  "sport": {
                    "type": "string",
                    "description": "Sport name padded with spaces to exactly 20 characters (Football, Auto Racing, Tennis, LIVE).",
                    "minLength": 20,
                    "maxLength": 20
                  },
                  "subsport": {
                    "type": "string",
                    "description": "Catalog sub-sport code (NFL, NCAAF Live, …); empty string when unfiltered."
                  },
                  "period": {
                    "type": "string",
                    "description": "Portal period number for that sport, or -1 for all periods. LIVE's menu has only 0 (Game)."
                  },
                  "wagerType": {
                    "type": "string",
                    "description": "Raw portal code; empty when unfiltered."
                  },
                  "betType": {
                    "type": "string",
                    "description": "Raw portal code; empty when unfiltered."
                  },
                  "tipo": {
                    "type": "string",
                    "description": "Observed as 0 for CP and -1 for CPS; not a constant."
                  },
                  "debug": {
                    "type": "string",
                    "enum": ["0"]
                  },
                  "operation": {
                    "type": "string",
                    "enum": ["getAgentPerformance"]
                  },
                  "RRO": {
                    "type": "string",
                    "enum": ["1"]
                  },
                  "agentOwner": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "fantasy402Cookie": []
          }
        ],
        "responses": {
          "default": {
            "description": "Unknown — no response body was observed; no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "B",
          "sources": [
            "tests/fixtures/f402-report-requests-observed-2026-11-01.json",
            "app/manager/module/agent-performance.js?bust=1.0.280"
          ],
          "capturedResponse": false,
          "requiredCapture": "The request is now observed in full, with its URL; only the response is missing. Capture one call and its rows, then confirm whether holdPct is computed server-side and how BranchGrade is applied. Upgrades B->A.",
          "contradicted": true
        }
      }
    },
    "/cloud/api/Report/getSettledFigure": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Settled figure / collections",
        "description": "UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiReportGetSettledFigure",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": [
            "docs/runbooks/operational_guardrails_runbook.md:168",
            "docs/openapi.json"
          ],
          "capturedResponse": false,
          "requiredCapture": "Capture one Collections request/response; verify weekDate format and the 50% split fields. Upgrades C->A.",
          "candidateUrl": true
        }
      }
    },
    "/cloud/api/Report/delete-wager": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Deleted wagers report",
        "description": "UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiReportDeleteWager",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": [
            "docs/runbooks/operational_guardrails_runbook.md:165",
            "docs/openapi.json"
          ],
          "capturedResponse": false,
          "requiredCapture": "UI stage-5 Deleted Wagers action routes to POST /cloud/api/Manager/getReportDeletedTransactions in Blob 96EA5CDA (whereas PendingDelete in report.js:8578 is the read-only Ticket Detail modal lookup). Capture getReportDeletedTransactions and reconcile.",
          "candidateUrl": true
        }
      }
    },
    "/health": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Daemon health and telemetry probe",
        "description": "Handler-defined contract: services/sportsdesk_webview_server.ts returns the daemon's status, bound port/hostname, Bun-reported URL, timestamp, uptime, runtime and NODE_ENV. Verified against the handler source, not an HTTP capture. The daemon binds 0.0.0.0 by default (services/sportsdesk_webview_server.ts,1622-1625), so the example hostname is 0.0.0.0; the http://127.0.0.1:4020 server target is a loopback client view of that bind.",
        "operationId": "getHealth",
        "responses": {
          "200": {
            "description": "Healthy daemon status",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "status",
                    "port",
                    "hostname",
                    "url",
                    "timestamp",
                    "uptimeSeconds",
                    "runtime",
                    "ingress",
                    "nodeEnv"
                  ],
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "healthy"
                    },
                    "port": {
                      "type": "integer",
                      "description": "Bound port; PORT defaults to 4020.",
                      "example": 4020
                    },
                    "hostname": {
                      "type": "string",
                      "description": "Bound hostname. Bun serves on all interfaces by default (0.0.0.0).",
                      "example": "0.0.0.0"
                    },
                    "url": {
                      "type": "string",
                      "description": "server.url as reported by Bun; with hostname 0.0.0.0 the daemon is reachable on all interfaces.",
                      "example": "http://0.0.0.0:4020/"
                    },
                    "timestamp": {
                      "type": "string",
                      "format": "date-time",
                      "example": "2026-10-30T00:00:00.000Z"
                    },
                    "uptimeSeconds": {
                      "type": "integer",
                      "example": 1240
                    },
                    "runtime": {
                      "type": "string",
                      "example": "Bun v1.4.4"
                    },
                    "ingress": {
                      "type": "object",
                      "description": "Peer-trust rule in force, so 'is the PII guard on?' is answerable from the probe. `proxied` is true when the daemon listens on a unix socket and therefore cannot see the client; `trustProxy` is SPORTSDESK_TRUST_PROXY=1.",
                      "required": ["proxied", "trustProxy"],
                      "properties": {
                        "proxied": {
                          "type": "boolean"
                        },
                        "trustProxy": {
                          "type": "boolean"
                        }
                      }
                    },
                    "nodeEnv": {
                      "type": "string",
                      "example": "production"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "B",
          "sources": [
            "services/sportsdesk_webview_server.ts:1704-1720",
            "docs/openapi.json"
          ],
          "capturedResponse": false,
          "requiredCapture": "Not a capture gap: reconcile the spec to services/sportsdesk_webview_server.ts:1704-1720 (add url + timestamp). A curl capture would only confirm the handler."
        }
      }
    },
    "/api/watchlist": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Monitored watch-list accounts",
        "description": "Returns {success, count, data} from telegramService.getWatchList() (services/sportsdesk_webview_server.ts). Requires Authorization: Bearer <SPORTSDESK_ADMIN_TOKEN>; adminRejection returns 503 when the token is unset and 401 otherwise (services/sportsdesk_webview_server.ts).",
        "operationId": "getApiWatchlist",
        "security": [
          {
            "daemonBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Watch-list snapshot",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "count", "data"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": true
                    },
                    "count": {
                      "type": "integer"
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true,
                        "description": "Opaque watch-list entry owned by sportsdesk_telegram_bot.ts; its shape was not captured."
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or wrong admin token (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "B",
          "sources": [
            "services/sportsdesk_webview_server.ts#GET /api/watchlist",
            "services/sportsdesk_webview_server.ts:257-276",
            "docs/openapi.json"
          ],
          "capturedResponse": false,
          "requiredCapture": "No wire capture needed; add the 401/503 responses to the spec from adminRejection (services/sportsdesk_webview_server.ts:257-276)."
        }
      }
    },
    "/api/telegram/alert": {
      "post": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Dispatch an instant Telegram alert",
        "description": "Request body {customerId, riskUSD} is required: customerId must be on the watch list and riskUSD positive, otherwise 400 TelegramTestAlertInputError. Dispatches a labelled synthetic test alert through telegramService.dispatchTestAlert and returns {success, ok, customerId} (services/sportsdesk_webview_server.ts). Admin-token gated (services/sportsdesk_webview_server.ts).",
        "operationId": "postApiTelegramAlert",
        "security": [
          {
            "daemonBearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["customerId", "riskUSD"],
                "properties": {
                  "customerId": {
                    "type": "string",
                    "description": "Watch-list customer to alert."
                  },
                  "riskUSD": {
                    "type": "number",
                    "exclusiveMinimum": 0,
                    "description": "Stake shown on the synthetic test alert."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Alert dispatch result",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "ok", "customerId"],
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "ok": {
                      "type": "boolean",
                      "description": "Whether Telegram accepted the alert."
                    },
                    "customerId": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "TelegramTestAlertInputError: customerId missing or not on the watch list, or riskUSD not positive (services/sportsdesk_telegram_bot.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "ok", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "ok": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or wrong admin token (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Dispatch threw (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "ok", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "ok": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "B",
          "sources": [
            "services/sportsdesk_webview_server.ts:3522-3556",
            "docs/openapi.json"
          ],
          "capturedResponse": false,
          "requiredCapture": "No capture gap; document the Authorization requirement and the 401/503 paths."
        }
      }
    },
    "/api/telegram/report": {
      "post": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Trigger a scheduled Telegram report",
        "description": "Report type is selected by the ?type= query parameter and defaults to EVENING_SETTLEMENT; the handler validates it with isReportType and returns {success, ok, reportType} (services/sportsdesk_webview_server.ts). REPORT_TYPES are MORNING_BRIEFING, MIDDAY_STEAM and EVENING_SETTLEMENT (services/sportsdesk_telegram_bot.ts:80-84). Admin-token gated (services/sportsdesk_webview_server.ts).",
        "operationId": "postApiTelegramReport",
        "security": [
          {
            "daemonBearer": []
          }
        ],
        "parameters": [
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "Report type; defaults to EVENING_SETTLEMENT when absent (services/sportsdesk_webview_server.ts).",
            "schema": {
              "type": "string",
              "enum": [
                "MORNING_BRIEFING",
                "MIDDAY_STEAM",
                "EVENING_SETTLEMENT"
              ],
              "default": "EVENING_SETTLEMENT"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Report dispatch result",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "ok", "reportType"],
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "ok": {
                      "type": "boolean",
                      "description": "Whether Telegram accepted the report."
                    },
                    "reportType": {
                      "type": "string",
                      "enum": [
                        "MORNING_BRIEFING",
                        "MIDDAY_STEAM",
                        "EVENING_SETTLEMENT"
                      ]
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "type is not one of REPORT_TYPES (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or wrong admin token (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "B",
          "sources": [
            "services/sportsdesk_webview_server.ts#POST /api/telegram/report",
            "services/sportsdesk_telegram_bot.ts:80-84",
            "docs/openapi.json"
          ],
          "capturedResponse": false,
          "requiredCapture": "No capture gap; add the ?type= query parameter (enum REPORT_TYPES) and 'ok' to the spec."
        }
      }
    },
    "/cloud/api/System/verifySession": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Verify an existing session",
        "description": "UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiSystemVerifySession",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": [
            "scripts/author_openapi_spec.mjs:98",
            "docs/openapi.json"
          ],
          "capturedResponse": false,
          "requiredCapture": "Capture a verifySession call on a live and an expired token; confirm the response shape and the 401 re-mint behaviour. Upgrades C->A."
        }
      }
    },
    "/cloud/api/Manager/getCustomerNotes": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Read customer notes",
        "description": "UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiManagerGetCustomerNotes",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": [
            "scripts/author_openapi_spec.mjs:130",
            "docs/evidence/captures/2026-10-31/getCustomerNotes.post.json"
          ],
          "capturedResponse": false,
          "requiredCapture": "Last observed 500 (0 B) on 2026-10-31 (handler crashed before response serialization). 1. Retrieve upstream server error log for the 500; 2. Re-probe with the identical 2026-10-31 payload to separate deterministic crash from transient failure."
        }
      }
    },
    "/cloud/api/Manager/updateCustomerNotes": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Update customer notes",
        "description": "UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiManagerUpdateCustomerNotes",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": ["scripts/author_openapi_spec.mjs:153", "none"],
          "capturedResponse": false,
          "requiredCapture": "Capture an append + read-back; confirm the mutation Result envelope and whether notes are immutable. Upgrades C->A."
        }
      }
    },
    "/cloud/api/Manager/deleteSportsVigSetup": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Delete sport vig setup",
        "description": "UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiManagerDeleteSportsVigSetup",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": ["scripts/author_openapi_spec.mjs:173", "none"],
          "capturedResponse": false,
          "requiredCapture": "Capture a delete + getSportsVigSetup read-back; confirm the required fields and Result envelope. Upgrades C->A."
        }
      }
    },
    "/cloud/api/Manager/deleteWager": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Delete a wager",
        "description": "UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiManagerDeleteWager",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": ["scripts/author_openapi_spec.mjs:193", "none"],
          "capturedResponse": false,
          "requiredCapture": "Capture a void/cancel mutation; confirm the request fields (only wagerNumber/reason are documented) and the result envelope. Upgrades C->A."
        }
      }
    },
    "/cloud/api/Report/getDeletedWagerReport": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Deleted wager report",
        "description": "UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiReportGetDeletedWagerReport",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": ["scripts/author_openapi_spec.mjs:213", "none"],
          "capturedResponse": false,
          "requiredCapture": "In the Manager deleted-wagers report bundle (Blob 96EA5CDA), the wire call is POST /cloud/api/Manager/getReportDeletedTransactions. Capture getReportDeletedTransactions and reconcile with /cloud/api/Report/delete-wager."
        }
      }
    },
    "/cloud/api/Report/getDailyFigure": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Daily figure report",
        "description": "UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiReportGetDailyFigure",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": ["scripts/author_openapi_spec.mjs:225", "none"],
          "capturedResponse": false,
          "requiredCapture": "Capture a daily figure read; confirm the request (none is documented) and the row fields. Upgrades C->A."
        }
      }
    },
    "/cloud/api/Manager/gameAdmin": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Launcher tile: Game Admin",
        "description": "UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The launcher-tile DOM metadata (x-dom-tile, x-dom-selector, x-extracted-inputs) is UI observation only and must not be read as wire parameters. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiManagerGameAdmin",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": [
            "main:scripts/portal_tile_crawler.ts:57-66",
            "main:scripts/portal_tile_crawler.ts:545-670",
            "docs/openapi.json"
          ],
          "capturedResponse": false,
          "requiredCapture": "Open the 'Game Admin' launcher tile and capture the network request it actually triggers (URL incl. /Manager vs /Report vs another model prefix, method, content type, body, auth) plus a response. Would replace candidate_url with a confirmed URL and upgrade C->A. Do not promote to B on the tile alone.",
          "candidateUrl": true
        },
        "x-discovery-status": "UNDER_SURVEILLANCE",
        "x-dom-tile": "Game Admin",
        "x-dom-selector": "div.tile:has-text('Game Admin')",
        "x-extracted-inputs": [
          "rotationNumber",
          "sportType",
          "circleLimit",
          "isLocked"
        ],
        "x-data-language-keys": ["L-1034", "L-1052"]
      }
    },
    "/cloud/api/System/getMessages": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Launcher tile: Messaging",
        "description": "UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The launcher-tile DOM metadata (x-dom-tile, x-dom-selector, x-extracted-inputs) is UI observation only and must not be read as wire parameters. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiSystemGetMessages",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": [
            "main:scripts/portal_tile_crawler.ts:68-77",
            "main:scripts/portal_tile_crawler.ts:545-670",
            "docs/openapi.json"
          ],
          "capturedResponse": false,
          "requiredCapture": "On manager.html (v1.0.280) boot, messages are fetched via POST /cloud/api/Manager/getMessage ({acc, type: 0, operation: \"getMessage\", RRO: 1} at manager.js:55125) and POST /cloud/api/Manager/getNewEmailsCount (manager.js:31845). Capture Manager/getMessage and reconcile this candidate_url.",
          "candidateUrl": true
        },
        "x-discovery-status": "UNDER_SURVEILLANCE",
        "x-dom-tile": "Messaging",
        "x-dom-selector": "div.tile:has-text('Messaging')",
        "x-extracted-inputs": [
          "recipientScope",
          "subject",
          "messageBody",
          "priority"
        ],
        "x-data-language-keys": ["L-1055", "L-1056"]
      }
    },
    "/cloud/api/Manager/adjustBalance": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Launcher tile: Cashier",
        "description": "UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The launcher-tile DOM metadata (x-dom-tile, x-dom-selector, x-extracted-inputs) is UI observation only and must not be read as wire parameters. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiManagerAdjustBalance",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": [
            "main:scripts/portal_tile_crawler.ts:79-89",
            "main:scripts/portal_tile_crawler.ts:545-670",
            "docs/openapi.json"
          ],
          "capturedResponse": false,
          "requiredCapture": "Open the 'Cashier' launcher tile and capture the network request it actually triggers (URL incl. /Manager vs /Report vs another model prefix, method, content type, body, auth) plus a response. Would replace candidate_url with a confirmed URL and upgrade C->A. Do not promote to B on the tile alone.",
          "candidateUrl": true
        },
        "x-discovery-status": "UNDER_SURVEILLANCE",
        "x-dom-tile": "Cashier",
        "x-dom-selector": "div.tile:has-text('Cashier')",
        "x-extracted-inputs": [
          "customerID",
          "amountCents",
          "transactionType",
          "notes"
        ],
        "x-data-language-keys": ["L-1031", "L-1045", "L-1058"]
      }
    },
    "/cloud/api/Manager/createPlayer": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Launcher tile: Add Customer",
        "description": "UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The launcher-tile DOM metadata (x-dom-tile, x-dom-selector, x-extracted-inputs) is UI observation only and must not be read as wire parameters. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiManagerCreatePlayer",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": [
            "main:scripts/portal_tile_crawler.ts:91-107",
            "main:scripts/portal_tile_crawler.ts:545-670",
            "docs/openapi.json",
            "docs/runbooks/operational_guardrails_runbook.md:213"
          ],
          "capturedResponse": false,
          "requiredCapture": "Open the 'Add Customer' launcher tile and capture the network request it actually triggers (URL incl. /Manager vs /Report vs another model prefix, method, content type, body, auth) plus a response. Would replace candidate_url with a confirmed URL and upgrade C->A. Do not promote to B on the tile alone.",
          "candidateUrl": true
        },
        "x-discovery-status": "UNDER_SURVEILLANCE",
        "x-dom-tile": "Add Customer",
        "x-dom-selector": "div.tile:has-text('Add Customer')",
        "x-extracted-inputs": [
          "customerID",
          "agentID",
          "password",
          "creditLimit",
          "delaySeconds"
        ],
        "x-data-language-keys": ["L-1031", "L-1032", "L-1040"]
      }
    },
    "/cloud/api/Manager/get3rdPartyLimits": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Launcher tile: 3rd Party Limits",
        "description": "UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The launcher-tile DOM metadata (x-dom-tile, x-dom-selector, x-extracted-inputs) is UI observation only and must not be read as wire parameters. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiManagerGet3rdPartyLimits",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": [
            "main:scripts/portal_tile_crawler.ts:109-120",
            "main:scripts/portal_tile_crawler.ts:545-670",
            "docs/openapi.json"
          ],
          "capturedResponse": false,
          "requiredCapture": "Open the '3rd Party Limits' launcher tile and capture the network request it actually triggers (URL incl. /Manager vs /Report vs another model prefix, method, content type, body, auth) plus a response. Would replace candidate_url with a confirmed URL and upgrade C->A. Do not promote to B on the tile alone.",
          "candidateUrl": true
        },
        "x-discovery-status": "UNDER_SURVEILLANCE",
        "x-dom-tile": "3rd Party Limits",
        "x-dom-selector": "div.tile:has-text('3rd Party Limits')",
        "x-extracted-inputs": ["providerID", "sportCategory", "maxLimitCents"],
        "x-data-language-keys": ["L-1060", "L-1061"]
      }
    },
    "/cloud/api/Report/getAnalysis": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Launcher tile: Analysis",
        "description": "UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The launcher-tile DOM metadata (x-dom-tile, x-dom-selector, x-extracted-inputs) is UI observation only and must not be read as wire parameters. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiReportGetAnalysis",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": [
            "main:scripts/portal_tile_crawler.ts:122-132",
            "main:scripts/portal_tile_crawler.ts:545-670",
            "docs/openapi.json",
            "docs/runbooks/operational_guardrails_runbook.md:166"
          ],
          "capturedResponse": false,
          "requiredCapture": "In app/manager/manager.js:93668 (v1.0.280), the Analysis view calls POST /cloud/api/Manager/getReportPlayerAnalysis ({agentID, agentOwner, customerID, reportType, startDate, endDate, lineType, operation: \"getReportPlayerAnalysis\", RRO: 1}). Capture getReportPlayerAnalysis and reconcile.",
          "candidateUrl": true
        },
        "x-discovery-status": "UNDER_SURVEILLANCE",
        "x-dom-tile": "Analysis",
        "x-dom-selector": "div.tile:has-text('Analysis')",
        "x-extracted-inputs": ["period", "sport", "marketCategory", "agentID"],
        "x-data-language-keys": ["L-1034", "L-1064"]
      }
    },
    "/cloud/api/Manager/getScores": {
      "post": {
        "tags": ["Forensic Surveillance"],
        "summary": "Scores leaderboard (request observed 2026-11-02; response shape partly observed)",
        "description": "The Scores panel sends JSON, not a form: {customerID, operation: \"getScoresLiveDynamic\", RRO: 1, agentID, agentOwner} (operator transcript, 2026-11-02 — no capture artifact exists, so this is a recorded payload rather than a hashed capture). The response is an object with a Scores array; three field names were observed — LogoTeam1, LogoTeam2 and BroadcastInfo — and the logo fields are the portal's image file names (Boston-Celtics.png, Notre Dame Fighting Irish.png, miami_dolphins_logo.png, NHL.png in a team slot), not team names. Every other field is unknown and is not published. The tile's candidate URL (/cloud/api/Manager/getScores) and the path the page actually calls (/cloud/api/Report/getScoresLiveDynamic) disagree; the observed one is authoritative for the panel and the candidate row is kept only so the disagreement stays visible.",
        "operationId": "postCloudApiManagerGetScores",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["operation"],
                "properties": {
                  "operation": {
                    "type": "string",
                    "const": "getScoresLiveDynamic"
                  },
                  "customerID": {
                    "type": "string",
                    "description": "Logged-in account; the observed value was the master agent."
                  },
                  "agentID": {
                    "type": "string"
                  },
                  "agentOwner": {
                    "type": "string"
                  },
                  "RRO": {
                    "type": "integer",
                    "example": 1
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "fantasy402Cookie": []
          }
        ],
        "responses": {
          "200": {
            "description": "An object with a Scores array. Only LogoTeam1, LogoTeam2 and BroadcastInfo were observed; the remaining fields are unknown, so the item schema is open.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["Scores"],
                  "properties": {
                    "Scores": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "description": "One game. The fields below are the ones present in the entry observed on 2026-11-02; the schema stays open because that was a single entry and the portal pads and re-types values in ways a schema would otherwise misrepresent. Padded strings (SportSubType, SportType, Grouping, CorrelationID) carry trailing spaces; Team1Score/Team2Score/Total are numeric text, not numbers; GameDateTime is `YYYY-MM-DD HH:mm:ss.SSS`, not ISO 8601.",
                        "properties": {
                          "LogoTeam1": {
                            "type": "string",
                            "description": "Portal image file name for the first side, e.g. Los-Angeles-Clippers.png; resolve through /api/logo/{name}."
                          },
                          "LogoTeam2": {
                            "type": "string",
                            "description": "Portal image file name for the second side; same vocabulary, including league logos such as NHL.png in a team slot."
                          },
                          "BroadcastInfo": {
                            "type": "string",
                            "description": "Whitespace-only in the observed entry."
                          },
                          "Record": {
                            "type": "string"
                          },
                          "Record2": {
                            "type": "string"
                          },
                          "Rank": {
                            "type": "string"
                          },
                          "Rank2": {
                            "type": "string"
                          },
                          "GameNum": {
                            "type": "integer",
                            "example": 619121357
                          },
                          "Team1RotNum": {
                            "type": "integer",
                            "description": "Board rotation for the first side; should be stable per Team1ID, which is what the rotation check enforces."
                          },
                          "Team2RotNum": {
                            "type": "integer"
                          },
                          "STATUS": {
                            "type": "string",
                            "description": "Observed value `O`; the full code set is unknown."
                          },
                          "GameDateTime": {
                            "type": "string"
                          },
                          "SportSubType": {
                            "type": "string",
                            "description": "Padded with trailing spaces (observed `NBA         `)."
                          },
                          "SportType": {
                            "type": "string",
                            "description": "Padded with trailing spaces (observed `Basketball          `)."
                          },
                          "DisplaySubType": {
                            "type": "string",
                            "example": "NBA"
                          },
                          "PeriodNumber": {
                            "type": "integer"
                          },
                          "PeriodDescription": {
                            "type": "string",
                            "example": "Game"
                          },
                          "Team1ID": {
                            "type": "string",
                            "description": "Full team name (`Los Angeles Clippers`)."
                          },
                          "Team2ID": {
                            "type": "string"
                          },
                          "STeam1ID": {
                            "type": "string",
                            "description": "Short name (`Clippers`)."
                          },
                          "STeam2ID": {
                            "type": "string"
                          },
                          "Team1Score": {
                            "type": "string",
                            "description": "Numeric text (observed `57`), not a number."
                          },
                          "Team2Score": {
                            "type": "string"
                          },
                          "Final": {
                            "type": "string",
                            "example": "Not Final"
                          },
                          "Spread": {
                            "type": "number",
                            "description": "Number, unlike the score fields."
                          },
                          "SpreadAdj1": {
                            "type": "number"
                          },
                          "SpreadAdj2": {
                            "type": "number"
                          },
                          "MoneyLine1": {
                            "type": "number"
                          },
                          "MoneyLine2": {
                            "type": "number"
                          },
                          "MoneyLineDraw": {
                            "type": ["number", "null"]
                          },
                          "Total": {
                            "type": "string",
                            "description": "Numeric text (observed `220.5`)."
                          },
                          "Favorito": {
                            "type": "string",
                            "description": "Team name, not an id."
                          },
                          "Grouping": {
                            "type": "string",
                            "description": "Padded league name (observed `NBA         `)."
                          },
                          "StatusAway": {
                            "type": "string",
                            "description": "Per-side clock/period state; observed `Time` beside `Half`. Semantics unconfirmed."
                          },
                          "StatusHome": {
                            "type": "string"
                          },
                          "CorrelationID": {
                            "type": "string",
                            "description": "`<Team1RotNum>-g` padded to a fixed width (observed `539-g` + trailing spaces); joins to Team1RotNum."
                          },
                          "DefaultMainLine": {
                            "type": "string",
                            "example": "Spread"
                          },
                          "TotalPoints": {
                            "type": ["number", "null"]
                          }
                        },
                        "additionalProperties": true
                      }
                    }
                  }
                }
              }
            }
          },
          "default": {
            "description": "Unknown — no response artifact was captured; status codes other than 200 are not documented."
          }
        },
        "x-evidence": {
          "tier": "B",
          "sources": [
            "main:scripts/portal_tile_crawler.ts:134-149",
            "main:scripts/portal_tile_crawler.ts:545-670",
            "docs/openapi.json",
            "docs/evidence/capture-requests.md"
          ],
          "capturedResponse": false,
          "requiredCapture": "A redacted capture of POST /cloud/api/Report/getScoresLiveDynamic (request and response) to replace the 2026-11-02 operator transcript with an artifact. The request body and three response field names are known; the remaining fields and the non-200 statuses are not.",
          "candidateUrl": true
        }
      }
    },
    "/cloud/api/Manager/getAgentTree": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Launcher tile: Agent Admin",
        "description": "UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The launcher-tile DOM metadata (x-dom-tile, x-dom-selector, x-extracted-inputs) is UI observation only and must not be read as wire parameters. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiManagerGetAgentTree",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": [
            "main:scripts/portal_tile_crawler.ts:151-161",
            "main:scripts/portal_tile_crawler.ts:545-670",
            "docs/openapi.json"
          ],
          "capturedResponse": false,
          "requiredCapture": "On manager.html (v1.0.280) boot, downline hierarchy is fetched via POST /cloud/api/Manager/getListAgenstByAgent [sic] ({agentID, agentType, operation: \"getListAgenstByAgent\", RRO: 1} at manager.js:60492) and POST /cloud/api/Manager/getHeriarchy [sic] (manager.js:33074). Capture getListAgenstByAgent and reconcile.",
          "candidateUrl": true
        },
        "x-discovery-status": "UNDER_SURVEILLANCE",
        "x-dom-tile": "Agent Admin",
        "x-dom-selector": "div.tile:has-text('Agent Admin')",
        "x-extracted-inputs": [
          "masterAgent",
          "commissionSplitPercent",
          "creditCeiling"
        ],
        "x-data-language-keys": ["L-1032", "L-1070"]
      }
    },
    "/cloud/api/Manager/getBilling": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Launcher tile: Billing",
        "description": "UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The launcher-tile DOM metadata (x-dom-tile, x-dom-selector, x-extracted-inputs) is UI observation only and must not be read as wire parameters. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiManagerGetBilling",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": [
            "main:scripts/portal_tile_crawler.ts:163-172",
            "main:scripts/portal_tile_crawler.ts:545-670",
            "docs/openapi.json"
          ],
          "capturedResponse": false,
          "requiredCapture": "Open the 'Billing' launcher tile and capture the network request it actually triggers (URL incl. /Manager vs /Report vs another model prefix, method, content type, body, auth) plus a response. Would replace candidate_url with a confirmed URL and upgrade C->A. Do not promote to B on the tile alone.",
          "candidateUrl": true
        },
        "x-discovery-status": "UNDER_SURVEILLANCE",
        "x-dom-tile": "Billing",
        "x-dom-selector": "div.tile:has-text('Billing')",
        "x-extracted-inputs": [
          "billingWeek",
          "ratePerActiveHead",
          "activeAccountCount"
        ],
        "x-data-language-keys": ["L-1050", "L-1072"]
      }
    },
    "/cloud/api/Manager/getRules": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Launcher tile: Rules",
        "description": "UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The launcher-tile DOM metadata (x-dom-tile, x-dom-selector, x-extracted-inputs) is UI observation only and must not be read as wire parameters. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiManagerGetRules",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": [
            "main:scripts/portal_tile_crawler.ts:174-188",
            "main:scripts/portal_tile_crawler.ts:545-670",
            "docs/openapi.json"
          ],
          "capturedResponse": false,
          "requiredCapture": "Open the 'Settings & Rules' launcher tile and capture the network request it actually triggers (URL incl. /Manager vs /Report vs another model prefix, method, content type, body, auth) plus a response. Would replace candidate_url with a confirmed URL and upgrade C->A. Do not promote to B on the tile alone.",
          "candidateUrl": true
        },
        "x-discovery-status": "UNDER_SURVEILLANCE",
        "x-dom-tile": "Rules",
        "x-dom-selector": "div.tile:has-text('Rules')",
        "x-extracted-inputs": [
          "parlayMaxPayout",
          "teaserTieRule",
          "defaultDelaySeconds"
        ],
        "x-data-language-keys": ["L-1040", "L-1075"]
      }
    },
    "/cloud/api/Report/getFinancialReport": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "Launcher tile: Transactions History",
        "description": "UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The launcher-tile DOM metadata (x-dom-tile, x-dom-selector, x-extracted-inputs) is UI observation only and must not be read as wire parameters. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiReportGetFinancialReport",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": [
            "main:scripts/portal_tile_crawler.ts:190-205",
            "main:scripts/portal_tile_crawler.ts:545-670",
            "docs/openapi.json",
            "docs/runbooks/operational_guardrails_runbook.md:167"
          ],
          "capturedResponse": false,
          "requiredCapture": "Open the 'Transactions History' launcher tile and capture the network request it actually triggers (URL incl. /Manager vs /Report vs another model prefix, method, content type, body, auth) plus a response. Would replace candidate_url with a confirmed URL and upgrade C->A. Do not promote to B on the tile alone.",
          "candidateUrl": true
        },
        "x-discovery-status": "UNDER_SURVEILLANCE",
        "x-dom-tile": "Transactions History",
        "x-dom-selector": "div.tile:has-text('Transactions History')",
        "x-extracted-inputs": [
          "customerID",
          "startDate",
          "endDate",
          "transactionFilter"
        ],
        "x-data-language-keys": ["L-1031", "L-1033", "L-1058"]
      }
    },
    "/cloud/api/Report/Pending": {
      "post": {
        "tags": ["Live-captured (request unverified)"],
        "summary": "Live-captured /cloud/api/Report/Pending (request template unverified)",
        "parameters": [],
        "description": "Live-captured contract: 2026-11-01/Pending.post.json (schemaVersion 1, mode live) recorded POST /cloud/api/Report/Pending at 2026-11-01T02:22:35.774Z with a 200 response (response body sha256 6c65708478ad70ca3286c68cb0e32e400998d7f4c9fed2f8c614084315e2c277). Request and response were captured live with redaction clean (policy v1). The response schema is derived from the captured body skeleton and the request schema from the captured request skeleton; no field values are published. The endpoint path/method were previously inferred (tier C); the live capture now evidences both, while the request field template remains unverified.",
        "responses": {
          "200": {
            "description": "Captured live 200 response from 2026-11-01/Pending.post.json; schema derived from the captured body skeleton.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "Pending": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "ARBirdcageLink": {
                            "type": "null"
                          },
                          "ARLink": {
                            "type": "null"
                          },
                          "AcceptedDateTime": {
                            "type": "string"
                          },
                          "AdjSpread": {
                            "type": "number"
                          },
                          "AdjTotalPoints": {
                            "type": "number"
                          },
                          "AdjustableOddsFlag": {
                            "type": "string"
                          },
                          "AmountLost": {
                            "type": "null"
                          },
                          "AmountRefunded": {
                            "type": "null"
                          },
                          "AmountWagered": {
                            "type": "number"
                          },
                          "AmountWon": {
                            "type": "null"
                          },
                          "BoxLink": {
                            "type": "null"
                          },
                          "BuyPoints": {
                            "type": "number"
                          },
                          "ChosenTeamID": {
                            "type": "string"
                          },
                          "Comments": {
                            "type": "string"
                          },
                          "ContinueOnPushFlag": {
                            "type": "null"
                          },
                          "CreditAcctFlag": {
                            "type": "string"
                          },
                          "Description": {
                            "type": "string"
                          },
                          "FinalDecimal": {
                            "type": "null"
                          },
                          "FinalMoney": {
                            "type": "number"
                          },
                          "FreePlayFlag": {
                            "type": "string"
                          },
                          "GameDateTime": {
                            "type": "string"
                          },
                          "ItemNumber": {
                            "type": "number"
                          },
                          "LegAmountWagered": {
                            "type": "number"
                          },
                          "LegToWinAmount": {
                            "type": "number"
                          },
                          "LegWagerType": {
                            "type": "string"
                          },
                          "ListedPitcher1": {
                            "type": "null"
                          },
                          "ListedPitcher2": {
                            "type": "null"
                          },
                          "Login": {
                            "type": "string"
                          },
                          "LogoTeam1": {
                            "type": "string"
                          },
                          "LogoTeam2": {
                            "type": "string"
                          },
                          "NameFirst": {
                            "type": "string"
                          },
                          "OrigSpread": {
                            "type": "number"
                          },
                          "OrigTotalPoints": {
                            "type": "number"
                          },
                          "Outcome": {
                            "type": "string"
                          },
                          "ParlayName": {
                            "type": "string"
                          },
                          "Password": {
                            "type": "string"
                          },
                          "PeriodDescription": {
                            "type": "string"
                          },
                          "PeriodNumber": {
                            "type": "number"
                          },
                          "Pitcher1ReqFlag": {
                            "type": "string"
                          },
                          "Pitcher2ReqFlag": {
                            "type": "string"
                          },
                          "PlacedOn": {
                            "type": "string"
                          },
                          "PlayNumber": {
                            "type": "number"
                          },
                          "RifBackwardTicketNumber": {
                            "type": "null"
                          },
                          "RifBackwardWagerNumber": {
                            "type": "null"
                          },
                          "RifForwardAmountWagered": {
                            "type": "null"
                          },
                          "RifForwardTicketNumber": {
                            "type": "null"
                          },
                          "RifForwardWagerNumber": {
                            "type": "null"
                          },
                          "RifForwardWinOnlyFlag": {
                            "type": "null"
                          },
                          "RifNoActionFlag": {
                            "type": "null"
                          },
                          "RifWinOnlyFlag": {
                            "type": "null"
                          },
                          "RoundRobinLink": {
                            "type": "null"
                          },
                          "ShortName1": {
                            "type": "string"
                          },
                          "ShortName2": {
                            "type": "string"
                          },
                          "SportSubType": {
                            "type": "string"
                          },
                          "SportType": {
                            "type": "string"
                          },
                          "Team1FinalScore": {
                            "type": "number"
                          },
                          "Team1ID": {
                            "type": "string"
                          },
                          "Team1RotNum": {
                            "type": "number"
                          },
                          "Team2FinalScore": {
                            "type": "number"
                          },
                          "Team2ID": {
                            "type": "string"
                          },
                          "Team2RotNum": {
                            "type": "number"
                          },
                          "TeaserName": {
                            "type": "null"
                          },
                          "TeaserPoints": {
                            "type": "number"
                          },
                          "TicketNumber": {
                            "type": "number"
                          },
                          "Ties": {
                            "type": "number"
                          },
                          "ToWinAmount": {
                            "type": "number"
                          },
                          "TotalPointsOU": {
                            "type": "null"
                          },
                          "WagerCount": {
                            "type": "number"
                          },
                          "WagerNumber": {
                            "type": "number"
                          },
                          "WagerStatus": {
                            "type": "string"
                          },
                          "WagerType": {
                            "type": "string",
                            "enum": ["S"]
                          },
                          "customerID": {
                            "type": "string"
                          },
                          "totalPicks": {
                            "type": "number"
                          }
                        }
                      }
                    }
                  },
                  "x-capture-truncated": true
                }
              }
            }
          },
          "default": {
            "description": "Other status codes were not captured by this record."
          }
        },
        "x-evidence": {
          "tier": "A",
          "sources": [
            "capture:2026-11-01/Pending.post.json",
            "sha256:719cb5f63fe0123aa26e02a01e4969a7051bc822e1e0fb9de42ea3308896dcc3"
          ],
          "capturedResponse": true
        },
        "x-capture": {
          "file": "2026-11-01/Pending.post.json",
          "sha256": "719cb5f63fe0123aa26e02a01e4969a7051bc822e1e0fb9de42ea3308896dcc3",
          "capturedAt": "2026-11-01T02:22:35.774Z",
          "status": 200,
          "samples": 1
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "customerID": {
                    "type": "string"
                  },
                  "operation": {
                    "type": "string"
                  },
                  "token": {
                    "type": "string"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/cloud/api/Report/PendingDelete": {
      "post": {
        "tags": ["Live-captured (request unverified)"],
        "summary": "Live-captured /cloud/api/Report/PendingDelete (request template unverified)",
        "parameters": [],
        "description": "Live-captured contract: 2026-11-01/PendingDelete.post.json (schemaVersion 1, mode live) recorded POST /cloud/api/Report/PendingDelete at 2026-11-01T04:19:29.720Z with a 200 response (response body sha256 af7ff3397ceee92fbfe8142bbcfee14c72b8cb94adc897af19555235dfbad335). Request and response were captured live with redaction clean (policy v1). The response schema is derived from the captured body skeleton and the request schema from the captured request skeleton; no field values are published. The endpoint path/method were previously inferred (tier C); the live capture now evidences both, while the request field template remains unverified.",
        "responses": {
          "200": {
            "description": "Captured live 200 response from 2026-11-01/PendingDelete.post.json; schema derived from the captured body skeleton.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "Pending": {
                      "type": "array"
                    }
                  }
                }
              }
            }
          },
          "default": {
            "description": "Other status codes were not captured by this record."
          }
        },
        "x-evidence": {
          "tier": "A",
          "sources": [
            "capture:2026-11-01/PendingDelete.post.json",
            "sha256:c1aa1efea5f537c2db2d036c07d9a0423e5f5f1bd9fb53d62ef308cde9aef59e"
          ],
          "capturedResponse": true
        },
        "x-capture": {
          "file": "2026-11-01/PendingDelete.post.json",
          "sha256": "c1aa1efea5f537c2db2d036c07d9a0423e5f5f1bd9fb53d62ef308cde9aef59e",
          "capturedAt": "2026-11-01T04:19:29.720Z",
          "status": 200,
          "samples": 1
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "customerID": {
                    "type": "string"
                  },
                  "operation": {
                    "type": "string"
                  },
                  "ticketNumber": {
                    "type": "string"
                  },
                  "token": {
                    "type": "string"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/cloud/api/Report/getDailyFiguresByCustomer": {
      "post": {
        "tags": ["Live-captured (request unverified)"],
        "summary": "Live-captured /cloud/api/Report/getDailyFiguresByCustomer (request template unverified)",
        "parameters": [],
        "description": "Live-captured contract: 2026-11-01/getDailyFiguresByCustomer.post.json (schemaVersion 1, mode live) recorded POST /cloud/api/Report/getDailyFiguresByCustomer at 2026-11-01T04:05:20.098Z with a 200 response (response body sha256 b072a7a032394c3c24182b89587d8881878cb077a6a2690279d3f66eb00e54df). Request and response were captured live with redaction clean (policy v1). The response schema is derived from the captured body skeleton and the request schema from the captured request skeleton; no field values are published. The endpoint path/method were previously inferred (tier C); the live capture now evidences both, while the request field template remains unverified.",
        "responses": {
          "200": {
            "description": "Captured live 200 response from 2026-11-01/getDailyFiguresByCustomer.post.json; schema derived from the captured body skeleton.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "INFO": {
                      "type": "boolean"
                    }
                  }
                }
              }
            }
          },
          "default": {
            "description": "Other status codes were not captured by this record."
          }
        },
        "x-evidence": {
          "tier": "A",
          "sources": [
            "capture:2026-11-01/getDailyFiguresByCustomer.post.json",
            "sha256:2d93abcd22ea99b329d417e0771c82efa912f80b291cb0b59194726ad3a7a3b6"
          ],
          "capturedResponse": true
        },
        "x-capture": {
          "file": "2026-11-01/getDailyFiguresByCustomer.post.json",
          "sha256": "2d93abcd22ea99b329d417e0771c82efa912f80b291cb0b59194726ad3a7a3b6",
          "capturedAt": "2026-11-01T04:05:20.098Z",
          "status": 200,
          "samples": 1
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "agentID": {
                    "type": "string"
                  },
                  "customerID": {
                    "type": "string"
                  },
                  "operation": {
                    "type": "string"
                  },
                  "week": {
                    "type": "string"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/cloud/api/Report/getGradedWagerByCustomer": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "POST /cloud/api/Report/getGradedWagerByCustomer",
        "description": "UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. Repo type evidence: main:lib/combo_identity.ts:49-67 (a consumer type declaration, not a capture). The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiReportGetGradedWagerByCustomer",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": [
            "main:lib/combo_identity.ts:49-67",
            "docs/evidence/captures/pending-500s/diagnostics.json"
          ],
          "capturedResponse": false,
          "requiredCapture": "Prefix-identical 500 (0 B) on both /Manager and /Report on 2026-11-01 (shared handler threw before response serialization). 1. Retrieve upstream server error log for the shared handler group; 2. Re-probe with the identical captured payload, then test integer week=0 per customer/report/report.js:33171."
        }
      }
    },
    "/cloud/api/Manager/getTransactions": {
      "post": {
        "tags": ["Live-captured (request unverified)"],
        "summary": "Live-captured /cloud/api/Manager/getTransactions (request template unverified)",
        "parameters": [],
        "description": "Live-captured contract: 2026-11-01/getTransactions.post.json (schemaVersion 1, mode live) recorded POST /cloud/api/Manager/getTransactions at 2026-11-01T02:07:42.209Z with a 200 response (response body sha256 b94c156e0df3642d4283373c789a45ccf6d7e81b9997e44517fa19ff3f09dc9c). Request and response were captured live with redaction clean (policy v1). The response schema is derived from the captured body skeleton and the request schema from the captured request skeleton; no field values are published. The endpoint path/method were previously inferred (tier C); the live capture now evidences both, while the request field template remains unverified.",
        "responses": {
          "200": {
            "description": "Captured live 200 response from 2026-11-01/getTransactions.post.json; schema derived from the captured body skeleton.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "LIST": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "default": {
            "description": "Other status codes were not captured by this record."
          }
        },
        "x-evidence": {
          "tier": "A",
          "sources": [
            "capture:2026-11-01/getTransactions.post.json",
            "sha256:3de9ac6c0f61a78d131416a0ed8d14e3bed065675b0106f25e53dea97c303ef7"
          ],
          "capturedResponse": true
        },
        "x-capture": {
          "file": "2026-11-01/getTransactions.post.json",
          "sha256": "3de9ac6c0f61a78d131416a0ed8d14e3bed065675b0106f25e53dea97c303ef7",
          "capturedAt": "2026-11-01T02:07:42.209Z",
          "status": 200,
          "samples": 1
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "RRO": {
                    "type": "string"
                  },
                  "agentID": {
                    "type": "string"
                  },
                  "agentOwner": {
                    "type": "string"
                  },
                  "customerID": {
                    "type": "string"
                  },
                  "operation": {
                    "type": "string"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/cloud/api/Report/getGrading": {
      "post": {
        "tags": ["Live-captured (request unverified)"],
        "summary": "Live-captured /cloud/api/Report/getGrading (request template unverified)",
        "parameters": [],
        "description": "Live-captured contract: 2026-11-01/getGrading.post.json (schemaVersion 1, mode live) recorded POST /cloud/api/Report/getGrading at 2026-11-01T02:22:35.993Z with a 200 response (response body sha256 b94c156e0df3642d4283373c789a45ccf6d7e81b9997e44517fa19ff3f09dc9c). Request and response were captured live with redaction clean (policy v1). The response schema is derived from the captured body skeleton and the request schema from the captured request skeleton; no field values are published. The endpoint path/method were previously inferred (tier C); the live capture now evidences both, while the request field template remains unverified.",
        "responses": {
          "200": {
            "description": "Captured live 200 response from 2026-11-01/getGrading.post.json; schema derived from the captured body skeleton.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "LIST": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "default": {
            "description": "Other status codes were not captured by this record."
          }
        },
        "x-evidence": {
          "tier": "A",
          "sources": [
            "capture:2026-11-01/getGrading.post.json",
            "sha256:253af38aeb01e56e32e0db8922efc7ec525cc2aa53f1b345c41be5675483c06c"
          ],
          "capturedResponse": true
        },
        "x-capture": {
          "file": "2026-11-01/getGrading.post.json",
          "sha256": "253af38aeb01e56e32e0db8922efc7ec525cc2aa53f1b345c41be5675483c06c",
          "capturedAt": "2026-11-01T02:22:35.993Z",
          "status": 200,
          "samples": 1
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "customerID": {
                    "type": "string"
                  },
                  "operation": {
                    "type": "string"
                  },
                  "token": {
                    "type": "string"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/cloud/api/Report/getTicketDetailPrint": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "POST /cloud/api/Report/getTicketDetailPrint",
        "description": "UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. Repo type evidence: main:lib/combo_identity.ts:49-67 (a consumer type declaration, not a capture). The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiReportGetTicketDetailPrint",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": [
            "main:lib/combo_identity.ts:49-67",
            "docs/evidence/captures/pending-500s/diagnostics.json"
          ],
          "capturedResponse": false,
          "requiredCapture": "Prefix-identical 500 (0 B) on both /Manager and /Report on 2026-11-01 when ticketNumber/wagerNumber were omitted. 1. Retrieve upstream server error log; 2. Re-probe identical payload, then probe with the 5-key customer/report/report.js:108955 envelope {token, ticketNumber, wagerNumber, flag, operation}."
        }
      }
    },
    "/cloud/api/Manager/getSportsType": {
      "post": {
        "tags": ["Live-captured (request unverified)"],
        "summary": "Live-captured /cloud/api/Manager/getSportsType (request template unverified)",
        "parameters": [],
        "description": "Live-captured contract: 2026-10-31/getSportsType.post.json (schemaVersion 1, mode live) recorded POST /cloud/api/Manager/getSportsType at 2026-10-31T00:21:29.359Z with a 200 response (response body sha256 105edc9c5766b3d5f0e896d3267286ce404cf2c6ef755a3ed92bcbba3c5f4221). Request and response were captured live with redaction clean (policy v1). The response schema is derived from the captured body skeleton and the request schema from the captured request skeleton; no field values are published. The endpoint path/method were previously inferred (tier C); the live capture now evidences both, while the request field template remains unverified.",
        "responses": {
          "200": {
            "description": "Captured live 200 response from 2026-10-31/getSportsType.post.json; schema derived from the captured body skeleton.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "LIST": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "0": {
                            "type": "string"
                          },
                          "sportType": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "default": {
            "description": "Other status codes were not captured by this record."
          }
        },
        "x-evidence": {
          "tier": "A",
          "sources": [
            "capture:2026-10-31/getSportsType.post.json",
            "sha256:436e1cc17b831c747b322ac900146da22fe229dcaec685f3751ab38b7d92396d"
          ],
          "capturedResponse": true
        },
        "x-capture": {
          "file": "2026-10-31/getSportsType.post.json",
          "sha256": "436e1cc17b831c747b322ac900146da22fe229dcaec685f3751ab38b7d92396d",
          "capturedAt": "2026-10-31T00:21:29.359Z",
          "status": 200,
          "samples": 1
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "RRO": {
                    "type": "string"
                  },
                  "agentID": {
                    "type": "string"
                  },
                  "agentOwner": {
                    "type": "string"
                  },
                  "operation": {
                    "type": "string"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/cloud/api/Manager/getConfigWebReports": {
      "post": {
        "tags": ["Downline Accounting"],
        "summary": "Boot web-report configuration (request observed 2026-11-01; no response schema)",
        "description": "manager.js:35023 boot report-configuration read. The form body is the one the 2026-11-01 boot HAR recorded: agentID, operation, RRO and agentOwner (agentID and agentOwner were the same master account). The portal consumes the reply as an INFO envelope; its keys are not published because no capture record holds them.",
        "operationId": "postCloudApiManagerGetConfigWebReports",
        "requestBody": {
          "required": true,
          "content": {
            "application/x-www-form-urlencoded; charset=UTF-8": {
              "schema": {
                "type": "object",
                "required": ["agentID", "operation", "RRO", "agentOwner"],
                "properties": {
                  "operation": {
                    "type": "string",
                    "const": "getConfigWebReports"
                  },
                  "agentID": {
                    "type": "string",
                    "description": "Logged-in account; the observed value was the master agent."
                  },
                  "RRO": {
                    "type": "integer",
                    "example": 1,
                    "description": "Observed in the 2026-11-01 boot HAR. Always 1 in the observed calls."
                  },
                  "agentOwner": {
                    "type": "string",
                    "description": "Logged-in account; the observed value was the master agent."
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "fantasy402Cookie": []
          }
        ],
        "responses": {
          "200": {
            "description": "HTTP 200 observed in the redacted boot HAR (2026-11-01). The response envelope was not promoted to a hashed capture, so no response schema is published."
          }
        },
        "x-evidence": {
          "tier": "B",
          "sources": [
            "docs/evidence/captures/har/manager-boot-pipeline-proven.redacted.har.json",
            "lib/f402_probe.ts"
          ],
          "capturedResponse": false,
          "requiredCapture": "The request is observed in the boot HAR and the call returns 200; only the response envelope keys are missing. Capture one live call and promote it with scripts/apply_captures.ts to upgrade B->A."
        }
      }
    },
    "/cloud/api/Manager/getAuthorizations": {
      "post": {
        "tags": ["Downline Accounting"],
        "summary": "Boot agent permissions (request observed 2026-11-01; no response schema)",
        "description": "manager.js:37628 boot permissions and distribution read. The recorded form body is agentID, agentOwner, operation and RRO; the portal assigns the reply to a.INFO and a.DISTRIBUTION. Neither INFO nor DISTRIBUTION fields are published because no capture record holds the response.",
        "operationId": "postCloudApiManagerGetAuthorizations",
        "requestBody": {
          "required": true,
          "content": {
            "application/x-www-form-urlencoded; charset=UTF-8": {
              "schema": {
                "type": "object",
                "required": ["agentID", "agentOwner", "operation", "RRO"],
                "properties": {
                  "operation": {
                    "type": "string",
                    "const": "getAuthorizations"
                  },
                  "agentID": {
                    "type": "string",
                    "description": "Logged-in account; the observed value was the master agent."
                  },
                  "agentOwner": {
                    "type": "string",
                    "description": "Logged-in account; the observed value was the master agent."
                  },
                  "RRO": {
                    "type": "integer",
                    "example": 1,
                    "description": "Observed in the 2026-11-01 boot HAR. Always 1 in the observed calls."
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "fantasy402Cookie": []
          }
        ],
        "responses": {
          "200": {
            "description": "HTTP 200 observed in the redacted boot HAR (2026-11-01). The response envelope was not promoted to a hashed capture, so no response schema is published."
          }
        },
        "x-evidence": {
          "tier": "B",
          "sources": [
            "docs/evidence/captures/har/manager-boot-pipeline-proven.redacted.har.json",
            "lib/f402_probe.ts"
          ],
          "capturedResponse": false,
          "requiredCapture": "The request is observed in the boot HAR and the call returns 200; only the INFO/DISTRIBUTION envelope keys are missing. Capture one live call and promote it with scripts/apply_captures.ts to upgrade B->A."
        }
      }
    },
    "/cloud/api/Manager/getConfigWebReportsPending": {
      "post": {
        "tags": ["Inferred (Unverified)"],
        "summary": "POST /cloud/api/Manager/getConfigWebReportsPending",
        "description": "UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.",
        "operationId": "postCloudApiManagerGetConfigWebReportsPending",
        "responses": {
          "default": {
            "description": "Unknown — no response was captured, so no status code or body schema is documented."
          }
        },
        "x-evidence": {
          "tier": "C",
          "sources": ["lib/f402_probe.ts"],
          "capturedResponse": false,
          "requiredCapture": "No request or response was captured for this operation. Capture one boot call (the parameter set is in MANAGER_BOOT_OPS) and promote it with scripts/apply_captures.ts."
        }
      }
    },
    "/api/v1/blobs/{key}": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Presigned download URL for one blob",
        "description": "Bearer-auth GET redirects (302) to a presigned S3/R2 GET URL (services/blob_and_live_bets_server.ts). The key is validated before presigning; unknown keys are not probed, and a presign failure is 502. With `?download=1` the handler returns the object body directly via `new Response(S3File)` (200). Surface: surface.blob-live-bets (tier B).",
        "operationId": "getApiV1BlobsKey",
        "parameters": [
          {
            "name": "key",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$"
            },
            "description": "Validated blob key; `..` and leading dots are refused."
          },
          {
            "name": "download",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": ["1"]
            },
            "description": "Stream the object body (200) instead of redirecting."
          }
        ],
        "responses": {
          "200": {
            "description": "Object body streamed from S3File.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "302": {
            "description": "Redirect to a short-lived presigned URL.",
            "headers": {
              "location": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Invalid blob key.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or wrong bearer token.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "502": {
            "description": "Presign failed.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "B",
          "sources": ["services/blob_and_live_bets_server.ts:517-600"],
          "capturedResponse": false,
          "requiredCapture": "No live HTTP capture exists; this row is handler-verified tier B. Capture one live request/response to promote it to tier A."
        }
      },
      "put": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Bounded image upload, transcoded to WebP",
        "description": "Bearer-auth PUT accepts image/jpeg|png|webp|avif|heic up to maxUploadBytes (default 5 MiB), rejects oversized bodies with 413 from both Content-Length and a streaming cap, decodes with Bun.Image under maxPixels (413), resizes inside 1280x1280 and encodes deterministic WebP (Bun.Image.backend = \"bun\"), then stores it. Response carries bytesWritten, bytes, width and height. Surface: surface.blob-live-bets (tier D).",
        "operationId": "putApiV1BlobsKey",
        "parameters": [
          {
            "name": "key",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$"
            },
            "description": "Validated blob key; `..` and leading dots are refused."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "image/png": {
              "schema": {
                "type": "string",
                "format": "binary"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Stored WebP metadata.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "key": {
                      "type": "string"
                    },
                    "bytesWritten": {
                      "type": "integer"
                    },
                    "bytes": {
                      "type": "integer"
                    },
                    "width": {
                      "type": "integer"
                    },
                    "height": {
                      "type": "integer"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid blob key.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or wrong bearer token.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Body or decoded pixel count too large.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "415": {
            "description": "Unsupported image content type.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Image could not be decoded.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "502": {
            "description": "Store failed.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "B",
          "sources": ["services/blob_and_live_bets_server.ts:517-600"],
          "capturedResponse": false,
          "requiredCapture": "No live HTTP capture exists; this row is handler-verified tier B. Capture one live request/response to promote it to tier A."
        }
      },
      "delete": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Delete one stored blob",
        "description": "Bearer-auth DELETE validates the key, returns 404 when the blob is absent, removes the stored object and returns 204; a store failure is 502. Surface: surface.blob-live-bets (tier B).",
        "operationId": "deleteApiV1BlobsKey",
        "parameters": [
          {
            "name": "key",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$"
            },
            "description": "Validated blob key; `..` and leading dots are refused."
          }
        ],
        "responses": {
          "204": {
            "description": "Blob deleted."
          },
          "400": {
            "description": "Invalid blob key.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or wrong bearer token.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Blob not found.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "502": {
            "description": "Delete failed at the store.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "B",
          "sources": ["services/blob_and_live_bets_server.ts:601-619"],
          "capturedResponse": false,
          "requiredCapture": "No live HTTP capture exists; this row is handler-verified tier B. Capture one live request/response to promote it to tier A."
        }
      }
    },
    "/api/v1/ws-tickets": {
      "post": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Short-lived one-time WebSocket ticket",
        "description": "Bearer-auth POST returns {ticket, expiresInSec}. The ticket is HMAC-SHA256 over {exp, nonce}; issued nonces are kept in a pending allowlist capped at 4096 (429 when full), deleted on the first successful upgrade, and replayed/unissued tickets are rejected. Surface: surface.blob-live-bets (tier D).",
        "operationId": "postApiV1WsTickets",
        "responses": {
          "200": {
            "description": "Ticket and TTL.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ticket": {
                      "type": "string"
                    },
                    "expiresInSec": {
                      "type": "integer"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or wrong bearer token.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Active-ticket cap reached.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "B",
          "sources": ["services/blob_and_live_bets_server.ts:432-456"],
          "capturedResponse": false,
          "requiredCapture": "No live HTTP capture exists; this row is handler-verified tier B. Capture one live request/response to promote it to tier A."
        }
      }
    },
    "/api/v1/live-bets": {
      "post": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Publish a live-bets event to subscribers",
        "description": "Bearer-auth POST {channel, event} validates the channel, serializes the event and calls Server.publish; it returns the number of subscribers reached. Publishing is also exposed programmatically as publish(channel, event) on the server factory. Surface: surface.blob-live-bets (tier D).",
        "operationId": "postApiV1LiveBets",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["channel", "event"],
                "properties": {
                  "channel": {
                    "type": "string",
                    "pattern": "^[a-z0-9-]{1,32}$"
                  },
                  "event": {
                    "description": "JSON-serializable event payload."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Subscriber count.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "channel": {
                      "type": "string"
                    },
                    "published": {
                      "type": "integer"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid JSON, channel or body.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or wrong bearer token.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Body too large.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Event is not serializable.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "B",
          "sources": ["services/blob_and_live_bets_server.ts:457-503"],
          "capturedResponse": false,
          "requiredCapture": "No live HTTP capture exists; this row is handler-verified tier B. Capture one live request/response to promote it to tier A."
        }
      },
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Frozen v1 live bets derived from captured Report/Pending rows",
        "description": "Frozen v1 live-bets endpoint (sportsdesk_webview_server.ts#GET /api/v1/live-bets), preserved for existing callers while new integrations migrate to /api/v2/live-bets. Derives the scoreboard payload from real wager rows using lib/live_bets.ts and src/live_bets/resolve.ts, stripping Password/NameFirst/Login by name and keeping amounts in integer cents. Non-loopback peers must present SPORTSDESK_ADMIN_TOKEN (piiRejection). Surface: surface.daemon-live-bets (tier D).",
        "operationId": "getApiV1LiveBets",
        "responses": {
          "200": {
            "description": "Games, agent rollup and the aggregates derived from them.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "games": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "agents": {
                      "type": "object"
                    },
                    "pendingCount": {
                      "type": "integer"
                    },
                    "summary": {
                      "type": "object"
                    },
                    "scoreboard": {
                      "type": "object",
                      "nullable": true
                    },
                    "sports": {
                      "type": "object"
                    },
                    "generatedAt": {
                      "type": "string",
                      "format": "date-time"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts#GET /api/v2/live-bets"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of GET /api/v1/live-bets against a real Report/Pending capture (the route is handler-verified only; no HTTP response was captured)."
        },
        "x-surface-id": "surface.daemon-live-bets",
        "deprecated": true
      }
    },
    "/ws/live-bets": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Live-bets WebSocket upgrade",
        "description": "Upgrade requires a valid unused ticket, via ?ticket= or Sec-WebSocket-Protocol: live-bets.v1, ticket.<token> (the server echoes live-bets.v1). Messages are capped (1009), JSON-validated and limited to PING/SUBSCRIBE/UNSUBSCRIBE with channel regex checks. Surface: surface.blob-live-bets (tier D).",
        "operationId": "getWsLiveBets",
        "parameters": [
          {
            "name": "ticket",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "One-time HMAC ticket; the subprotocol form is preferred for browsers."
          }
        ],
        "responses": {
          "101": {
            "description": "Switching Protocols."
          },
          "401": {
            "description": "Missing or wrong bearer token.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "426": {
            "description": "Upgrade required.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "B",
          "sources": ["services/blob_and_live_bets_server.ts:620-649"],
          "capturedResponse": false,
          "requiredCapture": "No live HTTP capture exists; this row is handler-verified tier B. Capture one live request/response to promote it to tier A."
        }
      }
    },
    "/cloud/api/Manager/getHistory": {
      "post": {
        "tags": ["Settlement History"],
        "summary": "Manager getHistory (wired settlement-history poll; no response capture)",
        "description": "The only upstream Fantasy402 route in this repository with a real fetch client: resolveHistoryPollUrl builds `${SPORTSDESK_PORTAL_HTTP_BASE}/cloud/api/Manager/getHistory` and pollManagerGetHistory POSTs with no request body (lib/fantasy402_settlement_ingest.ts:841-862). The response must be a JSON array or {data: []} or the poll throws (lib/fantasy402_settlement_ingest.ts:863-881). The request contract (agent scope, date window, auth) is therefore unknown, and row field shapes are not captured; tests/fixtures/fantasy402-history-poll.json is a placeholder shape sample. Surface: surface.manager-getHistory (tier D).",
        "operationId": "postCloudApiManagerGetHistory",
        "responses": {
          "200": {
            "description": "JSON array of raw settlement rows, or an object with a data array. Any other shape throws (lib/fantasy402_settlement_ingest.ts:868-881). Row fields are not captured, so only raw/unknown objects are described.",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true,
                        "description": "Raw settlement row; the poll types rows as Record<string, unknown> and no field shapes were captured."
                      }
                    },
                    {
                      "type": "object",
                      "required": ["data"],
                      "properties": {
                        "data": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "additionalProperties": true,
                            "description": "Raw settlement row; field shapes not captured."
                          }
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "default": {
            "description": "Non-2xx status is not captured; the poll throws on !res.ok (lib/fantasy402_settlement_ingest.ts:863-865)."
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "lib/fantasy402_settlement_ingest.ts:841-851",
            "lib/fantasy402_wager_universe_scope.ts:22-31",
            "fixture:tests/fixtures/fantasy402-history-poll.json:2-24"
          ],
          "capturedResponse": false,
          "requiredCapture": "Capture one getHistory request/response (redacted) to record the upstream request contract (body/agent scope/date window/auth) and a real response body; this repo only proves the URL, the bodyless POST and the array-or-{data:[]} acceptance."
        },
        "x-surface-id": "surface.manager-getHistory"
      }
    },
    "/miniapp": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Telegram Mini App dashboard (GET /miniapp)",
        "description": "Serves telegram-miniapp-dashboard.html as text/html (services/sportsdesk_webview_server.ts#/miniapp) with Telegram frame-ancestors CSP and no X-Frame-Options (services/sportsdesk_webview_server.ts#/miniapp). GET /miniapp/ is an alias. Surface: surface.daemon-miniapp (tier D).",
        "operationId": "getMiniapp",
        "responses": {
          "200": {
            "description": "Mini App dashboard HTML with the daemon CORS/CSP headers.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Static HTML document served from disk by the daemon."
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts:1812-1819",
            "services/sportsdesk_webview_server.ts:847-848"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of the served /miniapp HTML (the route is handler-verified only; no HTTP response was captured)."
        },
        "x-surface-id": "surface.daemon-miniapp"
      }
    },
    "/dashboard": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Operator dashboard (GET /dashboard)",
        "description": "Serves customer-churn-simulation-dashboard.html as text/html (services/sportsdesk_webview_server.ts#/dashboard). The same handler also answers GET /; the root path is not modelled as an OpenAPI path because the ledger has no dedicated surface row for it. Surface: surface.daemon-dashboard (tier D).",
        "operationId": "getDashboard",
        "responses": {
          "200": {
            "description": "Operator dashboard HTML with the daemon CORS/CSP headers.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Static HTML document served from disk by the daemon."
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": ["services/sportsdesk_webview_server.ts:1792-1799"],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of the served /dashboard HTML (the route is handler-verified only; no HTTP response was captured)."
        },
        "x-surface-id": "surface.daemon-dashboard"
      }
    },
    "/api/live-bets": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Deprecated alias redirecting (308) to /api/v1/live-bets",
        "description": "Deprecated alias for /api/v1/live-bets (sportsdesk_webview_server.ts#GET /api/live-bets). Guards non-loopback peers with piiRejection, then answers 308 Permanent Redirect to /api/v1/live-bets preserving query parameters and setting X-Deprecation: /api/v2/live-bets; sunset=2027-05-10. Surface: surface.daemon-live-bets (tier D).",
        "operationId": "getApiLiveBets",
        "responses": {
          "308": {
            "description": "Permanent redirect to /api/v1/live-bets with X-Deprecation header.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts#GET /api/v2/live-bets"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of GET /api/live-bets redirect response (handler-verified only; no HTTP response was captured)."
        },
        "x-surface-id": "surface.daemon-live-bets",
        "deprecated": true
      }
    },
    "/api/v2/live-bets": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Live bets v2 with explicit source, fallback, provenance and warnings",
        "description": "Resolves live-bets snapshots through resolveLiveBets (src/live_bets/resolve.ts, sportsdesk_webview_server.ts#GET /api/v2/live-bets) with explicit source (db | file | fixture | none; auto is rejected with 400) and fallback (strict | sample). Never returns a null dataSource or silently swallows missing files: strict returns dataSource: none with warnings, and sample records fallbackUsed and provenance.path/hash for whichever file answered. Non-loopback peers must present SPORTSDESK_ADMIN_TOKEN (piiRejection). Surface: surface.daemon-live-bets (tier D).",
        "operationId": "getApiV2LiveBets",
        "responses": {
          "200": {
            "description": "Resolved v2 live-bets payload with provenance and warnings.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "apiVersion": {
                      "type": "string",
                      "enum": ["2"]
                    },
                    "dataSource": {
                      "type": "string",
                      "enum": ["db", "file", "fixture", "none"]
                    },
                    "fallbackUsed": {
                      "type": "boolean"
                    },
                    "provenance": {
                      "type": "object",
                      "properties": {
                        "path": {
                          "type": "string",
                          "nullable": true
                        },
                        "hash": {
                          "type": "string",
                          "nullable": true
                        },
                        "generatedAt": {
                          "type": "string",
                          "format": "date-time"
                        }
                      }
                    },
                    "games": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "warnings": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "agents": {
                      "type": "object"
                    },
                    "pendingCount": {
                      "type": "integer"
                    },
                    "summary": {
                      "type": "object"
                    },
                    "scoreboard": {
                      "type": "object",
                      "nullable": true
                    },
                    "sports": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts#GET /api/v2/live-bets"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of GET /api/v2/live-bets against a real Report/Pending capture (the route is handler-verified only; no HTTP response was captured)."
        },
        "x-surface-id": "surface.daemon-live-bets",
        "parameters": [
          {
            "name": "source",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": ["db", "file", "fixture", "none"]
            }
          },
          {
            "name": "fallback",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": ["strict", "sample"]
            }
          },
          {
            "name": "path",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/api/live-bets/summary": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Aggregates only, without the game list",
        "description": "Same aggregates as GET /api/live-bets, computed from the same rows in the same request (sportsdesk_webview_server.ts#GET /api/live-bets/summary), so the two responses cannot disagree. Totals are derived, never stored. The byAgent buckets are keyed by agent login, so the route carries the same PII guard as GET /api/live-bets and answers Cache-Control: private with Vary: Authorization: a shared cache must not replay a body the guard released to one peer. Surface: surface.daemon-live-bets (tier D).",
        "operationId": "getApiLiveBetsSummary",
        "responses": {
          "200": {
            "description": "Derived totals with their data source.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "summary": {
                      "type": "object"
                    },
                    "generatedAt": {
                      "type": "string",
                      "format": "date-time"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts#GET /api/v2/live-bets"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of GET /api/live-bets/summary (handler-verified only; no HTTP response was captured)."
        },
        "x-surface-id": "surface.daemon-live-bets"
      }
    },
    "/api/agent-tree": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Agent hierarchy joined with the wager rollup",
        "description": "Serves data/agent-tree.json plus per-agent exposure (sportsdesk_webview_server.ts#GET /api/agent-tree). The tree is built by scripts/build_agent_tree.ts from the portal's own baseHeriarchy parent pointers; keys are canonical agentLoginKey values, and keys owned by more than one AgentID are flagged rather than levelled. Non-loopback peers must present SPORTSDESK_ADMIN_TOKEN; proxied peers need it too unless SPORTSDESK_TRUST_PROXY=1. `?view=hierarchy` returns the same forest folded into children arrays with per-node rollups (`rollup.agents` = transitive agents below, `rollup.depth` = longest chain below, `depth` = chain depth from the root) and the payload's defects (missing parents, cycles, collision keys) — `lib/hierarchy_view.ts`. Depth comes from the parent edges and not from the `l` field: on the committed tree 1,951 of 2,272 edges increment by 1, 208 by 2 and 110 run 12→12 where `l` saturates, so `l` stays in the payload as `level` and disagreement accumulates to 2,255 of 2,276 nodes. Surface: surface.daemon-agent-tree (tier D).",
        "operationId": "getApiAgentTree",
        "responses": {
          "200": {
            "description": "Parent-keyed agent forest with per-agent wager counts.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "schemaVersion": {
                      "type": "integer"
                    },
                    "source": {
                      "type": "string"
                    },
                    "agentCount": {
                      "type": "integer"
                    },
                    "roots": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "collisions": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "nodes": {
                      "type": "object"
                    },
                    "counts": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "No tree built; run bun run build:agent-tree.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts#GET /api/agent-tree"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of GET /api/agent-tree, with and without ?view=hierarchy (handler-verified only; no HTTP response was captured)."
        },
        "x-surface-id": "surface.daemon-agent-tree",
        "parameters": [
          {
            "name": "view",
            "in": "query",
            "required": false,
            "description": "`hierarchy` folds the flat forest into children arrays with rollups and payload defects. Omit for the flat map plus per-agent wager counts.",
            "schema": {
              "type": "string",
              "enum": ["hierarchy"]
            }
          }
        ]
      }
    },
    "/api/scoreboard": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Transcribed portal scoreboard (games, scores, status)",
        "description": "Serves data/scoreboard.json with a status summary (sportsdesk_webview_server.ts#GET /api/scoreboard). The games are transcribed from the manager page, not captured from an API, so the payload carries source and observedAt. Surface: surface.daemon-scoreboard (tier D).",
        "operationId": "getApiScoreboard",
        "responses": {
          "200": {
            "description": "Scoreboard rows with status counts.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "schemaVersion": {
                      "type": "integer"
                    },
                    "source": {
                      "type": "string"
                    },
                    "observedAt": {
                      "type": "string",
                      "nullable": true
                    },
                    "notes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "games": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "summary": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "No scoreboard file present.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": ["services/sportsdesk_webview_server.ts:3193-3205"],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of GET /api/scoreboard (handler-verified only; no HTTP response was captured)."
        },
        "x-surface-id": "surface.daemon-scoreboard"
      }
    },
    "/api/sports": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Portal sport taxonomy with counts per category",
        "description": "Returns the 18 portal categories plus counts for the loaded wagers and the scoreboard (sportsdesk_webview_server.ts#GET /api/sports). All Sports is the absence of a filter and LIVE is a state, so neither is a category. Surface: surface.daemon-sports-taxonomy (tier D).",
        "operationId": "getApiSports",
        "responses": {
          "200": {
            "description": "Taxonomy and the counts observed per category.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "liveFilter": {
                      "type": "string"
                    },
                    "all": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "wagers": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "scoreboard": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": ["services/sportsdesk_webview_server.ts#GET /api/sports"],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of GET /api/sports (handler-verified only; no HTTP response was captured)."
        },
        "x-surface-id": "surface.daemon-sports-taxonomy"
      }
    },
    "/api/game-admin": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Exposure per fixture with a Straight/Parlay/Teaser split",
        "description": "The portal manual's Game Admin report (v1.0.280, F.A.Q. #4) reduced to exposure per fixture and position (sportsdesk_webview_server.ts#GET /api/game-admin). preGame is computed from gameDateTime against the request clock and is a fact about the fixture, not a claim about the operator's delete permission. Surface: surface.daemon-game-admin (tier D).",
        "operationId": "getApiGameAdmin",
        "responses": {
          "200": {
            "description": "Fixtures ordered by exposure, with positions.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "source": {
                      "type": "string"
                    },
                    "games": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "generatedAt": {
                      "type": "string",
                      "format": "date-time"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts#GET /api/game-admin"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of GET /api/game-admin (handler-verified only; no HTTP response was captured)."
        },
        "x-surface-id": "surface.daemon-game-admin"
      }
    },
    "/api/analysis": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Analysis report, or the reason it is not captured",
        "description": "Validates the portal's filter vocabulary (services/sportsdesk_webview_server.ts#GET /api/analysis) and answers 200 only when a transcribed report matches the selection; otherwise 501 with the required capture. A 200 carries the rows, the published totals, a recomputed copy and a discrepancies array, so a transcription slip is visible rather than served as fact. Surface: surface.daemon-analysis (tier D).",
        "operationId": "getApiAnalysis",
        "responses": {
          "200": {
            "description": "A transcribed analysis report.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "available": {
                      "type": "boolean"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "totals": {
                      "type": "object"
                    },
                    "recomputed": {
                      "type": "object"
                    },
                    "discrepancies": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    }
                  }
                }
              }
            }
          },
          "501": {
            "description": "No transcribed report matches this selection.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "requiredCapture": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts#GET /api/analysis"
          ],
          "capturedResponse": false,
          "requiredCapture": "Only the response of POST /cloud/api/Manager/getAgentPerformance is missing. The request is observed (2026-11-01, type=CP and CPS) and lib/f402_agent_performance_request.ts reproduces it byte for byte; no response body has ever been seen, so no column set is documented. Today a single Customer Performance result (Baseball, agent BILLY666, 2026-11-01) is transcribed from an operator paste."
        },
        "x-surface-id": "surface.daemon-analysis"
      }
    },
    "/api/analysis/filters": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Analysis filter vocabulary transcribed from report.js",
        "description": "Returns the report kinds (CP/CPS/CPV/G), the fourteen activity codes, the two group modes and the four week windows, with their provenance and the required capture (services/sportsdesk_webview_server.ts#GET /api/analysis/filters). Surface: surface.daemon-analysis (tier D).",
        "operationId": "getApiAnalysisFilters",
        "responses": {
          "200": {
            "description": "Filter vocabulary with provenance.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "captured": {
                      "type": "boolean"
                    },
                    "reports": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "activities": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "groups": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "weeks": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts#GET /api/analysis"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of GET /api/analysis/filters (handler-verified only)."
        },
        "x-surface-id": "surface.daemon-analysis"
      }
    },
    "/api/analysis/reports": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Transcribed analysis reports and their recorded context",
        "description": "Lists each stored result with the selection it was run under, so a client can select one instead of reconstructing the filters (services/sportsdesk_webview_server.ts#GET /api/analysis/reports). The recorded context contains the agent login the report was run for, so this index is customer-identifying and carries the same guard as GET /api/analysis: a non-loopback peer must present SPORTSDESK_ADMIN_TOKEN (piiRejection), and a unix-socket listener requires it unless SPORTSDESK_TRUST_PROXY=1. Surface: surface.daemon-analysis (tier D).",
        "operationId": "getApiAnalysisReports",
        "responses": {
          "200": {
            "description": "Stored reports with context.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "count": {
                      "type": "integer"
                    },
                    "reports": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or wrong admin token.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "SPORTSDESK_ADMIN_TOKEN is not set on the server.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts#GET /api/analysis"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of GET /api/analysis/reports (handler-verified only)."
        },
        "x-surface-id": "surface.daemon-analysis"
      }
    },
    "/api/customer/profile": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Comprehensive customer profiling and behavioral forensics",
        "description": "Generates a multi-dimensional customer behavioral profile including stake distribution, Gini inequality, market specialization, syndicate cluster analysis, reverse DNS classification, portfolio risk forensics, correlated parlay exposure, and composite sharpness tier. Guarded by PII rejection: non-loopback clients must present SPORTSDESK_ADMIN_TOKEN. Surface: surface.daemon-analysis (tier D).",
        "operationId": "getApiCustomerProfile",
        "responses": {
          "200": {
            "description": "Comprehensive customer profile envelope.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "profile": {
                      "type": "object"
                    },
                    "generatedAt": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing required customer ID parameter.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or wrong admin token (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Customer record not found.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts#GET /api/analysis"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of GET /api/customer/profile (handler-verified only)."
        },
        "x-surface-id": "surface.daemon-analysis",
        "parameters": [
          {
            "name": "id",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Customer login ID (e.g. SYNTH_SYN_01 or RF2003)"
          }
        ]
      }
    },
    "/api/customer/rating": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Customer rating with Bayesian skill and Kelly sizing metrics",
        "description": "Evaluates a bettor's sharpness using Bayesian win rate skill inference, fractional Kelly stake optimization, CLV t-statistic significance, component scoring, and desk action directives. Guarded by PII rejection. Surface: surface.daemon-analysis (tier D).",
        "operationId": "getApiCustomerRating",
        "responses": {
          "200": {
            "description": "Customer rating envelope.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "rating": {
                      "type": "object"
                    },
                    "generatedAt": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing required customer ID parameter.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or wrong admin token (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Customer record not found.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts#GET /api/analysis"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of GET /api/customer/rating (handler-verified only)."
        },
        "x-surface-id": "surface.daemon-analysis",
        "parameters": [
          {
            "name": "id",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Customer login ID"
          }
        ]
      }
    },
    "/api/agents/search": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Agent lookup over the committed hierarchy",
        "description": "Case-insensitive prefix-first search over data/agent-tree.json (services/sportsdesk_webview_server.ts#GET /api/agents/search). Requires q of at least two characters and clamps limit to 100. Loopback-gated, because agent names are identity data. Surface: surface.daemon-agent-search (tier D).",
        "operationId": "getApiAgentsSearch",
        "responses": {
          "200": {
            "description": "Matching agents with their level.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "query": {
                      "type": "string"
                    },
                    "count": {
                      "type": "integer"
                    },
                    "agents": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Query shorter than two characters.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts#GET /api/agents/search"
          ],
          "capturedResponse": false,
          "requiredCapture": "Not a capture gap: the tree is committed and the handler is the contract."
        },
        "x-surface-id": "surface.daemon-agent-search"
      }
    },
    "/api/game-admin/board": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Game Admin board: lines with the money on each side",
        "description": "Serves the transcribed Admin module: spread, moneyline, total and team-total sides with exposure (services/sportsdesk_webview_server.ts#GET /api/game-admin). Supports the portal's window selector (48 yesterday, 24 today, -1 current board). Abbreviated amounts carry amountExact null and are excluded from sums. Surface: surface.daemon-game-admin-board (tier D).",
        "operationId": "getApiGameAdminBoard",
        "responses": {
          "200": {
            "description": "Board games, their sides and the window summary.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "window": {
                      "type": "string"
                    },
                    "games": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "summary": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Unknown window code.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts#GET /api/game-admin"
          ],
          "capturedResponse": false,
          "requiredCapture": "A Game Admin API capture would replace the transcription; none exists, so source and observedAt travel with the payload."
        },
        "x-surface-id": "surface.daemon-game-admin-board"
      }
    },
    "/api/sports/catalog": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Sub-sports and period menus with their types",
        "description": "19 sports, 230 sub-sports and 42 period entries from the committed catalog fixture (services/sportsdesk_webview_server.ts#/api/sports/catalog). Period numbers are sport-specific, so periodTypes reports every name a number carries and flags the ambiguous ones; sub-sport codes shared by several sports are marked. Surface: surface.daemon-sport-catalog (tier D).",
        "operationId": "getApiSportsCatalog",
        "responses": {
          "200": {
            "description": "Catalog with derived indexes.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "summary": {
                      "type": "object"
                    },
                    "periodTypes": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "subSports": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "sports": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Unknown sport or sub-sport.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": ["services/sportsdesk_webview_server.ts:2954-3028"],
          "capturedResponse": false,
          "requiredCapture": "Not a capture gap: the catalog fixture is the captured artifact."
        },
        "x-surface-id": "surface.daemon-sport-catalog"
      }
    },
    "/api/contests": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Contest / futures list from the sports nav",
        "description": "Every contest the nav links, keyed by contestNum with sport, market and subject parsed out of the padded type string (services/sportsdesk_webview_server.ts#GET /api/contests). The list is extracted from saved markup by scripts/extract_contests.ts. Surface: surface.daemon-contests (tier D).",
        "operationId": "getApiContests",
        "responses": {
          "200": {
            "description": "Contests with their group counts.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "count": {
                      "type": "integer"
                    },
                    "entries": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "No contest list extracted.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts#GET /api/contests"
          ],
          "capturedResponse": false,
          "requiredCapture": "A contest API capture would replace the markup extraction; none exists."
        },
        "x-surface-id": "surface.daemon-contests"
      }
    },
    "/api/live-wagers": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Live wager ticker list with parsed legs",
        "description": "The {LIST: [...]} bet-ticker feed, which differs from Report/Pending: WagerNumber is the ticket id and ShortDesc carries one line per leg (services/sportsdesk_webview_server.ts#/api/live-wagers). Both ShortDesc grammars are parsed and the compact one is flagged; VolumeAmount differing from AmountWagered is reported, not reconciled. The response carries the file's own provenance — source, observedAt and captureNote — so a partial list reads as partial instead of as the whole ticker. Candidates are data/bet-ticker.json (a full Manager/getBetTicker capture written by `bun run capture:bet-ticker`, gitignored) and the local gitignored data/live-wagers.json artifact; a file is valid only if it parses as JSON and is a wager list ({LIST: [...]} or a bare array), and the valid one observed later wins: a provenance.observedAt that parses and is not in the future outranks any file mtime (the file's mtime changes on checkout), mtime only orders two undated files, and a tie goes to bet-ticker — services/sportsdesk_webview_server.ts#/api/live-wagers, shared with /api/kpis. `freshness` ({asOf, asOfFrom, stale}, stale after 3600 s) dates the chosen file — no ageSeconds, because the body is cached by version and the page derives the age from asOf, and `skipped` lists each present file that was not served with its reason (invalid JSON, no LIST array, older than the other); the 404 carries `skipped` too, so a malformed capture is reported rather than answered with a 500 or zero wagers. Loopback-gated. Surface: surface.daemon-live-wagers (tier D).",
        "operationId": "getApiLiveWagers",
        "responses": {
          "200": {
            "description": "Wagers with aggregates and their provenance.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "summary": {
                      "type": "object"
                    },
                    "all": {
                      "type": "object"
                    },
                    "provenance": {
                      "type": "object"
                    },
                    "freshness": {
                      "type": "object"
                    },
                    "skipped": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "wagers": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "No valid live wager list.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    },
                    "hint": {
                      "type": "string"
                    },
                    "skipped": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts#GET /api/live-wagers"
          ],
          "capturedResponse": false,
          "requiredCapture": "An HTTP capture of GET /api/live-wagers serving a `capture:bet-ticker` artifact. No such run has been recorded; a local data/live-wagers.json artifact may hold a partial clipboard paste, and its `partial` flag and captureNote must say so."
        },
        "x-surface-id": "surface.daemon-live-wagers"
      }
    },
    "/api/status": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Daemon status and process telemetry (GET /api/status, GET /status.json)",
        "description": "Answers {ok, status, checks, health, telegram, timestamp} from the running process instead of fetching itself over the loopback (services/sportsdesk_webview_server.ts#/api/status); a self-fetch had no port at all under a unix socket. `ok` and `status` are derived from `checks`, so the degraded branch is reachable, and `cpuUsageSinceStartMicros` is cumulative CPU time rather than utilisation. HEAD is answered like GET. Public by the table's `operational` classification — it carries uptime, memory, pid and bind address, not customer data. Surface: surface.daemon-dashboard (tier D).",
        "operationId": "getApiStatus",
        "responses": {
          "200": {
            "description": "Liveness, per-check results and process telemetry.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean"
                    },
                    "status": {
                      "type": "string",
                      "enum": ["serving", "degraded"]
                    },
                    "checks": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "string",
                        "enum": ["ok", "error"]
                      }
                    },
                    "health": {
                      "type": "object"
                    },
                    "telegram": {
                      "type": "object",
                      "nullable": true
                    },
                    "timestamp": {
                      "type": "string",
                      "format": "date-time"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": ["services/sportsdesk_webview_server.ts:1792-1799"],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of GET /api/status (the route is handler-verified only; no HTTP response was captured)."
        },
        "x-surface-id": "surface.daemon-dashboard"
      }
    },
    "/api/kpis": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Dashboard headline KPIs (GET /api/kpis)",
        "description": "Derives the dashboard's KPI strip from the artifacts the daemon serves (lib/desk_kpis.ts#deriveDeskKpis): agent counts from data/agent-tree.json, open wagers from data/live-bets.json, the ticker subset from data/live-wagers.json, and the customer book from data/customer-profiles.json. Each block is null when its file is absent and carries {source, basis, asOf, asOfFrom, ageSeconds, stale, partial}; `basis: fixture` marks demo data (the customer book is built from enriched_customers_full.json). Money is integer cents. Public by the table's `aggregate` classification — counts and sums only, no login, customer id or agent key. Surface: surface.daemon-dashboard (tier D).",
        "operationId": "getApiKpis",
        "responses": {
          "200": {
            "description": "Derived KPI blocks with per-block provenance and staleness.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "kpis": {
                      "type": "object",
                      "properties": {
                        "agents": {
                          "type": "object",
                          "nullable": true
                        },
                        "pending": {
                          "type": "object",
                          "nullable": true
                        },
                        "ticker": {
                          "type": "object",
                          "nullable": true
                        },
                        "customerBook": {
                          "type": "object",
                          "nullable": true
                        }
                      }
                    },
                    "generatedAt": {
                      "type": "string",
                      "format": "date-time"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": ["services/sportsdesk_webview_server.ts:1792-1799"],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of GET /api/kpis (the route is handler-verified only; no HTTP response was captured)."
        },
        "x-surface-id": "surface.daemon-dashboard"
      }
    },
    "/api/dns/telemetry": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Bun native DNS resolver cache telemetry and core host metrics",
        "description": "Operational telemetry reporting Bun's native DNS subsystem statistics: completed cache hits, inflight hits, misses, cache table size, hit rate percentage, and configured TTL settings. Surface: surface.daemon-dashboard (tier D).",
        "operationId": "getApiDnsTelemetry",
        "responses": {
          "200": {
            "description": "DNS cache telemetry envelope.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "telemetry": {
                      "type": "object"
                    },
                    "coreHosts": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "generatedAt": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": ["services/sportsdesk_webview_server.ts:1792-1799"],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of GET /api/dns/telemetry (handler-verified only)."
        },
        "x-surface-id": "surface.daemon-dashboard"
      }
    },
    "/api/parse-formdata": {
      "post": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Form-data parse probe (POST /api/parse-formdata)",
        "description": "Echoes the fields of one multipart or urlencoded body as {name: string | string[]} (services/sportsdesk_webview_server.ts#/api/parse-formdata). Reads through `req.formData()`, which on 1.4.4 succeeds where `new Blob([await req.arrayBuffer()]).formData()` rejected Bun's own encoding; the body is bounded by the daemon's 1 MiB maxRequestBodySize. Public, and the reason the cap exists. Surface: surface.daemon-dashboard (tier D).",
        "operationId": "postApiParseFormdata",
        "responses": {
          "200": {
            "description": "The submitted fields; a repeated name becomes an array of strings.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": {
                    "oneOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "The body is not parseable as form data.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "The body exceeded the daemon's 1 MiB maxRequestBodySize. Bun refuses it before the handler runs, so the body is empty (measured on 1.4.4: status 413, no content-type) rather than the daemon's JSON error shape.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": ["services/sportsdesk_webview_server.ts:1792-1799"],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of a POST /api/parse-formdata round trip (multipart and urlencoded)."
        },
        "x-surface-id": "surface.daemon-dashboard"
      }
    },
    "/api/parse-xml": {
      "post": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "XML parse probe (POST /api/parse-xml)",
        "description": "Parses one XML body with Bun.XML.parse and returns the compact tree (services/sportsdesk_webview_server.ts#/api/parse-xml). Body bounded by the daemon's 1 MiB maxRequestBodySize. Public.",
        "operationId": "postApiParseXml",
        "responses": {
          "200": {
            "description": "The parsed XML as a compact object tree.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "The body is not parseable as XML.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": ["services/sportsdesk_webview_server.ts:1792-1799"],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of a POST /api/parse-xml round trip (well-formed XML)."
        },
        "x-surface-id": "surface.daemon-dashboard"
      }
    },
    "/api/parse-customer-profile": {
      "post": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Customer profile XML parse (POST /api/parse-customer-profile)",
        "description": "Parses one customer-profile XML document via parseCustomerProfileXml (lib/customer_profile.ts) and returns the compact tree. Body bounded by the daemon's 1 MiB maxRequestBodySize. Public.",
        "operationId": "postApiParseCustomerProfile",
        "responses": {
          "200": {
            "description": "The parsed profile as a compact object tree.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "The body is not parseable as XML.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": ["services/sportsdesk_webview_server.ts:1792-1799"],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of a POST /api/parse-customer-profile round trip."
        },
        "x-surface-id": "surface.daemon-dashboard"
      }
    },
    "/api/parse-bet-ticker": {
      "post": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Bet-ticker XML parse (POST /api/parse-bet-ticker)",
        "description": "Parses one bet-ticker XML feed via parseBetTickerXml (lib/live_wagers.ts) and returns the compact tree. Body bounded by the daemon's 1 MiB maxRequestBodySize. Public.",
        "operationId": "postApiParseBetTicker",
        "responses": {
          "200": {
            "description": "The parsed feed as a compact object tree.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "The body is not parseable as XML.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": ["services/sportsdesk_webview_server.ts:1792-1799"],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of a POST /api/parse-bet-ticker round trip."
        },
        "x-surface-id": "surface.daemon-dashboard"
      }
    },
    "/api/parse-customer-performance": {
      "post": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Customer performance XML parse (POST /api/parse-customer-performance)",
        "description": "Parses one customer-performance XML document via parseCustomerPerformanceXml and returns the compact tree. Body bounded by the daemon's 1 MiB maxRequestBodySize. Public.",
        "operationId": "postApiParseCustomerPerformance",
        "responses": {
          "200": {
            "description": "The parsed document as a compact object tree.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "The body is not parseable as XML.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": ["services/sportsdesk_webview_server.ts:1792-1799"],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of a POST /api/parse-customer-performance round trip."
        },
        "x-surface-id": "surface.daemon-dashboard"
      }
    },
    "/api/parse-transactions": {
      "post": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Transactions XML parse (POST /api/parse-transactions)",
        "description": "Parses one transactions XML document via parseTransactionsXml and returns the compact tree. Body bounded by the daemon's 1 MiB maxRequestBodySize. Public.",
        "operationId": "postApiParseTransactions",
        "responses": {
          "200": {
            "description": "The parsed document as a compact object tree.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "The body is not parseable as XML.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": ["services/sportsdesk_webview_server.ts:1792-1799"],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of a POST /api/parse-transactions round trip."
        },
        "x-surface-id": "surface.daemon-dashboard"
      }
    },
    "/api/parse-ajax-xml": {
      "post": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "AJAX XML parse (POST /api/parse-ajax-xml)",
        "description": "Parses one AJAX-delivered XML response via parseAjaxXml and returns the compact tree. Body bounded by the daemon's 1 MiB maxRequestBodySize. Public.",
        "operationId": "postApiParseAjaxXml",
        "responses": {
          "200": {
            "description": "The parsed document as a compact object tree.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "The body is not parseable as XML.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": ["services/sportsdesk_webview_server.ts:1792-1799"],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of a POST /api/parse-ajax-xml round trip."
        },
        "x-surface-id": "surface.daemon-dashboard"
      }
    },
    "/api/parse-fantasy402-ajax": {
      "post": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Fantasy402 AJAX XML parse (POST /api/parse-fantasy402-ajax)",
        "description": "Parses one Fantasy402 AJAX XML response via parseFantasy402AjaxXml and returns the compact tree. Body bounded by the daemon's 1 MiB maxRequestBodySize. Public.",
        "operationId": "postApiParseFantasy402Ajax",
        "responses": {
          "200": {
            "description": "The parsed document as a compact object tree.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "The body is not parseable as XML.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": ["services/sportsdesk_webview_server.ts:1792-1799"],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of a POST /api/parse-fantasy402-ajax round trip."
        },
        "x-surface-id": "surface.daemon-dashboard"
      }
    },
    "/api/parse-toml": {
      "post": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "TOML parse (POST /api/parse-toml)",
        "description": "Parses one TOML document via parseToml and returns the result. Body bounded by the daemon's 1 MiB maxRequestBodySize. Public.",
        "operationId": "postApiParseToml",
        "responses": {
          "200": {
            "description": "The parsed document.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "The body is not parseable as TOML.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": ["services/sportsdesk_webview_server.ts:1792-1799"],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of a POST /api/parse-toml round trip."
        },
        "x-surface-id": "surface.daemon-dashboard"
      }
    },
    "/api/logo/{name}": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Team-logo proxy (GET /api/logo/{name})",
        "description": "Fetches https://cdn.fastassets.io/images/team-logos/{name} and returns the image bytes with an immutable day-long cache (services/sportsdesk_webview_server.ts#/api/logo/{name}). Names are validated by rejecting separators, control characters and `..` rather than by allowlisting the characters the feed happens to use, so a traversal never reaches the upstream URL; a malformed percent-escape is 400, not the 500 it used to be. Public: it returns image bytes for a fixed host and carries no customer data; the response content type mirrors the upstream's (png, jpeg, gif, webp or svg), and the 200 schema below is the common case. Surface: surface.daemon-logo-proxy (tier D).",
        "operationId": "getApiLogoName",
        "responses": {
          "200": {
            "description": "The upstream image bytes, cached for one day.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "image/png": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Missing, malformed or disallowed name — including a broken percent-escape.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "502": {
            "description": "The upstream answered but not with an image.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": ["services/sportsdesk_webview_server.ts:1591-1687"],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of one logo fetch, including a 404 from the CDN, to record the upstream status passthrough."
        },
        "x-surface-id": "surface.daemon-logo-proxy",
        "parameters": [
          {
            "name": "name",
            "in": "path",
            "required": true,
            "description": "Logo file name from the wager feed, e.g. `Arsenal FC.png`; must end in .png/.jpg/.jpeg/.gif/.webp/.svg and contain no separator, control character or `..`.",
            "schema": {
              "type": "string"
            },
            "example": "Arsenal FC.png"
          }
        ]
      }
    },
    "/api/f402/get-pending": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Retired Pending endpoint (410 tombstone)",
        "description": "Answers 410 with a pointer to /api/live-bets (services/sportsdesk_webview_server.ts#/api/f402/get-pending). It used to return the same dataset in a different shape; the tombstone makes an old client fail loudly instead of silently reading a fixture that looks live. Surface: surface.daemon-live-bets (tier D).",
        "operationId": "getApiF402GetPending",
        "responses": {
          "410": {
            "description": "The endpoint is gone; the body names its replacements.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts#GET /api/v2/live-bets"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of the 410 body (handler-verified only)."
        },
        "x-surface-id": "surface.daemon-live-bets"
      }
    },
    "/api/graph-feed": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Graph live feed (GET /api/graph-feed, /graph-live-feed.json)",
        "description": "Serves docs/graph-live-feed.json — the same dataset docs/graph.html embeds — with no-store caching (services/sportsdesk_webview_server.ts#/api/graph-feed). It carries agent logins, so it uses the same `pii` guard as the page. Surface: surface.daemon-graph-data-plane (tier D).",
        "operationId": "getApiGraphFeed",
        "responses": {
          "200": {
            "description": "The graph feed document as stored in docs/graph-live-feed.json.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "401": {
            "description": "Missing or wrong admin token (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts:1914-2592",
            "services/sportsdesk_webview_server.ts#GET /agent-graph.webp"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of GET /api/graph-feed (the artifact is committed; no HTTP response was captured)."
        },
        "x-surface-id": "surface.daemon-graph-data-plane"
      }
    },
    "/api/graph/summary": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Derived dashboard summary (GET /api/graph/summary)",
        "description": "Derives every metric docs/graph.html renders — feed counts, repo routes/citations/tests/typecheck/docs/head, bridge values and live process status — from the checkout's own artifacts (lib/dashboard_metrics.ts, services/sportsdesk_webview_server.ts#/api/graph/summary). Each section carries source/asOf/ageSeconds/stale, and an unmeasured metric is `not_measured` with the command that would measure it; it never reports a fabricated zero. It reads captures and the route catalog, so it uses the graph plane's `pii` guard. Surface: surface.daemon-graph-data-plane (tier D).",
        "operationId": "getApiGraphSummary",
        "responses": {
          "200": {
            "description": "Summary envelope: schemaVersion 1 with feed, repo, bridges and status blocks.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "success",
                    "schemaVersion",
                    "generatedAt",
                    "feed",
                    "repo",
                    "bridges",
                    "status"
                  ],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": true
                    },
                    "schemaVersion": {
                      "type": "integer",
                      "const": 1
                    },
                    "generatedAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "feed": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "repo": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "bridges": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "status": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or wrong admin token (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts:1914-2592",
            "services/sportsdesk_webview_server.ts#GET /agent-graph.webp"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of GET /api/graph/summary (handler-verified only; no HTTP response was captured)."
        },
        "x-surface-id": "surface.daemon-graph-data-plane"
      }
    },
    "/api/graph/stream": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Dashboard summary stream (GET /api/graph/stream, SSE)",
        "description": "Server-sent events: the first `event: summary` frame carries the /api/graph/summary body; every 5s a stat fingerprint (feed, junit, census/weblog/live-bets, route table) is re-read and a fresh summary frame is emitted only when it changed, and every 5s a `: heartbeat <epochMs>` comment is sent — 5s because Bun's default idleTimeout is 10s, so a 15s beat would leave the server free to close between beats (services/sportsdesk_webview_server.ts#/api/graph/stream). Timers are cleared on client abort. It streams the guarded summary, so it uses the same `pii` guard. Surface: surface.daemon-graph-data-plane (tier D).",
        "operationId": "getApiGraphStream",
        "responses": {
          "200": {
            "description": "SSE stream: `event: summary` frames and `: heartbeat` comments, blank-line terminated.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "text/event-stream": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "description": "Missing or wrong admin token (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts:1914-2592",
            "services/sportsdesk_webview_server.ts#GET /agent-graph.webp"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of one SSE connection, including the initial summary frame and a heartbeat (handler-verified only; no streaming response was captured)."
        },
        "x-surface-id": "surface.daemon-graph-data-plane"
      }
    },
    "/api/bridge3c/status": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "GSLive Bridge 3c gap-halt boundary and telemetry status",
        "description": "Reports the Class D GSLive gap halt boundary state, read-only enforcement contract, AJAX endpoint target, and recent bridge rollup telemetry cycle. Surface: surface.daemon-graph-data-plane (tier D).",
        "operationId": "getApiBridge3cStatus",
        "responses": {
          "200": {
            "description": "Bridge 3c partition and telemetry status.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "boundary": {
                      "type": "string"
                    },
                    "readOnly": {
                      "type": "boolean"
                    },
                    "endpoint": {
                      "type": "string"
                    },
                    "userAgent": {
                      "type": "string"
                    },
                    "rollup": {
                      "type": "object"
                    },
                    "generatedAt": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts:1914-2592",
            "services/sportsdesk_webview_server.ts#GET /agent-graph.webp"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of GET /api/bridge3c/status (handler-verified only)."
        },
        "x-surface-id": "surface.daemon-graph-data-plane"
      }
    },
    "/api/signals/kalshi": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Watchlist signals joined to Kalshi markets (GET /api/signals/kalshi)",
        "description": "Derives watchlist signals from the graph feed's pendingBets, data/live-wagers.json and data/live-bets.json (lib/watchlist_signal_engine.ts), then joins each to one open Kalshi market and walks its order book for liquidity and an executable edge (lib/kalshi_signal_join.ts, services/sportsdesk_webview_server.ts#/api/signals/kalshi). Read-only: the Kalshi client (lib/kalshi_client.ts) uses public GET endpoints only, sends no auth header, and ignores KALSHI_API_KEY; no order or portfolio endpoint is reachable. A fixture-sourced signal is capped at `fixture_only`; network failure is `degraded` with a reason instead of a fabricated price. The body carries watchlist logins and risk, so it uses the graph plane's `pii` guard. Surface: surface.daemon-graph-data-plane (tier D).",
        "operationId": "getApiSignalsKalshi",
        "responses": {
          "200": {
            "description": "Signal envelope: config thresholds, provenance, Kalshi telemetry (ok/degraded/requests/cacheHits/errors) and joined signals with a verdict.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "success",
                    "schemaVersion",
                    "generatedAt",
                    "config",
                    "provenance",
                    "kalshi",
                    "signals"
                  ],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": true
                    },
                    "schemaVersion": {
                      "type": "integer",
                      "const": 1
                    },
                    "generatedAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "config": {
                      "type": "object",
                      "properties": {
                        "minEdgeBps": {
                          "type": "number"
                        },
                        "minContracts": {
                          "type": "number"
                        },
                        "maxSpreadCents": {
                          "type": "number"
                        },
                        "referenceNotionalUsd": {
                          "type": "number"
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "kalshi": {
                      "type": "object",
                      "properties": {
                        "ok": {
                          "type": "boolean"
                        },
                        "degraded": {
                          "type": "boolean"
                        },
                        "requests": {
                          "type": "integer"
                        },
                        "cacheHits": {
                          "type": "integer"
                        },
                        "errors": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "additionalProperties": true
                          }
                        }
                      }
                    },
                    "signals": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or wrong admin token (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts:1914-2592",
            "services/sportsdesk_webview_server.ts#GET /agent-graph.webp"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of GET /api/signals/kalshi (handler-verified only; no HTTP response was captured), plus a Kalshi order-book capture for the liquidity fields."
        },
        "x-surface-id": "surface.daemon-graph-data-plane"
      }
    },
    "/api/gslive/weblogs": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "GSLive WebLog activity (GET /api/gslive/weblogs)",
        "description": "Serves the last GSLive WebLog audit pass from the local git-ignored artifact (lib/gslive_weblog_activity.ts, services/sportsdesk_webview_server.ts#/api/gslive/weblogs). Local-only: a request never touches GSLive or the network; a missing/stale artifact is `not_measured`/`stale` with the `bun run gslive:weblogs:refresh` command instead of zeros. Rows carry account logins and audit flags, so it uses the graph plane's `pii` guard. Surface: surface.daemon-graph-data-plane (tier D).",
        "operationId": "getApiGsliveWeblogs",
        "responses": {
          "200": {
            "description": "Activity envelope: measured or not_measured, source/asOf/ageSeconds/stale, account rows and summary.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "success",
                    "schemaVersion",
                    "generatedAt",
                    "status",
                    "accounts",
                    "summary"
                  ],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": true
                    },
                    "schemaVersion": {
                      "type": "integer",
                      "const": 1
                    },
                    "generatedAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "status": {
                      "type": "string",
                      "enum": ["measured", "not_measured"]
                    },
                    "source": {
                      "type": "string",
                      "nullable": true
                    },
                    "asOf": {
                      "type": "string",
                      "nullable": true
                    },
                    "ageSeconds": {
                      "type": "number",
                      "nullable": true
                    },
                    "stale": {
                      "type": "boolean"
                    },
                    "accounts": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "summary": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "reason": {
                      "type": "string"
                    },
                    "command": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or wrong admin token (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts:1914-2592",
            "services/sportsdesk_webview_server.ts#GET /agent-graph.webp"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of GET /api/gslive/weblogs (handler-verified only; no HTTP response was captured)."
        },
        "x-surface-id": "surface.daemon-graph-data-plane"
      }
    },
    "/api/gslive/session-health": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "GSLive Manager Tools session health (GET /api/gslive/session-health)",
        "description": "Reports the resolved credential source and a cached cookie-only probe of `GET /manager-tools/partnerConfig/` (lib/gslive_session_health.ts, lib/manager_session.ts). Never returns the GSID value: only cookie names, source, probe status/httpStatus/latency, and an advisory. A 403 with `cf-mitigated` is a human challenge; 302/401/HTML-200 is an expired cookie. The v4 GETs need no `x-gs-session`, and the daemon holds no per-run signin session. Uses the graph plane's `pii` guard. Surface: surface.daemon-graph-data-plane (tier D).",
        "operationId": "getApiGsliveSessionHealth",
        "responses": {
          "200": {
            "description": "Session health: resolution source, cookie names only, cached probe classification and advisory.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "success",
                    "schemaVersion",
                    "generatedAt",
                    "authModel",
                    "session",
                    "probe",
                    "surfaceMap",
                    "advisory"
                  ],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": true
                    },
                    "schemaVersion": {
                      "type": "integer",
                      "const": 1
                    },
                    "generatedAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "authModel": {
                      "type": "object",
                      "required": ["durable", "modern", "legacy"],
                      "properties": {
                        "durable": {
                          "type": "string"
                        },
                        "modern": {
                          "type": "string"
                        },
                        "legacy": {
                          "type": "string"
                        }
                      }
                    },
                    "session": {
                      "type": "object",
                      "required": [
                        "configured",
                        "source",
                        "cookieName",
                        "cookieNames"
                      ],
                      "properties": {
                        "configured": {
                          "type": "boolean"
                        },
                        "source": {
                          "type": "string"
                        },
                        "cookieName": {
                          "type": "string",
                          "const": "GSID"
                        },
                        "cookieNames": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "probe": {
                      "type": "object",
                      "required": [
                        "status",
                        "httpStatus",
                        "latencyMs",
                        "checkedAt",
                        "cfMitigated",
                        "detail",
                        "cached"
                      ],
                      "properties": {
                        "status": {
                          "type": "string",
                          "enum": [
                            "ok",
                            "expired",
                            "challenge",
                            "forbidden",
                            "throttled",
                            "unreachable",
                            "unconfigured"
                          ]
                        },
                        "httpStatus": {
                          "type": "number",
                          "nullable": true
                        },
                        "latencyMs": {
                          "type": "number",
                          "nullable": true
                        },
                        "checkedAt": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "cfMitigated": {
                          "type": "string",
                          "nullable": true
                        },
                        "detail": {
                          "type": "string"
                        },
                        "cached": {
                          "type": "boolean"
                        }
                      }
                    },
                    "surfaceMap": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "capability",
                          "legacy",
                          "modern",
                          "status",
                          "note"
                        ],
                        "properties": {
                          "capability": {
                            "type": "string"
                          },
                          "legacy": {
                            "type": "string"
                          },
                          "modern": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string",
                            "enum": ["v4", "listed", "legacy", "unverified"]
                          },
                          "note": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "advisory": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or wrong admin token (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts:1914-2592",
            "services/sportsdesk_webview_server.ts#GET /agent-graph.webp"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of GET /api/gslive/session-health (handler-verified only; no HTTP response was captured)."
        },
        "x-surface-id": "surface.daemon-graph-data-plane"
      }
    },
    "/api/execution/plan": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Execution plan, read-only (GET /api/execution/plan)",
        "description": "Plans venue/style/size for the current watchlist signals from public books only (lib/execution_planner.ts, lib/execution_decision.ts; services/sportsdesk_webview_server.ts#/api/execution/plan). The engine is paper by default: decisions carry `paper`, `reasons` and `blockReason`, and this route never calls an order endpoint. Live readiness is reported per venue (Kalshi adapter credentials; Polymarket has no EIP-712 signer in this checkout). The body carries watchlist logins/risk, so it uses the graph plane's `pii` guard. Surface: surface.daemon-graph-data-plane (tier D).",
        "operationId": "getApiExecutionPlan",
        "responses": {
          "200": {
            "description": "Plan envelope: mode/killSwitch/policy/venues/risk/decisions and the paper quote+fill tail.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "success",
                    "schemaVersion",
                    "generatedAt",
                    "mode",
                    "killSwitch",
                    "policy",
                    "venues",
                    "risk",
                    "decisions",
                    "paper"
                  ],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": true
                    },
                    "schemaVersion": {
                      "type": "integer",
                      "const": 1
                    },
                    "generatedAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "mode": {
                      "type": "string",
                      "enum": ["paper", "paused", "live"]
                    },
                    "killSwitch": {
                      "type": "boolean"
                    },
                    "policy": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "venues": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "risk": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "decisions": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "paper": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "blockedReasons": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "number"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or wrong admin token (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts:1914-2592",
            "services/sportsdesk_webview_server.ts#GET /agent-graph.webp"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of GET /api/execution/plan (handler-verified only; no HTTP response was captured and no live order exists to capture)."
        },
        "x-surface-id": "surface.daemon-graph-data-plane"
      }
    },
    "/api/execution/mode": {
      "post": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Paper/paused/live mode switch (POST /api/execution/mode)",
        "description": "Sets the in-memory execution mode and audits the change in the local execution ledger (services/sportsdesk_webview_server.ts#/api/execution/mode). `paper` and `paused` are always accepted; `live` requires `EXECUTION_LIVE=1`, a live-ready Kalshi adapter and `confirm:\"LIVE\"`, otherwise it answers 409 with the reasons. Admin-token/PII gate applies. Surface: surface.daemon-graph-data-plane (tier D).",
        "operationId": "postApiExecutionMode",
        "responses": {
          "200": {
            "description": "Mode changed and audited.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": true
                    },
                    "mode": {
                      "type": "string"
                    },
                    "previousMode": {
                      "type": "string"
                    },
                    "killSwitch": {
                      "type": "boolean"
                    },
                    "generatedAt": {
                      "type": "string",
                      "format": "date-time"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid mode or body.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or wrong admin token (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "mode:\"live\" without EXECUTION_LIVE=1 + adapter credentials + confirm:\"LIVE\".",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    },
                    "reasons": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts:1914-2592",
            "services/sportsdesk_webview_server.ts#GET /agent-graph.webp"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of a paper→paused→paper round trip (handler-verified only)."
        },
        "x-surface-id": "surface.daemon-graph-data-plane",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["mode"],
                "properties": {
                  "mode": {
                    "type": "string",
                    "enum": ["paper", "paused", "live"]
                  },
                  "confirm": {
                    "type": "string"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/execution/run": {
      "post": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Run the plan: paper fills, or gated live placement (POST /api/execution/run)",
        "description": "Plans once, then paper-fills (taker book walk / resting maker quotes) unless `live:true` with `confirm:\"PLACE LIVE ORDERS\"` and every gate is satisfied, in which case only unblocked, non-paper Kalshi decisions are handed to the live adapter (services/sportsdesk_webview_server.ts#/api/execution/run, lib/kalshi_live_execution.ts). Polymarket live is always refused with its reason. One run per 2s answers 429. PII-gated. Surface: surface.daemon-graph-data-plane (tier D).",
        "operationId": "postApiExecutionRun",
        "responses": {
          "200": {
            "description": "Paper fills/quotes, or live placement results.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": true
                    },
                    "mode": {
                      "type": "string"
                    },
                    "generatedAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "live": {
                      "type": "boolean"
                    },
                    "paper": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "placed": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or wrong admin token (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Live run requested without the env flag, credentials or confirm phrase.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    },
                    "reasons": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "A run happened less than 2s ago; retry after the given delay.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    },
                    "retryAfterMs": {
                      "type": "number"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts:1914-2592",
            "services/sportsdesk_webview_server.ts#GET /agent-graph.webp"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of a paper run with a temp ledger (handler-verified only); a live run is not possible in this checkout."
        },
        "x-surface-id": "surface.daemon-graph-data-plane",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "live": {
                    "type": "boolean"
                  },
                  "confirm": {
                    "type": "string"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/telegram/status": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Telegram configuration and schedules (GET /api/telegram/status)",
        "description": "Returns {success, status, schedules, reportTypes} from the bot service and the in-process scheduler (services/sportsdesk_webview_server.ts#/api/telegram/status). Admin-token gated regardless of peer address. Surface: surface.daemon-telegram-admin-routes (tier D).",
        "operationId": "getApiTelegramStatus",
        "responses": {
          "200": {
            "description": "Bot mode, schedules and the report vocabulary.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": true
                    },
                    "status": {
                      "type": "object"
                    },
                    "schedules": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "reportTypes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or wrong admin token (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts#POST /telegram/webhook",
            "services/sportsdesk_webview_server.ts#GET /api/telegram/status",
            "services/sportsdesk_webview_server.ts:1139-1141,1132-1136"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of GET /api/telegram/status with a valid token."
        },
        "x-surface-id": "surface.daemon-telegram-admin-routes"
      }
    },
    "/api/telegram/activity": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Recent Telegram activity (GET /api/telegram/activity)",
        "description": "Returns {success, entries} from the activity log; `limit` defaults to 50 and clamps to 1..200 (services/sportsdesk_webview_server.ts#/api/telegram/activity). Admin-token gated. Surface: surface.daemon-telegram-admin-routes (tier D).",
        "operationId": "getApiTelegramActivity",
        "responses": {
          "200": {
            "description": "Newest-first activity entries.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": true
                    },
                    "entries": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or wrong admin token (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts#POST /telegram/webhook",
            "services/sportsdesk_webview_server.ts#GET /api/telegram/status",
            "services/sportsdesk_webview_server.ts:1139-1141,1132-1136"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of GET /api/telegram/activity with a valid token."
        },
        "x-surface-id": "surface.daemon-telegram-admin-routes"
      }
    },
    "/api/telegram/webhook": {
      "post": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Register or delete the Telegram webhook (POST /api/telegram/webhook)",
        "description": "Body {action: \"set\" | \"delete\"} calls telegramService.setWebhook()/deleteWebhook() and mirrors the Bot API result as {success, ok, error?}, 502 when Telegram refuses (services/sportsdesk_webview_server.ts#/api/telegram/webhook). Admin-token gated; this is the control plane, distinct from the secret-checked /telegram/webhook that receives updates. Surface: surface.daemon-telegram-admin-routes (tier D).",
        "operationId": "postApiTelegramWebhook",
        "responses": {
          "200": {
            "description": "Telegram accepted the change.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "ok": {
                      "type": "boolean"
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "action is missing or not \"set\"/\"delete\".",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or wrong admin token (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "502": {
            "description": "Telegram answered ok:false; its description is passed through.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "ok": {
                      "type": "boolean"
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["success", "error"],
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts#POST /telegram/webhook",
            "services/sportsdesk_webview_server.ts#GET /api/telegram/status",
            "services/sportsdesk_webview_server.ts:1139-1141,1132-1136"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of a set and a delete round trip against the Bot API."
        },
        "x-surface-id": "surface.daemon-telegram-admin-routes",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["action"],
                "properties": {
                  "action": {
                    "type": "string",
                    "enum": ["set", "delete"]
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/test/error": {
      "get": {
        "tags": ["Local Desk & Telegram Gateway"],
        "summary": "Error-boundary probe (GET /api/test/error)",
        "description": "Throws a string so the server's error boundary runs; `?trigger_error=non_error` does the same on any route (services/sportsdesk_webview_server.ts, baseHeaders). Deliberately reachable in production so a deployment can prove the 500 body carries no stack trace. Surface: surface.daemon-telegram-admin-routes (tier D).",
        "operationId": "getApiTestError",
        "responses": {
          "500": {
            "description": "The daemon's structured 500: no stack, no source, only the thrown message.",
            "headers": {
              "Content-Security-Policy": {
                "$ref": "#/components/headers/CSPHeader"
              },
              "X-Content-Type-Options": {
                "$ref": "#/components/headers/XContentTypeOptionsHeader"
              },
              "Referrer-Policy": {
                "$ref": "#/components/headers/ReferrerPolicyHeader"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "const": false
                    },
                    "error": {
                      "type": "string",
                      "const": "Internal Server Error"
                    },
                    "message": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-evidence": {
          "tier": "D",
          "sources": [
            "services/sportsdesk_webview_server.ts#POST /telegram/webhook",
            "services/sportsdesk_webview_server.ts#GET /api/telegram/status",
            "services/sportsdesk_webview_server.ts:1139-1141,1132-1136"
          ],
          "capturedResponse": false,
          "requiredCapture": "HTTP capture of the 500 body in production (asserted by tests/server_error.test.ts, not captured as an artifact)."
        },
        "x-surface-id": "surface.daemon-telegram-admin-routes"
      }
    }
  },
  "x-sportsdesk-gslive": {
    "provider": "GSLive Manager (Partner 118)",
    "kind": "operator-deep-links-not-wire-operations",
    "origin": "https://plive.sportswidgets.pro",
    "managerPath": "/manager-tools/",
    "partnerId": 118,
    "cli": "./bin/dx gslive <LOGIN>",
    "contractDoc": "docs/gs-manager-contracts.md",
    "surfaces": [
      {
        "id": "users-report",
        "route": "#/reports/users",
        "purpose": "Per-account batch report (profit, bets, hold %, wager and leg counts).",
        "windows": ["today", "7d", "14d", "churn"],
        "requiredQuery": {
          "bot": "true",
          "eventId": "",
          "from": "<desk-day start, ISO-8601 UTC>",
          "partnerId": "118",
          "searchBy": "player",
          "text": "player_<LOGIN>",
          "to": "<desk-day end, ISO-8601 UTC>"
        },
        "notes": [
          "bot=true is mandatory; the SPA defaults the bot switch off and hides syndicate accounts.",
          "from/to must be explicit desk-day boundaries; a bare text search renders an empty grid."
        ],
        "example": "https://plive.sportswidgets.pro/manager-tools/#/reports/users?bot=true&eventId=&from=2026-10-18T05%3A00%3A00.000Z&partnerId=118&searchBy=player&text=player_CHURN_003&to=2026-10-26T04%3A59%3A59.000Z"
      },
      {
        "id": "bet-history-calctime",
        "route": "#/events/bet-history",
        "purpose": "Live settling/populating ticket stream (calcTime).",
        "requiredQuery": {
          "minVolume": "0",
          "maxTimeUntilScore": "0",
          "from": "<desk-day start, epoch seconds>",
          "to": "<desk-day start, epoch seconds>",
          "toTime": "<desk day length - 1: 86399, or 89999/82799 on DST days>",
          "dateFilterBy": "calcTime",
          "t": "<epoch milliseconds cache-buster>"
        },
        "notes": [
          "partnerUserId is the raw login (e.g. AF12), not player_AF12; it is still unverified as a server-side filter in the SPA router.",
          "t must be refreshed on every open; a frozen value serves a cached grid."
        ],
        "example": "https://plive.sportswidgets.pro/manager-tools/#/events/bet-history?minVolume=0&maxTimeUntilScore=0&from=1793422800&to=1793422800&toTime=86399&dateFilterBy=calcTime&t=1793469958152"
      },
      {
        "id": "bet-history-bettime",
        "route": "#/events/bet-history",
        "purpose": "Live placement stream (betTime).",
        "requiredQuery": {
          "minVolume": "0",
          "maxTimeUntilScore": "0",
          "from": "<desk-day start, epoch seconds>",
          "to": "<desk-day start, epoch seconds>",
          "toTime": "<desk day length - 1: 86399, or 89999/82799 on DST days>",
          "dateFilterBy": "betTime",
          "t": "<epoch milliseconds cache-buster>"
        },
        "notes": ["Same day window as calcTime; only dateFilterBy differs."],
        "example": "https://plive.sportswidgets.pro/manager-tools/#/events/bet-history?minVolume=0&maxTimeUntilScore=0&from=1793422800&to=1793422800&toTime=86399&dateFilterBy=betTime&t=1793469958152"
      }
    ]
  },
  "components": {
    "securitySchemes": {
      "fantasy402Cookie": {
        "type": "apiKey",
        "in": "cookie",
        "name": "session",
        "description": "Fantasy402 Manager portal session. [OBSERVED] 2026-11-01: a Manager page sends `Authorization: Bearer <token>`, where the token is `sessionStorage.credentials.code` after login. The same request without that header is refused with 401 by openresty, so the cookie alone is not sufficient. The 2026-10-28 HAR carried no Authorization header, which is now contradicted. The cookie name is unrecorded, so 'session' is a placeholder label."
      },
      "daemonBearer": {
        "type": "http",
        "scheme": "bearer",
        "description": "Static daemon admin token: Authorization: Bearer <SPORTSDESK_ADMIN_TOKEN>, compared with crypto.timingSafeEqual (services/sportsdesk_webview_server.ts, adminRejection). The daemon answers 503 when SPORTSDESK_ADMIN_TOKEN is unset and 401 otherwise."
      }
    },
    "parameters": {
      "XRequestedWith": {
        "name": "X-Requested-With",
        "in": "header",
        "required": true,
        "description": "Observed on the captured 2026-10-28 mode-B Manager request. Whether the portal enforces it is unverified.",
        "schema": {
          "type": "string",
          "enum": ["XMLHttpRequest"]
        }
      }
    },
    "headers": {
      "CSPHeader": {
        "description": "Content-Security-Policy applied to daemon responses: frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram: (services/sportsdesk_webview_server.ts, baseHeaders).",
        "schema": {
          "type": "string"
        }
      },
      "XContentTypeOptionsHeader": {
        "description": "X-Content-Type-Options: nosniff (services/sportsdesk_webview_server.ts, baseHeaders).",
        "schema": {
          "type": "string",
          "enum": ["nosniff"]
        }
      },
      "ReferrerPolicyHeader": {
        "description": "Referrer-Policy: strict-origin-when-cross-origin (services/sportsdesk_webview_server.ts, baseHeaders).",
        "schema": {
          "type": "string",
          "enum": ["strict-origin-when-cross-origin"]
        }
      }
    },
    "schemas": {
      "Fantasy402SportCatalog": {
        "type": "object",
        "description": "Fantasy402 desk navigation catalog (sub-sport lanes plus per-sport period menus). Reference metadata only, not an ingestion audit record. Surface: surface.fantasy402-sport-catalog (tier D). Parsed from fantasy402_sport_catalog.ts#Fantasy402SportCatalog.",
        "properties": {
          "provider": {
            "type": "string"
          },
          "capturedAt": {
            "type": "string"
          },
          "sportCount": {
            "type": "number"
          },
          "subSportCount": {
            "type": "number"
          },
          "sports": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SportEntry"
            }
          },
          "collisions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CollisionEntry"
            },
            "description": "SSOT for scoped ingestion link_id keys (must match observed cross-sport codes)."
          },
          "expectedEmptySubSportPaths": {
            "$ref": "#/components/schemas/ExpectedEmptySubSportPaths",
            "description": "Domain-correct structural empties (sport/code paths), not quality defects."
          },
          "migrationRisks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CatalogMigrationRisk"
            }
          },
          "periodsCapturedAt": {
            "type": "string"
          },
          "sportPeriodCount": {
            "type": "number"
          }
        },
        "required": [
          "provider",
          "capturedAt",
          "sportCount",
          "subSportCount",
          "sports",
          "collisions",
          "expectedEmptySubSportPaths"
        ],
        "x-fixture": {
          "path": "tests/fixtures/fantasy402-sport-catalog-2026-10-21.json",
          "provider": "fantasy402",
          "capturedAt": "2026-10-21T16:38:53.513Z",
          "periodsCapturedAt": "2026-10-30T04:59:14.572Z",
          "sportCount": 19,
          "subSportCount": 230,
          "sportPeriodCount": 42,
          "collisionIds": ["Arena", "NCAA Extra"],
          "caveat": "Committed SSOT sample, not a raw wire capture. capturedAt/periodsCapturedAt are fixture-declared."
        }
      },
      "SubSport": {
        "type": "object",
        "description": "Sub-sport lane inside one sport (code plus display name). Parsed from fantasy402_sport_catalog.ts#Fantasy402SubSport.",
        "properties": {
          "code": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "required": ["code", "name"]
      },
      "Period": {
        "type": "object",
        "description": "Period menu entry for one sport; period 0 is named Game. Parsed from fantasy402_sport_catalog.ts#Fantasy402Period.",
        "properties": {
          "name": {
            "type": "string"
          },
          "number": {
            "type": "number"
          }
        },
        "required": ["name", "number"]
      },
      "SportEntry": {
        "type": "object",
        "description": "Per-sport lane: the sub-sport tree plus the period menu. Parsed from fantasy402_sport_catalog.ts#Fantasy402SportEntry.",
        "properties": {
          "sport": {
            "type": "string"
          },
          "subSports": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SubSport"
            }
          },
          "periods": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Period"
            }
          }
        },
        "required": ["sport", "subSports", "periods"]
      },
      "CollisionEntry": {
        "type": "object",
        "description": "Desk-link code shared across sports (Arena, NCAA Extra). makeDeskLinkId rewrites these to <Sport>|<code>; the collision silently breaks scoped ingestion if it is not represented. Parsed from fantasy402_sport_catalog.ts#Fantasy402CollisionEntry.",
        "properties": {
          "code": {
            "type": "string"
          },
          "sports": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": ["code", "sports"]
      },
      "ExpectedEmptySubSportPaths": {
        "type": "object",
        "description": "Domain-correct structural empties (sport/code paths) split into stable and volatile LIVE surfaces; not quality defects. Parsed from fantasy402_sport_catalog.ts#ExpectedEmptySubSportPaths.",
        "properties": {
          "stable": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "volatile": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": ["stable", "volatile"]
      },
      "CatalogMigrationRisk": {
        "type": "object",
        "description": "Migration hazard note attached to catalogue entries that need coordinated link_id migration. Parsed from fantasy402_sport_catalog.ts#CatalogMigrationRisk.",
        "properties": {
          "kind": {
            "type": "string"
          },
          "code": {
            "type": "string"
          },
          "affects": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "note": {
            "type": "string"
          }
        },
        "required": ["kind", "note"]
      },
      "RawBetTickerTick": {
        "type": "object",
        "description": "Consumer wire type for one bet-ticker row. Field names and number types only. The getBetTicker operation is now tier A: its response schema is derived from the live capture skeleton, while this component remains a consumer type declaration. Parsed from simulate_bettor_churn_suite.ts#RawBetTickerTick.",
        "properties": {
          "wagerNumber": {
            "type": "number"
          },
          "Login": {
            "type": "string"
          },
          "TicketWriter": {
            "type": "string",
            "description": "Wire value or free string. Known values: Internet | ALERT | GSLIVE | GSBUILDER | CSLEVEL2 | BLOCKED"
          },
          "Risk": {
            "type": "number",
            "description": "In cents"
          },
          "ToWin": {
            "type": "number",
            "description": "In cents"
          },
          "Description": {
            "type": "string"
          },
          "InsertDateTime": {
            "type": "string",
            "description": "UTC-5"
          },
          "ShortDesc": {
            "type": "string"
          }
        },
        "required": [
          "wagerNumber",
          "Login",
          "TicketWriter",
          "Risk",
          "ToWin",
          "Description",
          "InsertDateTime",
          "ShortDesc"
        ]
      },
      "RawPendingLeg": {
        "type": "object",
        "description": "Consumer wire type for one pending wager leg. Risk and ToWin are cents and repeat identically across parlay legs. This is a type declaration, not a captured response; no pending-leg fixture or capture exists, so the getPending operation (tier C) publishes no response schema. Parsed from simulate_bettor_churn_suite.ts#RawPendingLegRow.",
        "properties": {
          "Login": {
            "type": "string"
          },
          "WagerNumber": {
            "type": "number"
          },
          "LegNumber": {
            "type": "number"
          },
          "Risk": {
            "type": "number",
            "description": "In cents (repeats identically across parlay legs)"
          },
          "ToWin": {
            "type": "number",
            "description": "In cents (repeats identically across parlay legs)"
          },
          "WagerType": {
            "type": "string",
            "enum": ["A", "M", "C", "S", "T", "L", "E", "I", "P", "F", "G"],
            "description": "'G' = live"
          },
          "ShortDesc": {
            "type": "string",
            "description": "Sanitized first char gives true bet type"
          },
          "TicketWriter": {
            "type": "string",
            "description": "Wire value or free string. Known values: Internet | ALERT | GSLIVE | GSBUILDER | CSLEVEL2 | BLOCKED"
          },
          "InsertDateTime": {
            "type": "string",
            "description": "UTC-5 accepted timestamp"
          },
          "VIP": {
            "type": "string"
          },
          "Team": {
            "type": "string"
          },
          "Line": {
            "type": "string"
          }
        },
        "required": [
          "Login",
          "WagerNumber",
          "LegNumber",
          "Risk",
          "ToWin",
          "WagerType",
          "ShortDesc",
          "TicketWriter",
          "InsertDateTime"
        ]
      },
      "WeblogEntry": {
        "type": "object",
        "description": "Consumer type that declares the four fields the old spec published as the getWebLog response row (customerID, ipAddress, timestamp, agentOwner). The getWebLog operation is now tier A and derives its response schema from the live capture skeleton; this component remains a consumer type declaration and is not used for that schema. Parsed from simulate_bettor_churn_suite.ts#RawWebLogEntry.",
        "properties": {
          "customerID": {
            "type": "string"
          },
          "ipAddress": {
            "type": "string"
          },
          "timestamp": {
            "type": "string"
          },
          "agentOwner": {
            "type": "string"
          }
        },
        "required": ["customerID", "ipAddress", "timestamp", "agentOwner"]
      }
    }
  }
}
