{
  "openapi": "3.1.0",
  "info": {
    "title": "TensorTrace Public API",
    "version": "1.10.0",
    "description": "One public API. Serial acquisition and incremental preparation keep read models current. Pages see current committed rows; no global snapshot token is required. Source receipts retain exact observation provenance."
  },
  "servers": [
    {
      "url": "/api/v1"
    }
  ],
  "paths": {
    "/overview": {
      "get": {
        "operationId": "catalogOverview",
        "summary": "Read catalog statistics",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Incrementally prepared local data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CatalogOverview"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not present in the prepared catalog",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Catalog preparation has not completed yet",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "x-document-page": "overview",
        "tags": [
          "Overview"
        ],
        "description": "Current counts and latest preparation timestamps from incrementally maintained local read models. This endpoint does not pin a catalog version."
      }
    },
    "/facets": {
      "get": {
        "operationId": "facets",
        "summary": "Read combined discovery filters",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Source-backed JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FacetsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query"
          },
          "404": {
            "description": "Unknown model/source"
          },
          "500": {
            "description": "Database unavailable"
          },
          "503": {
            "description": "Service temporarily unavailable"
          }
        },
        "x-document-page": "facets",
        "tags": [
          "Facets"
        ]
      }
    },
    "/models": {
      "get": {
        "operationId": "catalogModels",
        "summary": "List and search models",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Case-insensitive search text. Omit it to browse the complete matching catalog."
          },
          {
            "name": "query",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Alternative spelling of q; when both are supplied, query takes precedence."
          },
          {
            "name": "provider",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Model publisher namespace. For serving-platform filters, use inference_provider instead."
          },
          {
            "name": "source",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Registered data-source ID, such as openRouter. This identifies the collecting source, not necessarily the model developer."
          },
          {
            "name": "price",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "all",
                "free",
                "paid"
              ],
              "default": "all"
            },
            "description": "Pricing class: all, free or paid. Uses comparable basic token prices; an unknown price is not free."
          },
          {
            "name": "capability",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Comma-separated capability identifiers; all must match."
          },
          {
            "name": "input_modality",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Match an input modality, such as text, image, audio or video. Obtain current values from /facets/models."
          },
          {
            "name": "model_type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 64
            },
            "description": "Match a displayed model classification, including secondary types. Use multimodal for MLLM, vlm for image-only VLM, llm for text LLM, or another model type ID from a classification link. unknown selects models without reported classification evidence. Omit or use all for no type filter. Combines with other discovery filters before pagination and counts; an unrecognized ID returns an empty result."
          },
          {
            "name": "output_modalities",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Comma-separated output modalities; matches models with any listed output modality. all disables this filter."
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "intelligence"
            },
            "description": "Defaults to Intelligence Index descending; unscored models follow using capability, rating and name as deterministic fallbacks. Price sorts use the card-selected USD Input then Output rates, with missing rates last; cache rates do not participate. Tied basic offerings prefer the model developer. Provider-scoped sorts apply the same policy within that source's quotes."
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 48
            },
            "description": "Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise."
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            },
            "description": "Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0."
          },
          {
            "name": "identity_kind",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "model",
                "family"
              ]
            },
            "description": "Restrict identities to a concrete model or a model family; omit to include both."
          },
          {
            "name": "developer",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Canonical developer ID; groups reviewed publisher aliases."
          },
          {
            "name": "inference_provider",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Registered inference source ID; selects current source offerings, including price-only records. Adds source-scoped provider_prices; other model fields retain canonical scope."
          }
        ],
        "responses": {
          "200": {
            "description": "Incrementally prepared local data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ModelPage"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not present in the prepared catalog",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Catalog preparation has not completed yet",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "x-document-page": "models",
        "tags": [
          "Models"
        ]
      }
    },
    "/prices": {
      "get": {
        "operationId": "prices",
        "summary": "Compare price observations",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Case-insensitive search text. Omit it to browse the complete matching catalog."
          },
          {
            "name": "provider",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Registered serving-source ID, such as anthropic or openRouter. Omit to include all platforms for this model."
          },
          {
            "name": "source",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Registered data-source ID, such as openRouter. This identifies the collecting source, not necessarily the model developer."
          },
          {
            "name": "platform",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Exact serving-platform label on a published price quote."
          },
          {
            "name": "unit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Billing or performance unit, preserving the source’s explicit denominator. Compare only equivalent units."
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "amount-low-to-high",
              "enum": [
                "amount-low-to-high",
                "amount-high-to-low",
                "updated-newest",
                "model",
                "priceHigh",
                "pricing-high-to-low",
                "updated",
                "name"
              ]
            },
            "description": "Order of results. Missing comparable values sort after known values."
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000,
              "default": 100
            },
            "description": "Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise."
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            },
            "description": "Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0."
          }
        ],
        "responses": {
          "200": {
            "description": "Source-backed JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PriceComparisonResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query"
          },
          "404": {
            "description": "Unknown model/source"
          },
          "500": {
            "description": "Database unavailable"
          },
          "503": {
            "description": "Service temporarily unavailable"
          }
        },
        "description": "Comparable USD amounts with explicit pricing units.",
        "x-document-page": "prices",
        "tags": [
          "Prices"
        ]
      }
    },
    "/leaderboards": {
      "get": {
        "operationId": "leaderboards",
        "summary": "List ranked benchmark boards",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Case-insensitive search text. Omit it to browse the complete matching catalog."
          },
          {
            "name": "source",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Registered data-source ID, such as openRouter. This identifies the collecting source, not necessarily the model developer."
          },
          {
            "name": "dimension",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Exact benchmark comparison dimension; source-native dimensions are available in /facets/leaderboards."
          },
          {
            "name": "benchmark",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Case-insensitive substring of the benchmark name. It does not merge different benchmark versions or conditions."
          },
          {
            "name": "benchmark_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Exact source-native benchmark ID. Prefer it when a name substring would match multiple benchmarks."
          },
          {
            "name": "leaderboard",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Case-insensitive substring of the comparison-board name."
          },
          {
            "name": "leaderboard_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Exact comparison-board ID; ranks are meaningful only within the same board and conditions."
          },
          {
            "name": "entry_limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "description": "Maximum number of ranked entries returned within each board. Default 50; clamped to 1–100."
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500,
              "default": 500
            },
            "description": "Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise."
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            },
            "description": "Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0."
          },
          {
            "name": "entry_offset",
            "in": "query",
            "description": "Offset within each ranking cohort; preserves published ranks.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Source-backed JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LeaderboardsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query"
          },
          "404": {
            "description": "Unknown model/source"
          },
          "500": {
            "description": "Database unavailable"
          },
          "503": {
            "description": "Service temporarily unavailable"
          }
        },
        "description": "Scores grouped by evaluation; ranks retain the upstream ranking scope.",
        "x-document-page": "benchmarks",
        "tags": [
          "Benchmarks"
        ]
      }
    },
    "/sources": {
      "get": {
        "operationId": "sources",
        "summary": "List source coverage and freshness",
        "parameters": [
          {
            "name": "source",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Registered data-source ID, such as openRouter. This identifies the collecting source, not necessarily the model developer."
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Source collection status. Use the status identifiers returned by /sources."
          },
          {
            "name": "authority",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Exact registered authority classification from a source’s authority field."
          },
          {
            "name": "access_method",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Exact registered acquisition method from a source’s access_method field."
          },
          {
            "name": "freshness",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Freshness state: fresh, stale, refreshing, backoff, neverRefreshed or manual. due/needsrefresh selects due sources; needsattention/failed selects active failures; all disables the filter."
          }
        ],
        "responses": {
          "200": {
            "description": "Source-backed JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SourceDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid query"
          },
          "404": {
            "description": "Unknown model/source"
          },
          "500": {
            "description": "Database unavailable"
          },
          "503": {
            "description": "Service temporarily unavailable"
          }
        },
        "description": "Registered authority, coverage, freshness and source policy.",
        "x-document-page": "sources",
        "tags": [
          "Sources"
        ]
      }
    },
    "/refresh-jobs": {
      "get": {
        "operationId": "refresh-jobs",
        "summary": "List collection jobs",
        "parameters": [
          {
            "name": "source",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Registered data-source ID, such as openRouter. This identifies the collecting source, not necessarily the model developer."
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            },
            "description": "Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise."
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            },
            "description": "Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0."
          }
        ],
        "responses": {
          "200": {
            "description": "Source-backed JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RefreshJobsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query"
          },
          "404": {
            "description": "Unknown model/source"
          },
          "500": {
            "description": "Database unavailable"
          },
          "503": {
            "description": "Service temporarily unavailable"
          }
        },
        "x-document-page": "sources",
        "tags": [
          "Sources"
        ]
      }
    },
    "/mlperf/results": {
      "get": {
        "operationId": "mlperf_results",
        "summary": "List MLPerf system results",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Case-insensitive search text. Omit it to browse the complete matching catalog."
          },
          {
            "name": "model",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Case-insensitive substring of the source-reported model name."
          },
          {
            "name": "scenario",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Case-insensitive substring of the MLPerf execution scenario, such as Offline or Server."
          },
          {
            "name": "unit",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Billing or performance unit, preserving the source’s explicit denominator. Compare only equivalent units."
          },
          {
            "name": "suite",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Case-insensitive substring of the MLPerf suite label."
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            },
            "description": "Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise."
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            },
            "description": "Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0."
          }
        ],
        "responses": {
          "200": {
            "description": "Source-backed JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SystemPerformanceResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query"
          },
          "404": {
            "description": "Unknown model/source"
          },
          "500": {
            "description": "Database unavailable"
          },
          "503": {
            "description": "Service temporarily unavailable"
          }
        },
        "x-document-page": "systems",
        "tags": [
          "System Performance"
        ]
      }
    },
    "/safety/findings": {
      "get": {
        "operationId": "safety_findings",
        "summary": "List safety findings",
        "parameters": [
          {
            "name": "source",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Registered data-source ID, such as openRouter. This identifies the collecting source, not necessarily the model developer."
          },
          {
            "name": "model",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Case-insensitive substring of the source-reported model name."
          },
          {
            "name": "benchmark",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Case-insensitive substring of the benchmark name. It does not merge different benchmark versions or conditions."
          },
          {
            "name": "hazard",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Case-insensitive substring of the reported safety hazard."
          },
          {
            "name": "severity",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Case-insensitive substring of the reported safety severity."
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            },
            "description": "Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise."
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            },
            "description": "Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0."
          }
        ],
        "responses": {
          "200": {
            "description": "Source-backed JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SafetyFindingsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query"
          },
          "404": {
            "description": "Unknown model/source"
          },
          "500": {
            "description": "Database unavailable"
          },
          "503": {
            "description": "Service temporarily unavailable"
          }
        },
        "x-document-page": "safety",
        "tags": [
          "Safety Findings"
        ]
      }
    },
    "/huggingface/models": {
      "get": {
        "operationId": "huggingface_models",
        "summary": "Read original Hugging Face model metadata",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000,
              "default": 500
            },
            "description": "Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise."
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            },
            "description": "Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0."
          }
        ],
        "responses": {
          "200": {
            "description": "Source-backed JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "additionalProperties": true
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid query"
          },
          "404": {
            "description": "Unknown model/source"
          },
          "500": {
            "description": "Database unavailable"
          },
          "503": {
            "description": "Service temporarily unavailable"
          }
        },
        "x-document-page": "models",
        "tags": [
          "Models"
        ]
      }
    },
    "/providers/{provider}/models": {
      "get": {
        "operationId": "providers_provider_models",
        "summary": "Read a source-native provider catalog",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000,
              "default": 500
            },
            "description": "Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise."
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            },
            "description": "Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0."
          },
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Registered inference-provider/source ID, such as openRouter."
          },
          {
            "name": "receipt_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "description": "UUID of an immutable collection receipt. Omit it to use the latest source receipt."
          }
        ],
        "responses": {
          "200": {
            "description": "Source-backed JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NativeProviderModelsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query"
          },
          "404": {
            "description": "Unknown model/source"
          },
          "500": {
            "description": "Database unavailable"
          },
          "503": {
            "description": "Service temporarily unavailable"
          }
        },
        "description": "Server-cached provider metadata. Model Garden, Amazon Bedrock, Microsoft Foundry, NVIDIA, Black Forest Labs, Meta, ARC, Supernova, Alibaba Cloud Model Studio and Cheaper Inference expose pagination with total, has_more, next_offset and receipt_id. Pin receipt_id from the first page for an immutable snapshot across refreshes. Foundry includes all public nonarchived registry/model versions, including third-party and Hub models; Bedrock foundation models are scoped to the configured AWS region. Supernova offerings preserve standard/priority API IDs, base-model associations and public effective USD quotes; paused offerings retain metadata without purchasable prices. Alibaba Cloud is scoped to Singapore / international; publisher, inference provider, snapshot aliases, tiered catalog quotes and unverified currencies remain explicit. Cheaper Inference exposes its keyless public catalog; gateway attribution stays separate from model creators, and only validated single-tier standard text quotes are comparable. Credentials stay on the server. Deployment examples and hardware do not establish model limits or unit prices.",
        "x-document-page": "providers",
        "tags": [
          "Inference Providers"
        ]
      }
    },
    "/models/{provider}/{model}": {
      "get": {
        "operationId": "models_provider_model",
        "summary": "Prepared model overview; expand explicit detail sections as needed",
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Canonical model publisher namespace; URL-encode this path segment."
          },
          {
            "name": "model",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Canonical model name within the publisher namespace. URL-encode nested slashes in this single segment."
          }
        ],
        "responses": {
          "200": {
            "description": "Source-backed JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ModelOverview"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query"
          },
          "404": {
            "description": "Unknown model/source"
          },
          "500": {
            "description": "Database unavailable"
          },
          "503": {
            "description": "Service temporarily unavailable"
          }
        },
        "x-document-page": "models",
        "tags": [
          "Models"
        ]
      }
    },
    "/models/{provider}/{model}/scores": {
      "get": {
        "operationId": "models_provider_model_scores",
        "summary": "List model benchmark scores",
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Canonical model publisher namespace; URL-encode this path segment."
          },
          {
            "name": "model",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Canonical model name within the publisher namespace. URL-encode nested slashes in this single segment."
          },
          {
            "name": "source",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Registered data-source ID, such as openRouter. This identifies the collecting source, not necessarily the model developer."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            },
            "description": "Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise."
          },
          {
            "name": "offset",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            },
            "description": "Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0."
          }
        ],
        "responses": {
          "200": {
            "description": "Source-backed JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/BenchmarkScoreDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid query"
          },
          "404": {
            "description": "Unknown model/source"
          },
          "500": {
            "description": "Database unavailable"
          },
          "503": {
            "description": "Service temporarily unavailable"
          }
        },
        "x-document-page": "benchmarks",
        "tags": [
          "Benchmarks"
        ]
      }
    },
    "/models/{provider}/{model}/endpoints": {
      "get": {
        "operationId": "models_provider_model_endpoints",
        "summary": "Read provider endpoint observations",
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Canonical model publisher namespace; URL-encode this path segment."
          },
          {
            "name": "model",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Canonical model name within the publisher namespace. URL-encode nested slashes in this single segment."
          }
        ],
        "responses": {
          "200": {
            "description": "Source-backed JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query"
          },
          "404": {
            "description": "Unknown model/source"
          },
          "500": {
            "description": "Database unavailable"
          },
          "503": {
            "description": "Service temporarily unavailable"
          }
        },
        "x-document-page": "metrics",
        "tags": [
          "Operational Metrics"
        ]
      }
    },
    "/models/{provider}/{model}/history": {
      "get": {
        "operationId": "models_provider_model_history",
        "summary": "List model observation history",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000,
              "default": 500
            },
            "description": "Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise."
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            },
            "description": "Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0."
          },
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Canonical model publisher namespace; URL-encode this path segment."
          },
          {
            "name": "model",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Canonical model name within the publisher namespace. URL-encode nested slashes in this single segment."
          }
        ],
        "responses": {
          "200": {
            "description": "Source-backed JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ObservationHistory"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query"
          },
          "404": {
            "description": "Unknown model/source"
          },
          "500": {
            "description": "Database unavailable"
          },
          "503": {
            "description": "Service temporarily unavailable"
          }
        },
        "x-document-page": "evidence",
        "tags": [
          "Evidence"
        ]
      }
    },
    "/distributions": {
      "get": {
        "operationId": "distributions",
        "summary": "Search deployment and quantization variants",
        "parameters": [
          {
            "name": "source",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Registered data-source ID, such as openRouter. This identifies the collecting source, not necessarily the model developer."
          },
          {
            "name": "family",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Exact canonical model-family ID; it groups related deployment artifacts without merging checkpoint identities."
          },
          {
            "name": "model",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Exact canonical_model_id to which the artifact is linked."
          },
          {
            "name": "source_model_id",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Exact model or artifact identifier used by the collecting source."
          },
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Case-insensitive substring of the source artifact identifier."
          },
          {
            "name": "execution_mode",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "local",
                "cloud"
              ]
            },
            "description": "Restrict artifacts to local or cloud execution."
          },
          {
            "name": "include_details",
            "in": "query",
            "schema": {
              "type": "boolean"
            },
            "description": "Include full source artifact metadata. Default false; true lowers the maximum limit to 100."
          },
          {
            "name": "include_inactive",
            "in": "query",
            "schema": {
              "type": "boolean"
            },
            "description": "Include previously observed artifacts that are no longer active. Default false."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000,
              "default": 100
            },
            "description": "Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise."
          },
          {
            "name": "offset",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            },
            "description": "Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0."
          }
        ],
        "responses": {
          "200": {
            "description": "Source-linked artifacts; large original metadata is optional.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DistributionResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query"
          },
          "404": {
            "description": "Unknown model"
          }
        },
        "x-document-page": "distributions",
        "tags": [
          "Distributions"
        ]
      }
    },
    "/models/{provider}/{model}/distributions": {
      "get": {
        "operationId": "modelDistributions",
        "summary": "List variants for a canonical model or family",
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Canonical model publisher namespace; URL-encode this path segment."
          },
          {
            "name": "model",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Canonical model name within the publisher namespace. URL-encode nested slashes in this single segment."
          },
          {
            "name": "source",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Registered data-source ID, such as openRouter. This identifies the collecting source, not necessarily the model developer."
          },
          {
            "name": "family",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Exact canonical model-family ID; it groups related deployment artifacts without merging checkpoint identities."
          },
          {
            "name": "model",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Exact canonical_model_id to which the artifact is linked."
          },
          {
            "name": "source_model_id",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Exact model or artifact identifier used by the collecting source."
          },
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Case-insensitive substring of the source artifact identifier."
          },
          {
            "name": "execution_mode",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "local",
                "cloud"
              ]
            },
            "description": "Restrict artifacts to local or cloud execution."
          },
          {
            "name": "include_details",
            "in": "query",
            "schema": {
              "type": "boolean"
            },
            "description": "Include full source artifact metadata. Default false; true lowers the maximum limit to 100."
          },
          {
            "name": "include_inactive",
            "in": "query",
            "schema": {
              "type": "boolean"
            },
            "description": "Include previously observed artifacts that are no longer active. Default false."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000,
              "default": 100
            },
            "description": "Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise."
          },
          {
            "name": "offset",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            },
            "description": "Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0."
          }
        ],
        "responses": {
          "200": {
            "description": "Source-linked artifacts; large original metadata is optional.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DistributionResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query"
          },
          "404": {
            "description": "Unknown model"
          }
        },
        "x-document-page": "distributions",
        "tags": [
          "Distributions"
        ]
      }
    },
    "/distributions/history": {
      "get": {
        "operationId": "distributionHistory",
        "summary": "Read changed artifact metadata and original receipt links",
        "parameters": [
          {
            "name": "source",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "required": true,
            "description": "Registered data-source ID, such as openRouter. This identifies the collecting source, not necessarily the model developer."
          },
          {
            "name": "source_model_id",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "required": true,
            "description": "Exact model or artifact identifier used by the collecting source."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "default": 20
            },
            "description": "Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise."
          },
          {
            "name": "offset",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            },
            "description": "Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0."
          }
        ],
        "responses": {
          "200": {
            "description": "Source-linked artifacts; large original metadata is optional.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true
                      }
                    },
                    "total_count": {
                      "type": "integer"
                    },
                    "limit": {
                      "type": "integer"
                    },
                    "offset": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "data",
                    "total_count",
                    "limit",
                    "offset"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid query"
          },
          "404": {
            "description": "Unknown model"
          }
        },
        "x-document-page": "distributions",
        "tags": [
          "Distributions"
        ]
      }
    },
    "/sources/{source}/metadata/{checksum}": {
      "get": {
        "operationId": "source_original_metadata",
        "summary": "Read published original source metadata",
        "description": "Exact UTF-8 metadata bytes returned as inert JSON, with SHA-256, media type, original URL, retrieval time and base64 body. HTML is returned as source text without execution. Content is visible only after complete receipt publication.",
        "parameters": [
          {
            "name": "source",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Registered data-source ID, such as openRouter. This identifies the collecting source, not necessarily the model developer."
          },
          {
            "name": "checksum",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "SHA-256 checksum identifying the immutable original document. Copy it from source evidence; do not guess it."
          }
        ],
        "responses": {
          "200": {
            "description": "Published original metadata",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "source_id",
                    "checksum_sha256",
                    "source_url",
                    "media_type",
                    "text",
                    "body_base64"
                  ],
                  "properties": {
                    "source_id": {
                      "type": "string"
                    },
                    "checksum_sha256": {
                      "type": "string"
                    },
                    "source_url": {
                      "type": "string"
                    },
                    "media_type": {
                      "type": "string"
                    },
                    "text": {
                      "type": "string"
                    },
                    "body_base64": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid SHA-256"
          },
          "404": {
            "description": "Unknown published original"
          }
        },
        "x-document-page": "evidence",
        "tags": [
          "Evidence"
        ]
      }
    },
    "/models/{provider}/{model}/metrics": {
      "get": {
        "operationId": "model_metrics",
        "summary": "Provider-route operational snapshot with normalized units",
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Canonical model publisher namespace; URL-encode this path segment."
          },
          {
            "name": "model",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Canonical model name within the publisher namespace. URL-encode nested slashes in this single segment."
          }
        ],
        "responses": {
          "200": {
            "description": "Source-backed JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ModelMetricsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query"
          },
          "404": {
            "description": "Unknown model/source"
          },
          "500": {
            "description": "Database unavailable"
          },
          "503": {
            "description": "Service temporarily unavailable"
          }
        },
        "x-document-page": "metrics",
        "tags": [
          "Operational Metrics"
        ]
      }
    },
    "/models/{provider}/{model}/price-history": {
      "get": {
        "operationId": "model_price_history",
        "summary": "Observed listed token quotes from immutable source history",
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Canonical model publisher namespace; URL-encode this path segment."
          },
          {
            "name": "model",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Canonical model name within the publisher namespace. URL-encode nested slashes in this single segment."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000,
              "default": 500
            },
            "description": "Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise."
          },
          {
            "name": "offset",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            },
            "description": "Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0."
          }
        ],
        "responses": {
          "200": {
            "description": "Source-backed JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ModelPriceHistoryResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query"
          },
          "404": {
            "description": "Unknown model/source"
          },
          "500": {
            "description": "Database unavailable"
          },
          "503": {
            "description": "Service temporarily unavailable"
          }
        },
        "x-document-page": "metrics",
        "tags": [
          "Operational Metrics"
        ]
      }
    },
    "/platforms/github-copilot/models": {
      "get": {
        "operationId": "githubCopilotModels",
        "summary": "Structured Copilot access observations, including unresolved identities",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000,
              "default": 500
            },
            "description": "Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise."
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            },
            "description": "Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0."
          }
        ],
        "responses": {
          "200": {
            "description": "Source-backed JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CopilotModelsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query"
          },
          "404": {
            "description": "Unknown model/source"
          },
          "500": {
            "description": "Database unavailable"
          },
          "503": {
            "description": "Service temporarily unavailable"
          }
        },
        "x-document-page": "platforms",
        "tags": [
          "Platform Availability"
        ]
      }
    },
    "/evaluations": {
      "get": {
        "summary": "Complete structured benchmark observations",
        "description": "Includes unlinked observations. Scores preserve original labels, units, comparison board, direction (lower) and derived rank among all reported evaluations. Compare identical boards only. Private data is excluded. Daily snapshot checks retain original exports and provenance. The benchmark directory is available through the same endpoint without scores. OpenRouter Benchmarks includes daily CC BY 4.0 exports with per-dataset snapshot dates, exact version anchors, execution conditions and attribution. Individual runs are evidence; aggregate results have condition-specific ranks. Kaggle Benchmarks synchronizes current public Apache-2.0 benchmark versions, distinguishes Kaggle-maintained and community-published boards, retains task/configuration/agent/harness scope and uncertainty, and exposes unavailable or empty boards as benchmarkMetadata records. Unknown scales and diagnostic costs are retained without quality ranks. Model destinations prefer non-null canonical_model_id (a prepared TensorTrace model page), then the optional model_url preserved from original result or official publisher metadata. With neither, render a plain name. source_url remains the benchmark/export evidence, not a fallback model destination.",
        "operationId": "listEvaluations",
        "parameters": [
          {
            "name": "source",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Registered data-source ID, such as openRouter. This identifies the collecting source, not necessarily the model developer."
          },
          {
            "name": "linked",
            "in": "query",
            "schema": {
              "type": "boolean"
            },
            "description": "true includes only observations linked to canonical models; false includes only unlinked observations. Omit for both."
          },
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Case-insensitive literal substring of the source-reported evaluation model ID."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 24
            },
            "description": "Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise."
          },
          {
            "name": "offset",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            },
            "description": "Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0."
          },
          {
            "name": "canonical_model_id",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Exact TensorTrace canonical model ID; does not invent links for unresolved source records."
          },
          {
            "name": "record_kind",
            "in": "query",
            "required": false,
            "description": "Filter published observation kind, e.g. aggregate or run for OpenRouter Benchmarks. Omit to include all evidence.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "benchmark",
            "in": "query",
            "description": "Case-insensitive substring of the benchmark name; preserves source and version scopes.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "collection",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "kaggleGameArena"
              ]
            },
            "description": "Published Kaggle Game Arena boards, including historical games; does not imply membership in the current pooled rating."
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated evaluation observations",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "total_count"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "source_id",
                          "source_record_id",
                          "canonical_model_id",
                          "receipt_id",
                          "source_model_id",
                          "repository_anchor",
                          "aggregation_scope",
                          "scores",
                          "match_status"
                        ],
                        "properties": {
                          "source_id": {
                            "type": "string"
                          },
                          "source_record_id": {
                            "type": "string"
                          },
                          "canonical_model_id": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "receipt_id": {
                            "type": "string",
                            "format": "uuid"
                          },
                          "updated_at": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "source_model_id": {
                            "type": "string"
                          },
                          "repository_anchor": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "aggregation_scope": {
                            "type": "object",
                            "additionalProperties": true
                          },
                          "match_status": {
                            "type": "string",
                            "enum": [
                              "exactRepository",
                              "exactPublisherId",
                              "exactOpenRouterPermaslug",
                              "unlinked"
                            ],
                            "description": "Exact unambiguous repository anchor, publisher namespace/model ID or OpenRouter permaslug; no fuzzy or moving-alias joins."
                          },
                          "scores": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "required": [
                                "metric",
                                "value",
                                "unit",
                                "dimension",
                                "lower",
                                "board",
                                "rank",
                                "population"
                              ],
                              "properties": {
                                "metric": {
                                  "type": "string"
                                },
                                "unit": {
                                  "type": "string"
                                },
                                "dimension": {
                                  "type": "string"
                                },
                                "board": {
                                  "type": "string"
                                },
                                "value": {
                                  "type": "number"
                                },
                                "lower": {
                                  "type": "boolean"
                                },
                                "rank": {
                                  "type": "integer",
                                  "minimum": 1
                                },
                                "population": {
                                  "type": "integer",
                                  "minimum": 1
                                },
                                "confidence_lower": {
                                  "type": "number",
                                  "description": "Source confidence bound in the normalized metric unit. Confidence level is retained in source evidence when reported."
                                },
                                "confidence_upper": {
                                  "type": "number",
                                  "description": "Source confidence bound in the normalized metric unit. Confidence level is retained in source evidence when reported."
                                },
                                "evaluated_at": {
                                  "type": "string",
                                  "format": "date-time",
                                  "description": "Per-task evaluation timestamp when reported by the source."
                                }
                              }
                            }
                          },
                          "source_url": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "artifact_checksum": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "source_fields": {
                            "type": "object",
                            "additionalProperties": true,
                            "description": "Original source fields or lossless references into the preserved artifact. Large performance arrays remain in the original CSV."
                          },
                          "openrouter_permaslug": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Exact evaluated OpenRouter version, including any route qualifier."
                          },
                          "model_url": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "format": "uri",
                            "description": "Model URL preserved from the original result or official publisher metadata. Use only when canonical_model_id is null; no URL means plain text."
                          }
                        }
                      }
                    },
                    "total_count": {
                      "type": "integer",
                      "minimum": 0
                    }
                  }
                }
              }
            }
          }
        },
        "x-document-page": "evaluations",
        "tags": [
          "Evaluations"
        ]
      }
    },
    "/sources/{source}/artifacts/{checksum}": {
      "get": {
        "summary": "Immutable original benchmark export",
        "operationId": "getBenchmarkArtifact",
        "parameters": [
          {
            "name": "source",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Registered data-source ID, such as openRouter. This identifies the collecting source, not necessarily the model developer."
          },
          {
            "name": "checksum",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "SHA-256 checksum identifying the immutable original document. Copy it from source evidence; do not guess it."
          }
        ],
        "responses": {
          "200": {
            "description": "Original decoded UTF-8 export bytes, verified by SHA-256",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "description": "Artifact is not linked to this source"
          }
        },
        "x-document-page": "evidence",
        "tags": [
          "Evidence"
        ]
      }
    },
    "/insights": {
      "get": {
        "operationId": "getInsights",
        "tags": [
          "Benchmarks"
        ],
        "summary": "Curated source-native chart cohorts",
        "description": "Latest stored receipt per source. Eleven Arena overall task cohorts (top 12 each), BFCL overall (up to 500), and SWE-bench Verified systems (top 12). Includes unmatched source models. Percent scores and bounds use 0–100 units; Arena net improvement can be negative. Counts cover the complete scored cohort before response truncation. Publication and retrieval dates are distinct; missing publication dates are null. Uses existing scheduled source refreshes. No cross-source composite score, historical series, or Arena task-cost data is implied. Model destinations prefer non-null canonical_model_id (a prepared TensorTrace model page), then the optional model_url preserved from original result or official publisher metadata. With neither, render a plain name. source_url remains the benchmark/export evidence, not a fallback model destination.",
        "responses": {
          "200": {
            "description": "Source-native chart data; empty boards remain explicit.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InsightsResponse"
                }
              }
            }
          }
        },
        "x-document-page": "benchmarks"
      }
    },
    "/providers/status": {
      "get": {
        "operationId": "providerStatuses",
        "summary": "Current official status for all reviewed serving platforms",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Official provider status response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "as_of",
                    "measurement",
                    "model_endpoint_health"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/ProviderStatus"
                      }
                    },
                    "as_of": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "measurement": {
                      "type": "string"
                    },
                    "model_endpoint_health": {
                      "type": "boolean",
                      "const": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid query"
          },
          "404": {
            "description": "Unknown provider or expired evidence"
          }
        },
        "x-document-page": "providers",
        "tags": [
          "Inference Providers"
        ]
      }
    },
    "/providers/{provider}/status": {
      "get": {
        "operationId": "providerStatus",
        "summary": "Current scoped provider status",
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Registered inference-provider/source ID, such as openRouter."
          }
        ],
        "responses": {
          "200": {
            "description": "Official provider status response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProviderStatus"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query"
          },
          "404": {
            "description": "Unknown provider or expired evidence"
          }
        },
        "x-document-page": "providers",
        "tags": [
          "Inference Providers"
        ]
      }
    },
    "/providers/{provider}/status/history": {
      "get": {
        "operationId": "providerStatusHistory",
        "summary": "Seven-day check history; not a measured uptime percentage",
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Registered inference-provider/source ID, such as openRouter."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            },
            "description": "Number of check observations to return. Default 20; values outside 1–100 return 400."
          },
          {
            "name": "before",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1
            },
            "description": "Exclusive observation ID cursor returned by the status history. Must be a positive integer."
          }
        ],
        "responses": {
          "200": {
            "description": "Official provider status response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "next_before": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "retention_days": {
                      "type": "integer"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid query"
          },
          "404": {
            "description": "Unknown provider or expired evidence"
          }
        },
        "x-document-page": "providers",
        "tags": [
          "Inference Providers"
        ]
      }
    },
    "/providers/{provider}/status/evidence/{checksum}": {
      "get": {
        "operationId": "providerStatusEvidence",
        "summary": "Original upstream JSON bytes, SHA-256 verified; AWS uses BOM-declared UTF-16",
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Registered inference-provider/source ID, such as openRouter."
          },
          {
            "name": "checksum",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[a-fA-F0-9]{64}$"
            },
            "description": "Registered inference-provider/source ID, such as openRouter."
          }
        ],
        "responses": {
          "200": {
            "description": "Official provider status response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "400": {
            "description": "Invalid query"
          },
          "404": {
            "description": "Unknown provider or expired evidence"
          }
        },
        "x-document-page": "providers",
        "tags": [
          "Inference Providers"
        ]
      }
    },
    "/developers": {
      "get": {
        "operationId": "catalogDevelopers",
        "summary": "List model developers",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Case-insensitive search text. Omit it to browse the complete matching catalog."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 48
            },
            "description": "Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise."
          },
          {
            "name": "offset",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            },
            "description": "Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0."
          }
        ],
        "responses": {
          "200": {
            "description": "Incrementally prepared local data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DirectoryPage"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not present in the prepared catalog",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Catalog preparation has not completed yet",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "x-document-page": "developers",
        "tags": [
          "Model Developers"
        ]
      }
    },
    "/developers/{id}": {
      "get": {
        "operationId": "catalogDevelopersDetail",
        "summary": "Read a model developer",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Canonical developer organization ID."
          }
        ],
        "responses": {
          "200": {
            "description": "Incrementally prepared local data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Organization"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not present in the prepared catalog",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Catalog preparation has not completed yet",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "x-document-page": "developers",
        "tags": [
          "Model Developers"
        ]
      }
    },
    "/developers/{id}/models": {
      "get": {
        "operationId": "catalogDevelopersModels",
        "summary": "List a developer’s models",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Canonical developer organization ID."
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Case-insensitive search text. Omit it to browse the complete matching catalog."
          },
          {
            "name": "query",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Alternative spelling of q; when both are supplied, query takes precedence."
          },
          {
            "name": "provider",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Model publisher namespace. For serving-platform filters, use inference_provider instead."
          },
          {
            "name": "source",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Registered data-source ID, such as openRouter. This identifies the collecting source, not necessarily the model developer."
          },
          {
            "name": "price",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Pricing class: all, free or paid. Uses comparable basic token prices; an unknown price is not free."
          },
          {
            "name": "capability",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Comma-separated capability identifiers; all must match."
          },
          {
            "name": "input_modality",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Match an input modality, such as text, image, audio or video. Obtain current values from /facets/models."
          },
          {
            "name": "model_type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 64
            },
            "description": "Match a displayed model classification, including secondary types. Use multimodal for MLLM, vlm for image-only VLM, llm for text LLM, or another model type ID from a classification link. unknown selects models without reported classification evidence. Omit or use all for no type filter. Combines with other discovery filters before pagination and counts; an unrecognized ID returns an empty result."
          },
          {
            "name": "output_modalities",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Comma-separated output modalities; matches models with any listed output modality. all disables this filter."
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "intelligence"
            },
            "description": "Defaults to Intelligence Index descending; unscored models follow using capability, rating and name as deterministic fallbacks. Price sorts use the card-selected USD Input then Output rates, with missing rates last; cache rates do not participate. Tied basic offerings prefer the model developer. Provider-scoped sorts apply the same policy within that source's quotes."
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 48
            },
            "description": "Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise."
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            },
            "description": "Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0."
          },
          {
            "name": "identity_kind",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "model",
                "family"
              ]
            },
            "description": "Restrict identities to a concrete model or a model family; omit to include both."
          },
          {
            "name": "developer",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Canonical developer ID; groups reviewed publisher aliases."
          },
          {
            "name": "inference_provider",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Registered inference source ID; selects current source offerings, including price-only records. Adds source-scoped provider_prices; other model fields retain canonical scope."
          }
        ],
        "responses": {
          "200": {
            "description": "Incrementally prepared local data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ModelPage"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not present in the prepared catalog",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Catalog preparation has not completed yet",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "x-document-page": "developers",
        "tags": [
          "Model Developers"
        ]
      }
    },
    "/providers": {
      "get": {
        "operationId": "catalogProviders",
        "summary": "List inference providers",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Case-insensitive search text. Omit it to browse the complete matching catalog."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 48
            },
            "description": "Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise."
          },
          {
            "name": "offset",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            },
            "description": "Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0."
          }
        ],
        "responses": {
          "200": {
            "description": "Incrementally prepared local data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DirectoryPage"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not present in the prepared catalog",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Catalog preparation has not completed yet",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "x-document-page": "providers",
        "tags": [
          "Inference Providers"
        ]
      }
    },
    "/providers/{provider}": {
      "get": {
        "operationId": "catalogProvidersDetail",
        "summary": "Read an inference provider",
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Registered inference-provider/source ID, such as openRouter."
          }
        ],
        "responses": {
          "200": {
            "description": "Incrementally prepared local data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Organization"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not present in the prepared catalog",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Catalog preparation has not completed yet",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "x-document-page": "providers",
        "tags": [
          "Inference Providers"
        ]
      }
    },
    "/providers/{provider}/catalog": {
      "get": {
        "operationId": "catalogProvidersModels",
        "summary": "List a provider’s canonical models",
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Registered inference-provider/source ID, such as openRouter."
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Case-insensitive search text. Omit it to browse the complete matching catalog."
          },
          {
            "name": "query",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Alternative spelling of q; when both are supplied, query takes precedence."
          },
          {
            "name": "provider",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Model publisher namespace. For serving-platform filters, use inference_provider instead."
          },
          {
            "name": "source",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Registered data-source ID, such as openRouter. This identifies the collecting source, not necessarily the model developer."
          },
          {
            "name": "price",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Pricing class: all, free or paid. Uses comparable basic token prices; an unknown price is not free."
          },
          {
            "name": "capability",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Comma-separated capability identifiers; all must match."
          },
          {
            "name": "input_modality",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Match an input modality, such as text, image, audio or video. Obtain current values from /facets/models."
          },
          {
            "name": "model_type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 64
            },
            "description": "Match a displayed model classification, including secondary types. Use multimodal for MLLM, vlm for image-only VLM, llm for text LLM, or another model type ID from a classification link. unknown selects models without reported classification evidence. Omit or use all for no type filter. Combines with other discovery filters before pagination and counts; an unrecognized ID returns an empty result."
          },
          {
            "name": "output_modalities",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Comma-separated output modalities; matches models with any listed output modality. all disables this filter."
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "intelligence"
            },
            "description": "Defaults to Intelligence Index descending; unscored models follow using capability, rating and name as deterministic fallbacks. Price sorts use the card-selected USD Input then Output rates, with missing rates last; cache rates do not participate. Tied basic offerings prefer the model developer. Provider-scoped sorts apply the same policy within that source's quotes."
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 48
            },
            "description": "Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise."
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            },
            "description": "Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0."
          },
          {
            "name": "identity_kind",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "model",
                "family"
              ]
            },
            "description": "Restrict identities to a concrete model or a model family; omit to include both."
          },
          {
            "name": "developer",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Canonical developer ID; groups reviewed publisher aliases."
          },
          {
            "name": "inference_provider",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Registered inference source ID; selects current source offerings, including price-only records. Adds source-scoped provider_prices; other model fields retain canonical scope."
          }
        ],
        "responses": {
          "200": {
            "description": "Incrementally prepared local data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ModelPage"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not present in the prepared catalog",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Catalog preparation has not completed yet",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "x-document-page": "providers",
        "tags": [
          "Inference Providers"
        ]
      }
    },
    "/facets/models": {
      "get": {
        "operationId": "catalogModelFacets",
        "summary": "Read model filters",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Incrementally prepared local data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CatalogFacets"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not present in the prepared catalog",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Catalog preparation has not completed yet",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "x-document-page": "facets",
        "tags": [
          "Facets"
        ]
      }
    },
    "/facets/leaderboards": {
      "get": {
        "operationId": "leaderboardsFacets",
        "summary": "Only the controls needed by the leaderboards view",
        "responses": {
          "200": {
            "description": "Source-backed controls, public cache up to 60 seconds",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "leaderboards"
                  ],
                  "properties": {
                    "leaderboards": {
                      "$ref": "#/components/schemas/LeaderboardFacetsDto"
                    }
                  }
                }
              }
            }
          }
        },
        "x-document-page": "facets",
        "tags": [
          "Facets"
        ]
      }
    },
    "/auth/providers": {
      "get": {
        "operationId": "getAuthProviders",
        "tags": [
          "Authentication"
        ],
        "summary": "List supported sign-in methods and configuration availability",
        "security": [],
        "responses": {
          "200": {
            "description": "Private, no-store response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "enabled": {
                      "type": "boolean"
                    },
                    "email_enabled": {
                      "type": "boolean"
                    },
                    "providers": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "enabled": {
                            "type": "boolean"
                          },
                          "status": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input, expired or consumed token"
          },
          "401": {
            "description": "Sign-in required or incorrect credentials"
          },
          "403": {
            "description": "Origin/CSRF failure or username confirmation required"
          },
          "404": {
            "description": "Resource not found"
          },
          "409": {
            "description": "Username or identity conflict"
          },
          "429": {
            "description": "Rate limited; retry later"
          },
          "503": {
            "description": "Account feature or provider/mail configuration unavailable"
          }
        },
        "x-document-page": "authentication"
      }
    },
    "/auth/session": {
      "get": {
        "operationId": "getAuthSession",
        "tags": [
          "Authentication"
        ],
        "summary": "Read or create an anonymous session and CSRF token",
        "security": [],
        "responses": {
          "200": {
            "description": "Private, no-store response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountSession"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input, expired or consumed token"
          },
          "401": {
            "description": "Sign-in required or incorrect credentials"
          },
          "403": {
            "description": "Origin/CSRF failure or username confirmation required"
          },
          "404": {
            "description": "Resource not found"
          },
          "409": {
            "description": "Username or identity conflict"
          },
          "429": {
            "description": "Rate limited; retry later"
          },
          "503": {
            "description": "Account feature or provider/mail configuration unavailable"
          }
        },
        "x-document-page": "authentication"
      }
    },
    "/auth/register": {
      "post": {
        "operationId": "postAuthRegister",
        "tags": [
          "Authentication"
        ],
        "summary": "Request email verification",
        "security": [
          {
            "AccountCookie": [],
            "AccountCSRF": []
          }
        ],
        "responses": {
          "200": {
            "description": "Private, no-store response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input, expired or consumed token"
          },
          "401": {
            "description": "Sign-in required or incorrect credentials"
          },
          "403": {
            "description": "Origin/CSRF failure or username confirmation required"
          },
          "404": {
            "description": "Resource not found"
          },
          "409": {
            "description": "Username or identity conflict"
          },
          "429": {
            "description": "Rate limited; retry later"
          },
          "503": {
            "description": "Account feature or provider/mail configuration unavailable"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "email": {
                    "type": "string",
                    "format": "email",
                    "description": "Email address used for verification, sign-in or password recovery."
                  },
                  "password": {
                    "type": "string",
                    "minLength": 10,
                    "maxLength": 128,
                    "description": "Account password, 10–128 Unicode scalar values. Required when completing a password reset."
                  }
                },
                "required": [
                  "email",
                  "password"
                ]
              }
            }
          }
        },
        "x-document-page": "authentication"
      }
    },
    "/auth/login": {
      "post": {
        "operationId": "postAuthLogin",
        "tags": [
          "Authentication"
        ],
        "summary": "Sign in with verified email and password",
        "security": [
          {
            "AccountCookie": [],
            "AccountCSRF": []
          }
        ],
        "responses": {
          "200": {
            "description": "Private, no-store response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountSession"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input, expired or consumed token"
          },
          "401": {
            "description": "Sign-in required or incorrect credentials"
          },
          "403": {
            "description": "Origin/CSRF failure or username confirmation required"
          },
          "404": {
            "description": "Resource not found"
          },
          "409": {
            "description": "Username or identity conflict"
          },
          "429": {
            "description": "Rate limited; retry later"
          },
          "503": {
            "description": "Account feature or provider/mail configuration unavailable"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "email": {
                    "type": "string",
                    "format": "email",
                    "description": "Email address used for verification, sign-in or password recovery."
                  },
                  "password": {
                    "type": "string",
                    "minLength": 10,
                    "maxLength": 128,
                    "description": "Account password, 10–128 Unicode scalar values. Required when completing a password reset."
                  }
                },
                "required": [
                  "email",
                  "password"
                ]
              }
            }
          }
        },
        "x-document-page": "authentication"
      }
    },
    "/auth/forgot-password": {
      "post": {
        "operationId": "postAuthForgotPassword",
        "tags": [
          "Authentication"
        ],
        "summary": "Send an enumeration-safe password reset email",
        "security": [
          {
            "AccountCookie": [],
            "AccountCSRF": []
          }
        ],
        "responses": {
          "200": {
            "description": "Private, no-store response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input, expired or consumed token"
          },
          "401": {
            "description": "Sign-in required or incorrect credentials"
          },
          "403": {
            "description": "Origin/CSRF failure or username confirmation required"
          },
          "404": {
            "description": "Resource not found"
          },
          "409": {
            "description": "Username or identity conflict"
          },
          "429": {
            "description": "Rate limited; retry later"
          },
          "503": {
            "description": "Account feature or provider/mail configuration unavailable"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "email": {
                    "type": "string",
                    "format": "email",
                    "description": "Email address used for verification, sign-in or password recovery."
                  }
                },
                "required": [
                  "email"
                ]
              }
            }
          }
        },
        "x-document-page": "authentication"
      }
    },
    "/auth/email/complete": {
      "post": {
        "operationId": "postAuthEmailComplete",
        "tags": [
          "Authentication"
        ],
        "summary": "Consume verification or reset token; reset revokes existing sessions",
        "security": [
          {
            "AccountCookie": [],
            "AccountCSRF": []
          }
        ],
        "responses": {
          "200": {
            "description": "Private, no-store response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountSession"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input, expired or consumed token"
          },
          "401": {
            "description": "Sign-in required or incorrect credentials"
          },
          "403": {
            "description": "Origin/CSRF failure or username confirmation required"
          },
          "404": {
            "description": "Resource not found"
          },
          "409": {
            "description": "Username or identity conflict"
          },
          "429": {
            "description": "Rate limited; retry later"
          },
          "503": {
            "description": "Account feature or provider/mail configuration unavailable"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "token": {
                    "type": "string",
                    "description": "One-time email verification or password reset token from the email link."
                  },
                  "password": {
                    "type": "string",
                    "minLength": 10,
                    "maxLength": 128,
                    "description": "Account password, 10–128 Unicode scalar values. Required when completing a password reset."
                  }
                },
                "required": [
                  "token"
                ]
              }
            }
          }
        },
        "x-document-page": "authentication"
      }
    },
    "/auth/logout": {
      "post": {
        "operationId": "postAuthLogout",
        "tags": [
          "Authentication"
        ],
        "summary": "Revoke the current session and create an anonymous session",
        "security": [
          {
            "AccountCookie": [],
            "AccountCSRF": []
          }
        ],
        "responses": {
          "200": {
            "description": "Private, no-store response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountSession"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input, expired or consumed token"
          },
          "401": {
            "description": "Sign-in required or incorrect credentials"
          },
          "403": {
            "description": "Origin/CSRF failure or username confirmation required"
          },
          "404": {
            "description": "Resource not found"
          },
          "409": {
            "description": "Username or identity conflict"
          },
          "429": {
            "description": "Rate limited; retry later"
          },
          "503": {
            "description": "Account feature or provider/mail configuration unavailable"
          }
        },
        "x-document-page": "authentication"
      }
    },
    "/auth/oauth/{provider}/start": {
      "post": {
        "operationId": "postAuthOauthProviderStart",
        "tags": [
          "Authentication"
        ],
        "summary": "Start browser-bound authorization; link=true requires a signed-in account",
        "security": [
          {
            "AccountCookie": [],
            "AccountCSRF": []
          }
        ],
        "responses": {
          "200": {
            "description": "Private, no-store response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input, expired or consumed token"
          },
          "401": {
            "description": "Sign-in required or incorrect credentials"
          },
          "403": {
            "description": "Origin/CSRF failure or username confirmation required"
          },
          "404": {
            "description": "Resource not found"
          },
          "409": {
            "description": "Username or identity conflict"
          },
          "429": {
            "description": "Rate limited; retry later"
          },
          "503": {
            "description": "Account feature or provider/mail configuration unavailable"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "link": {
                    "type": "boolean",
                    "default": false,
                    "description": "false starts sign-in; true links the identity provider to the current signed-in account."
                  }
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Identity-provider ID from GET /auth/providers. Only configured providers can start sign-in."
          }
        ],
        "x-document-page": "authentication"
      }
    },
    "/auth/oauth/{provider}/callback": {
      "get": {
        "operationId": "getAuthOauthProviderCallback",
        "tags": [
          "Authentication"
        ],
        "summary": "Consume one-time OAuth transaction and redirect; POST is Apple form_post only",
        "security": [],
        "responses": {
          "400": {
            "description": "Invalid input, expired or consumed token"
          },
          "401": {
            "description": "Sign-in required or incorrect credentials"
          },
          "403": {
            "description": "Origin/CSRF failure or username confirmation required"
          },
          "404": {
            "description": "Resource not found"
          },
          "409": {
            "description": "Username or identity conflict"
          },
          "429": {
            "description": "Rate limited; retry later"
          },
          "503": {
            "description": "Account feature or provider/mail configuration unavailable"
          },
          "303": {
            "description": "Redirect to dashboard or sign-in error page. Requires the browser-bound OAuth transaction cookie."
          }
        },
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Identity-provider ID from GET /auth/providers. Only configured providers can start sign-in."
          },
          {
            "name": "state",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "One-time, browser-bound OAuth state returned by the identity provider. Managed by the redirect flow."
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Temporary authorization code returned by the identity provider; exchanged by the server."
          },
          {
            "name": "error",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "OAuth failure code returned by the identity provider instead of an authorization code."
          }
        ],
        "x-document-page": "authentication"
      },
      "post": {
        "operationId": "postAuthOauthProviderCallback",
        "tags": [
          "Authentication"
        ],
        "summary": "Consume one-time OAuth transaction and redirect; POST is Apple form_post only",
        "security": [],
        "responses": {
          "400": {
            "description": "Invalid input, expired or consumed token"
          },
          "401": {
            "description": "Sign-in required or incorrect credentials"
          },
          "403": {
            "description": "Origin/CSRF failure or username confirmation required"
          },
          "404": {
            "description": "Resource not found"
          },
          "409": {
            "description": "Username or identity conflict"
          },
          "429": {
            "description": "Rate limited; retry later"
          },
          "503": {
            "description": "Account feature or provider/mail configuration unavailable"
          },
          "303": {
            "description": "Redirect to dashboard or sign-in error page. Requires the browser-bound OAuth transaction cookie."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "state": {
                    "type": "string",
                    "description": "One-time, browser-bound OAuth state returned by the identity provider. Managed by the redirect flow."
                  },
                  "code": {
                    "type": "string",
                    "description": "Temporary authorization code returned by the identity provider; exchanged by the server."
                  },
                  "error": {
                    "type": "string",
                    "description": "OAuth failure code returned by the identity provider instead of an authorization code."
                  },
                  "user": {
                    "type": "string",
                    "description": "Apple’s JSON-encoded first-consent user profile, when supplied by Apple."
                  }
                },
                "required": [
                  "state"
                ]
              }
            }
          }
        },
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Identity-provider ID from GET /auth/providers. Only configured providers can start sign-in."
          }
        ],
        "x-document-page": "authentication"
      }
    },
    "/account": {
      "get": {
        "operationId": "getAccount",
        "tags": [
          "Users"
        ],
        "summary": "Read private profile and linked provider names",
        "security": [
          {
            "AccountCookie": []
          }
        ],
        "responses": {
          "200": {
            "description": "Private, no-store response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Account"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input, expired or consumed token"
          },
          "401": {
            "description": "Sign-in required or incorrect credentials"
          },
          "403": {
            "description": "Origin/CSRF failure or username confirmation required"
          },
          "404": {
            "description": "Resource not found"
          },
          "409": {
            "description": "Username or identity conflict"
          },
          "429": {
            "description": "Rate limited; retry later"
          },
          "503": {
            "description": "Account feature or provider/mail configuration unavailable"
          }
        },
        "x-document-page": "users"
      },
      "patch": {
        "operationId": "patchAccount",
        "tags": [
          "Users"
        ],
        "summary": "Change/confirm globally unique username and profile",
        "security": [
          {
            "AccountCookie": [],
            "AccountCSRF": []
          }
        ],
        "responses": {
          "200": {
            "description": "Private, no-store response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Account"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input, expired or consumed token"
          },
          "401": {
            "description": "Sign-in required or incorrect credentials"
          },
          "403": {
            "description": "Origin/CSRF failure or username confirmation required"
          },
          "404": {
            "description": "Resource not found"
          },
          "409": {
            "description": "Username or identity conflict"
          },
          "429": {
            "description": "Rate limited; retry later"
          },
          "503": {
            "description": "Account feature or provider/mail configuration unavailable"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProfileUpdate"
              }
            }
          }
        },
        "x-document-page": "users"
      }
    },
    "/account/avatar": {
      "put": {
        "operationId": "putAccountAvatar",
        "tags": [
          "Users"
        ],
        "summary": "Decode, crop and re-encode PNG/JPEG/WebP avatar (512 KiB maximum; 2048 px input bound)",
        "security": [
          {
            "AccountCookie": [],
            "AccountCSRF": []
          }
        ],
        "responses": {
          "200": {
            "description": "Private, no-store response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Account"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input, expired or consumed token"
          },
          "401": {
            "description": "Sign-in required or incorrect credentials"
          },
          "403": {
            "description": "Origin/CSRF failure or username confirmation required"
          },
          "404": {
            "description": "Resource not found"
          },
          "409": {
            "description": "Username or identity conflict"
          },
          "429": {
            "description": "Rate limited; retry later"
          },
          "503": {
            "description": "Account feature or provider/mail configuration unavailable"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/octet-stream": {
              "schema": {
                "type": "string",
                "format": "binary"
              }
            }
          }
        },
        "x-document-page": "users"
      },
      "delete": {
        "operationId": "deleteAccountAvatar",
        "tags": [
          "Users"
        ],
        "summary": "Remove uploaded avatar and use account fallback",
        "security": [
          {
            "AccountCookie": [],
            "AccountCSRF": []
          }
        ],
        "responses": {
          "200": {
            "description": "Private, no-store response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Account"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input, expired or consumed token"
          },
          "401": {
            "description": "Sign-in required or incorrect credentials"
          },
          "403": {
            "description": "Origin/CSRF failure or username confirmation required"
          },
          "404": {
            "description": "Resource not found"
          },
          "409": {
            "description": "Username or identity conflict"
          },
          "429": {
            "description": "Rate limited; retry later"
          },
          "503": {
            "description": "Account feature or provider/mail configuration unavailable"
          }
        },
        "x-document-page": "users"
      }
    },
    "/account/favorites": {
      "get": {
        "operationId": "getAccountFavorites",
        "tags": [
          "Favorites"
        ],
        "summary": "List up to 48 saved model cards",
        "security": [
          {
            "AccountCookie": []
          }
        ],
        "responses": {
          "200": {
            "description": "Private, no-store response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "next_cursor": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input, expired or consumed token"
          },
          "401": {
            "description": "Sign-in required or incorrect credentials"
          },
          "403": {
            "description": "Origin/CSRF failure or username confirmation required"
          },
          "404": {
            "description": "Resource not found"
          },
          "409": {
            "description": "Username or identity conflict"
          },
          "429": {
            "description": "Rate limited; retry later"
          },
          "503": {
            "description": "Account feature or provider/mail configuration unavailable"
          }
        },
        "parameters": [
          {
            "name": "after",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Exclusive canonical model ID cursor from the preceding favorites page’s next_cursor. Omit for the first page."
          }
        ],
        "x-document-page": "favorites"
      },
      "put": {
        "operationId": "putAccountFavorites",
        "tags": [
          "Favorites"
        ],
        "summary": "Save or remove a canonical model favorite",
        "security": [
          {
            "AccountCookie": [],
            "AccountCSRF": []
          }
        ],
        "responses": {
          "200": {
            "description": "Private, no-store response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "model_id": {
                      "type": "string"
                    },
                    "favorite": {
                      "type": "boolean"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input, expired or consumed token"
          },
          "401": {
            "description": "Sign-in required or incorrect credentials"
          },
          "403": {
            "description": "Origin/CSRF failure or username confirmation required"
          },
          "404": {
            "description": "Resource not found"
          },
          "409": {
            "description": "Username or identity conflict"
          },
          "429": {
            "description": "Rate limited; retry later"
          },
          "503": {
            "description": "Account feature or provider/mail configuration unavailable"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model_id": {
                    "type": "string",
                    "maxLength": 512,
                    "description": "Canonical model ID, or an unambiguous model alias resolved by the server."
                  }
                },
                "required": [
                  "model_id"
                ]
              }
            }
          }
        },
        "x-document-page": "favorites"
      },
      "delete": {
        "operationId": "deleteAccountFavorites",
        "tags": [
          "Favorites"
        ],
        "summary": "Save or remove a canonical model favorite",
        "security": [
          {
            "AccountCookie": [],
            "AccountCSRF": []
          }
        ],
        "responses": {
          "200": {
            "description": "Private, no-store response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "model_id": {
                      "type": "string"
                    },
                    "favorite": {
                      "type": "boolean"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input, expired or consumed token"
          },
          "401": {
            "description": "Sign-in required or incorrect credentials"
          },
          "403": {
            "description": "Origin/CSRF failure or username confirmation required"
          },
          "404": {
            "description": "Resource not found"
          },
          "409": {
            "description": "Username or identity conflict"
          },
          "429": {
            "description": "Rate limited; retry later"
          },
          "503": {
            "description": "Account feature or provider/mail configuration unavailable"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model_id": {
                    "type": "string",
                    "maxLength": 512,
                    "description": "Canonical model ID, or an unambiguous model alias resolved by the server."
                  }
                },
                "required": [
                  "model_id"
                ]
              }
            }
          }
        },
        "x-document-page": "favorites"
      }
    },
    "/account/favorites/status": {
      "post": {
        "operationId": "postAccountFavoritesStatus",
        "tags": [
          "Favorites"
        ],
        "summary": "Read favorite state for up to 100 canonical IDs",
        "security": [
          {
            "AccountCookie": [],
            "AccountCSRF": []
          }
        ],
        "responses": {
          "200": {
            "description": "Private, no-store response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "model_ids": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input, expired or consumed token"
          },
          "401": {
            "description": "Sign-in required or incorrect credentials"
          },
          "403": {
            "description": "Origin/CSRF failure or username confirmation required"
          },
          "404": {
            "description": "Resource not found"
          },
          "409": {
            "description": "Username or identity conflict"
          },
          "429": {
            "description": "Rate limited; retry later"
          },
          "503": {
            "description": "Account feature or provider/mail configuration unavailable"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model_ids": {
                    "type": "array",
                    "maxItems": 100,
                    "items": {
                      "type": "string",
                      "maxLength": 512
                    },
                    "description": "Canonical model IDs whose favorite state is requested; at most 100 IDs."
                  }
                },
                "required": [
                  "model_ids"
                ]
              }
            }
          }
        },
        "x-document-page": "favorites"
      }
    },
    "/community/comments": {
      "get": {
        "operationId": "getCommunityComments",
        "tags": [
          "Comments"
        ],
        "summary": "World/model/user/topic timeline; 40 rows with stable cursor pagination",
        "security": [],
        "responses": {
          "200": {
            "description": "Private, no-store response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CommentPage"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input, expired or consumed token"
          },
          "401": {
            "description": "Sign-in required or incorrect credentials"
          },
          "403": {
            "description": "Origin/CSRF failure or username confirmation required"
          },
          "404": {
            "description": "Resource not found"
          },
          "409": {
            "description": "Username or identity conflict"
          },
          "429": {
            "description": "Rate limited; retry later"
          },
          "503": {
            "description": "Account feature or provider/mail configuration unavailable"
          }
        },
        "parameters": [
          {
            "name": "model_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Canonical model ID, or an unambiguous model alias resolved by the server."
          },
          {
            "name": "username",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Case-insensitive public username. Usernames are globally unique."
          },
          {
            "name": "topic",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Case-insensitive comment hashtag, without the # prefix."
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Opaque next_cursor from a preceding comments page. Do not construct or decode it; pages contain at most 40 comments."
          }
        ],
        "x-document-page": "comments"
      },
      "post": {
        "operationId": "postCommunityComments",
        "tags": [
          "Comments"
        ],
        "summary": "Publish a model comment with resolved mentions/topics/tickers/model references",
        "security": [
          {
            "AccountCookie": [],
            "AccountCSRF": []
          }
        ],
        "responses": {
          "200": {
            "description": "Private, no-store response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input, expired or consumed token"
          },
          "401": {
            "description": "Sign-in required or incorrect credentials"
          },
          "403": {
            "description": "Origin/CSRF failure or username confirmation required"
          },
          "404": {
            "description": "Resource not found"
          },
          "409": {
            "description": "Username or identity conflict"
          },
          "429": {
            "description": "Rate limited; retry later"
          },
          "503": {
            "description": "Account feature or provider/mail configuration unavailable"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model_id": {
                    "type": "string",
                    "maxLength": 512,
                    "description": "Canonical model ID, or an unambiguous model alias resolved by the server."
                  },
                  "body": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024,
                    "description": "Unicode scalar values, not UTF-8 bytes. GFM and resolved references."
                  }
                },
                "required": [
                  "model_id",
                  "body"
                ]
              }
            }
          }
        },
        "x-document-page": "comments"
      }
    },
    "/community/comments/{id}": {
      "delete": {
        "operationId": "deleteCommunityCommentsId",
        "tags": [
          "Comments"
        ],
        "summary": "Delete your own comment",
        "security": [
          {
            "AccountCookie": [],
            "AccountCSRF": []
          }
        ],
        "responses": {
          "200": {
            "description": "Private, no-store response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "deleted": {
                      "type": "boolean"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input, expired or consumed token"
          },
          "401": {
            "description": "Sign-in required or incorrect credentials"
          },
          "403": {
            "description": "Origin/CSRF failure or username confirmation required"
          },
          "404": {
            "description": "Resource not found"
          },
          "409": {
            "description": "Username or identity conflict"
          },
          "429": {
            "description": "Rate limited; retry later"
          },
          "503": {
            "description": "Account feature or provider/mail configuration unavailable"
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "description": "UUID of the comment to delete. Only its author can delete it."
          }
        ],
        "x-document-page": "comments"
      }
    },
    "/community/users/{username}": {
      "get": {
        "operationId": "getCommunityUsersUsername",
        "tags": [
          "Users"
        ],
        "summary": "Read public profile (no email or identity subjects)",
        "security": [],
        "responses": {
          "200": {
            "description": "Private, no-store response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicUser"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input, expired or consumed token"
          },
          "401": {
            "description": "Sign-in required or incorrect credentials"
          },
          "403": {
            "description": "Origin/CSRF failure or username confirmation required"
          },
          "404": {
            "description": "Resource not found"
          },
          "409": {
            "description": "Username or identity conflict"
          },
          "429": {
            "description": "Rate limited; retry later"
          },
          "503": {
            "description": "Account feature or provider/mail configuration unavailable"
          }
        },
        "parameters": [
          {
            "name": "username",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Case-insensitive public username. Usernames are globally unique."
          }
        ],
        "x-document-page": "users"
      }
    },
    "/community/users/{id}/avatar": {
      "get": {
        "operationId": "getCommunityUsersIdAvatar",
        "tags": [
          "Users"
        ],
        "summary": "Read re-encoded uploaded avatar",
        "security": [],
        "responses": {
          "200": {
            "description": "Private, no-store response.",
            "content": {
              "image/png": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input, expired or consumed token"
          },
          "401": {
            "description": "Sign-in required or incorrect credentials"
          },
          "403": {
            "description": "Origin/CSRF failure or username confirmation required"
          },
          "404": {
            "description": "Resource not found"
          },
          "409": {
            "description": "Username or identity conflict"
          },
          "429": {
            "description": "Rate limited; retry later"
          },
          "503": {
            "description": "Account feature or provider/mail configuration unavailable"
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "description": "UUID of the public user whose uploaded avatar is requested."
          }
        ],
        "x-document-page": "users"
      }
    },
    "/community/references": {
      "post": {
        "operationId": "postCommunityReferences",
        "tags": [
          "Comments"
        ],
        "summary": "Resolve references for a Markdown preview; unknown users/models remain plain text",
        "security": [
          {
            "AccountCookie": [],
            "AccountCSRF": []
          }
        ],
        "responses": {
          "200": {
            "description": "Private, no-store response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "references": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/CommentReference"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input, expired or consumed token"
          },
          "401": {
            "description": "Sign-in required or incorrect credentials"
          },
          "403": {
            "description": "Origin/CSRF failure or username confirmation required"
          },
          "404": {
            "description": "Resource not found"
          },
          "409": {
            "description": "Username or identity conflict"
          },
          "429": {
            "description": "Rate limited; retry later"
          },
          "503": {
            "description": "Account feature or provider/mail configuration unavailable"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "body": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024,
                    "description": "Comment or preview text in GitHub-flavored Markdown, up to 1024 Unicode scalar values. Resolved @users, #topics, $tickers and %model IDs link to their destinations."
                  }
                },
                "required": [
                  "body"
                ]
              }
            }
          }
        },
        "x-document-page": "comments"
      }
    },
    "/platforms/cursor/models": {
      "get": {
        "operationId": "cursorModels",
        "summary": "Account-dependent Cursor agent model availability",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000,
              "default": 500
            },
            "description": "Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise."
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            },
            "description": "Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0."
          }
        ],
        "responses": {
          "200": {
            "description": "Source-backed JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CursorModelsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query"
          },
          "404": {
            "description": "Unknown model/source"
          },
          "500": {
            "description": "Database unavailable"
          },
          "503": {
            "description": "Service temporarily unavailable"
          }
        },
        "description": "Cursor recommended agent models for the configured account/team only. Includes unmatched observations and routing IDs, with null canonical_model_id. Platform aliases/parameters/variants do not establish model identity, universal access or token prices. Empty before the first authenticated refresh. Updated every six hours when CURSOR_API_KEY is configured.",
        "x-document-page": "platforms",
        "tags": [
          "Platform Availability"
        ]
      }
    },
    "/models/{provider}/{model}/prices": {
      "get": {
        "operationId": "catalogPrices",
        "summary": "Page complete published inference prices for a canonical model",
        "description": "Preserves currency, unit, conditions, source receipt and observation time. Missing price data is an empty list, never a zero price. Query publications may change between requests; use publication_id to fence pagination.",
        "parameters": [
          {
            "name": "provider",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Registered serving-source ID, such as anthropic or openRouter. Omit to include all platforms for this model."
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 50,
              "maximum": 100
            },
            "description": "Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise."
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 0
            },
            "description": "Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0."
          },
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Canonical model publisher namespace; URL-encode this path segment."
          },
          {
            "name": "model",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Canonical model name within the publisher namespace. URL-encode nested slashes in this single segment."
          }
        ],
        "responses": {
          "200": {
            "description": "Incrementally prepared local data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ModelPricePage"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not present in the prepared catalog",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Catalog preparation has not completed yet",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "x-document-page": "prices",
        "tags": [
          "Prices"
        ]
      }
    },
    "/models/{provider}/{model}/sections/{section}": {
      "get": {
        "operationId": "modelSection",
        "summary": "Complete prepared profiles, specifications or external resources; default 20 per page",
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Canonical model publisher namespace; URL-encode this path segment."
          },
          {
            "name": "model",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Canonical model name within the publisher namespace. URL-encode nested slashes in this single segment."
          },
          {
            "name": "section",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "profiles",
                "specifications",
                "resources"
              ]
            },
            "description": "Prepared model section: profiles (platform/generation metadata), specifications (source assertions) or resources (external links)."
          },
          {
            "name": "source",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Exact serving source ID, such as githubCopilot or azureFoundry. Applies to profiles only; other sections reject this filter. Pagination and total_count apply after filtering. Omit to read all platform profiles."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            },
            "description": "Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise."
          },
          {
            "name": "offset",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            },
            "description": "Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0."
          }
        ],
        "responses": {
          "200": {
            "description": "Current local observations",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DetailSectionPage"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request"
          },
          "404": {
            "description": "Unknown model or section"
          }
        },
        "x-document-page": "models",
        "tags": [
          "Models"
        ]
      }
    },
    "/models/{provider}/{model}/evidence": {
      "get": {
        "operationId": "modelEvidence",
        "summary": "Paginated source metadata; original payloads are separate evidence documents",
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Canonical model publisher namespace; URL-encode this path segment."
          },
          {
            "name": "model",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Canonical model name within the publisher namespace. URL-encode nested slashes in this single segment."
          },
          {
            "name": "kind",
            "in": "query",
            "schema": {
              "type": "string",
              "default": "records",
              "enum": [
                "aliases",
                "records",
                "receipts",
                "sources",
                "merges",
                "conflicts"
              ]
            },
            "description": "Evidence collection: records, aliases, receipts, sources, merges or conflicts. Default records."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            },
            "description": "Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise."
          },
          {
            "name": "offset",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            },
            "description": "Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0."
          },
          {
            "name": "source",
            "in": "query",
            "description": "Registered source ID. This filter is accepted only with kind=records.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Current local observations",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DetailSectionPage"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request"
          },
          "404": {
            "description": "Unknown model or section"
          }
        },
        "x-document-page": "evidence",
        "tags": [
          "Evidence"
        ]
      }
    },
    "/evidence/record": {
      "get": {
        "operationId": "originalRecord",
        "summary": "One complete original source observation",
        "parameters": [
          {
            "name": "source",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Registered data-source ID, such as openRouter. This identifies the collecting source, not necessarily the model developer."
          },
          {
            "name": "record",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Exact source_record_id from an evidence index entry. This is a source record key, not a canonical model ID."
          }
        ],
        "responses": {
          "200": {
            "description": "Current local observations",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SourceRecordDto"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request"
          },
          "404": {
            "description": "Unknown model or section"
          }
        },
        "x-document-page": "evidence",
        "tags": [
          "Evidence"
        ]
      }
    },
    "/sync/manifest": {
      "get": {
        "operationId": "offlineCatalogManifest",
        "summary": "Read a dated offline client catalog manifest",
        "description": "Separate client distribution; ordinary API reads remain current. Compare SHA-256 objects and replace changed buckets. The serial worker publishes at most every 15 minutes. Includes all model cards and organizations plus top 100 entries per core ranking; large llmPerf, Kaggle and historical archive observations remain on-demand. Objects publish before the manifest atomically.",
        "parameters": [
          {
            "name": "If-None-Match",
            "in": "header",
            "schema": {
              "type": "string"
            },
            "description": "ETag from the last successfully committed local catalog; permits an empty 304 response."
          }
        ],
        "responses": {
          "200": {
            "description": "Offline schema 1 manifest. Hashes cover compressed gzip bytes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OfflineManifest"
                }
              }
            }
          },
          "304": {
            "description": "Unchanged manifest; empty body."
          },
          "503": {
            "description": "No client distribution published yet."
          }
        },
        "x-document-page": "models"
      }
    },
    "/sync/objects/{hash}": {
      "get": {
        "operationId": "offlineCatalogObject",
        "summary": "Download an immutable compressed catalog bucket",
        "parameters": [
          {
            "name": "hash",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-f]{64}$"
            },
            "description": "Lowercase SHA-256 from the manifest, covering the compressed object bytes."
          }
        ],
        "responses": {
          "200": {
            "description": "SHA-256 addressed gzip JSON array. Models: id, model and selectors (search, types, modalities, membership, price and rank), offers. Boards: normalized ranking fields and entries. Metadata: directories and model facets. Validate byte count, hash and manifest row count before a local transaction. Cache-Control: immutable, one year.",
            "content": {
              "application/gzip": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "404": {
            "description": "Object not found."
          }
        },
        "x-document-page": "models"
      }
    },
    "/news": {
      "get": {
        "operationId": "topicNews",
        "summary": "Read recent AI and machine learning news",
        "description": "Read locally ingested first-party news. AI/model terms are defaults; callers may control language, keywords, operator, page size and either cursor. Feeds omit full text; detail reads expose it. Search includes article bodies and retains shared-URL records.",
        "tags": [
          "News"
        ],
        "x-document-page": "news",
        "parameters": [
          {
            "name": "before",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 2048
            },
            "description": "Older cursor returned by this query, or a timestamp. Filters must match."
          },
          {
            "name": "after",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 2048
            },
            "description": "Newer cursor returned by this query, or a timestamp. Use either before or after."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 10
            },
            "description": "Maximum records in one page."
          },
          {
            "name": "language",
            "in": "query",
            "schema": {
              "type": "string",
              "default": "en",
              "maxLength": 63
            },
            "description": "One language tag; regions are ignored and script variants remain selectable."
          },
          {
            "name": "keywords",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 8192
            },
            "description": "JSON array of at most 16 keyword entries. Words within an entry use AND; [] reads all news. Omit for AI topic/model defaults."
          },
          {
            "name": "operator",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "and",
                "or"
              ],
              "default": "or"
            },
            "description": "How keyword entries combine; no second title/summary relevance filter."
          }
        ],
        "responses": {
          "200": {
            "description": "Current first-party database results; no relay or feed-page cache.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NewsFeed"
                }
              }
            }
          },
          "503": {
            "description": "Database temporarily unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query or cursor filters.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/models/{provider}/{model}/news": {
      "get": {
        "operationId": "modelNews",
        "summary": "Read model and developer news",
        "description": "Read locally ingested first-party news. AI/model terms are defaults; callers may control language, keywords, operator, page size and either cursor. Feeds omit full text; detail reads expose it. Search includes article bodies and retains shared-URL records.",
        "tags": [
          "News"
        ],
        "x-document-page": "news",
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "description": "Canonical model provider segment; aliases resolve to current identity.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "model",
            "in": "path",
            "required": true,
            "description": "Canonical model model segment; aliases resolve to current identity.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "before",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 2048
            },
            "description": "Older cursor returned by this query, or a timestamp. Filters must match."
          },
          {
            "name": "after",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 2048
            },
            "description": "Newer cursor returned by this query, or a timestamp. Use either before or after."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 10
            },
            "description": "Maximum records in one page."
          },
          {
            "name": "language",
            "in": "query",
            "schema": {
              "type": "string",
              "default": "en",
              "maxLength": 63
            },
            "description": "One language tag; regions are ignored and script variants remain selectable."
          },
          {
            "name": "keywords",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 8192
            },
            "description": "JSON array of at most 16 keyword entries. Words within an entry use AND; [] reads all news. Omit for AI topic/model defaults."
          },
          {
            "name": "operator",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "and",
                "or"
              ],
              "default": "or"
            },
            "description": "How keyword entries combine; no second title/summary relevance filter."
          }
        ],
        "responses": {
          "200": {
            "description": "Current first-party database results; no relay or feed-page cache.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NewsFeed"
                }
              }
            }
          },
          "503": {
            "description": "Database temporarily unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Model not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query or cursor filters.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/social-card": {
      "get": {
        "operationId": "socialCard",
        "summary": "Resolve a social sharing image",
        "description": "Choose a canonical model ID or a public section path. With S3 configured, current content and bundled template/font determine an immutable image key. Existing objects are reused across restarts; missing objects are rendered and uploaded before a 302 to the public S3 endpoint. Redirect responses are never cached by browsers or CDNs. Without storage configured, the development fallback serves a PNG directly. X and Facebook use the same 1200 by 630 image. Legacy /social/*.png routes resolve through the same service.",
        "tags": [
          "Overview"
        ],
        "x-document-page": "overview",
        "parameters": [
          {
            "name": "id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Canonical model identifier or resolvable model alias; mutually exclusive with page."
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "/"
            },
            "description": "Public section route such as /, /models or /benchmarks; defaults to the homepage when id is absent."
          }
        ],
        "responses": {
          "302": {
            "description": "Current image is available in public S3 storage. Follow Location to read PNG bytes directly from S3.",
            "headers": {
              "Location": {
                "description": "Public HTTPS URL of the immutable content-addressed PNG. No internal endpoint or credentials.",
                "schema": {
                  "type": "string",
                  "format": "uri"
                }
              },
              "Cache-Control": {
                "description": "no-store; the resolver checks current published data on every request.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "307": {
            "description": "Model alias resolves temporarily to the canonical image API URL."
          },
          "200": {
            "description": "Storage-disabled development fallback: PNG image bytes.",
            "content": {
              "image/png": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "304": {
            "description": "Storage-disabled fallback conditional image hit."
          },
          "400": {
            "description": "Choose id or page, not both."
          },
          "404": {
            "description": "Unknown model or section."
          },
          "503": {
            "description": "Storage could not confirm or upload the image; no redirect to a missing object.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/news/{id}": {
      "get": {
        "operationId": "newsDetail",
        "summary": "Read a complete stored news article",
        "tags": [
          "News"
        ],
        "x-document-page": "news",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1
            },
            "description": "Stored first-party numeric record ID returned by the list."
          },
          {
            "name": "language",
            "in": "query",
            "schema": {
              "type": "string",
              "default": "en",
              "maxLength": 63
            },
            "description": "One language tag; regions are ignored and script variants remain selectable."
          }
        ],
        "responses": {
          "200": {
            "description": "First-party database response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NewsDetail"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request or resource unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Invalid request or resource unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Invalid request or resource unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/papers": {
      "get": {
        "operationId": "researchPapers",
        "summary": "Read source-neutral Research (compatible Papers route)",
        "tags": [
          "News"
        ],
        "x-document-page": "news",
        "parameters": [
          {
            "name": "before",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 2048
            },
            "description": "YYYY-MM-DD boundary or returned opaque cursor bound to this query."
          },
          {
            "name": "after",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 2048
            },
            "description": "YYYY-MM-DD boundary or returned opaque cursor bound to this query."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 10
            },
            "description": "Maximum records in one page."
          },
          {
            "name": "keywords",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 8192
            },
            "description": "JSON array of at most 16 literal entries matched in title and abstract. No full PDF retrieval."
          },
          {
            "name": "operator",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "and",
                "or"
              ],
              "default": "and"
            },
            "description": "How keyword entries combine; no second title/summary relevance filter."
          },
          {
            "name": "category",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "cs.AI",
                "cs.LG",
                "cs.CL",
                "cs.CV",
                "cs.NE",
                "stat.ML"
              ]
            },
            "description": "Filter by one supported arXiv AI/ML category."
          }
        ],
        "responses": {
          "200": {
            "description": "First-party database response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaperPage"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request or resource unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Invalid request or resource unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Invalid request or resource unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/papers/{id}": {
      "get": {
        "operationId": "researchPaperDetail",
        "summary": "Read one stored research paper",
        "tags": [
          "News"
        ],
        "x-document-page": "news",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^(?:[1-9][0-9]*|[0-9a-fA-F]{8}-(?:[0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12})$",
              "example": "550e8400-e29b-41d4-a716-446655440000"
            },
            "description": "Stable Research UUID, or the existing positive numeric ID alias."
          }
        ],
        "responses": {
          "200": {
            "description": "First-party database response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Paper"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request or resource unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Invalid request or resource unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Invalid request or resource unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/search": {
      "get": {
        "operationId": "unifiedSearch",
        "summary": "Search public AI content by keyword",
        "description": "PostgreSQL full-text keyword search over the public read index. Results and counts are grouped by category. No semantic model or remote acquisition runs during a request.",
        "x-document-page": "search",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "description": "Keyword query, trimmed before searching. Blank returns empty groups. Uses case-insensitive simple PostgreSQL web-search syntax: unquoted terms are AND, quoted text is a phrase, OR accepts either alternative, and minus excludes a term.",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 200,
              "default": ""
            },
            "example": "neural"
          },
          {
            "name": "category",
            "in": "query",
            "description": "Return only this category; omit to return all five groups in the documented order.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "models",
                "news",
                "papers",
                "developers",
                "providers"
              ]
            },
            "example": "models"
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum hits per returned category, independently of other groups.",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 18,
              "default": 6
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "Number of ranked hits to skip in each selected category.",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 10000,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Grouped matches from committed public data.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UnifiedSearchResponse"
                },
                "example": {
                  "query": "neural",
                  "total": 1,
                  "groups": [
                    {
                      "category": "models",
                      "total": 1,
                      "offset": 0,
                      "limit": 6,
                      "has_more": false,
                      "items": [
                        {
                          "id": "example/neural-model",
                          "title": "Example: Neural Model",
                          "url": "/models/example/neural-model",
                          "description": "An illustrative model entry for the search contract.",
                          "image_url": null,
                          "subtitle": "Example Labs"
                        }
                      ]
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid query, category or pagination bounds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "A database read could not complete.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "The public database is temporarily busy; retry shortly.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/ecosystem": {
      "get": {
        "operationId": "ecosystemRecords",
        "summary": "Search AI research, datasets, tools, evaluations and model updates",
        "tags": [
          "Ecosystem"
        ],
        "x-document-page": "ecosystem",
        "parameters": [
          {
            "name": "kind",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "paper",
                "review",
                "release",
                "software",
                "dataset",
                "dataset_schema",
                "tool",
                "advisory",
                "artifact",
                "evaluation",
                "incident",
                "statistic",
                "change",
                "entity"
              ]
            },
            "description": "Optional stored-data filter."
          },
          {
            "name": "source",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Optional stored-data filter."
          },
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 200
            },
            "description": "Optional stored-data filter."
          },
          {
            "name": "model",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Exact TensorTrace canonical model relationship."
          },
          {
            "name": "developer",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Prepared developer membership of an exactly linked model."
          },
          {
            "name": "inference_provider",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Prepared serving-provider membership of an exactly linked model."
          },
          {
            "name": "paper",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Exact arXiv work ID, including its recorded DOI relationships."
          },
          {
            "name": "namespace",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Requires external_id. Matches explicit source relationships only."
          },
          {
            "name": "external_id",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Requires namespace. arXiv work lookup includes version-specific evidence."
          },
          {
            "name": "before",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Opaque filter-bound keyset cursor from next_cursor."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 20,
              "default": 20
            },
            "description": "Maximum records returned in one page, at most 20."
          }
        ],
        "responses": {
          "200": {
            "description": "Stored first-party response; never triggers upstream acquisition.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EcosystemPage"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query, missing record, or temporary database error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Invalid query, missing record, or temporary database error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Invalid query, missing record, or temporary database error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/ecosystem/sources": {
      "get": {
        "operationId": "ecosystemSources",
        "summary": "Inspect ecosystem source freshness, access gates and collection scope",
        "tags": [
          "Ecosystem"
        ],
        "x-document-page": "ecosystem",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Stored first-party response; never triggers upstream acquisition.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EcosystemSources"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query, missing record, or temporary database error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Invalid query, missing record, or temporary database error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Invalid query, missing record, or temporary database error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/ecosystem/{id}": {
      "get": {
        "operationId": "ecosystemRecord",
        "summary": "Read a complete normalized ecosystem record",
        "tags": [
          "Ecosystem"
        ],
        "x-document-page": "ecosystem",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "description": "Stable TensorTrace ecosystem record UUID."
          }
        ],
        "responses": {
          "200": {
            "description": "Stored first-party response; never triggers upstream acquisition.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EcosystemRecord"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query, missing record, or temporary database error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Invalid query, missing record, or temporary database error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Invalid query, missing record, or temporary database error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/ecosystem/{id}/history": {
      "get": {
        "operationId": "ecosystemRecordHistory",
        "summary": "Inspect immutable normalized observations and source checksums",
        "tags": [
          "Ecosystem"
        ],
        "x-document-page": "ecosystem",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "description": "Stable TensorTrace ecosystem record UUID."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 20,
              "default": 20
            },
            "description": "Maximum records returned in one page, at most 20."
          },
          {
            "name": "offset",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "description": "Zero-based observation-history row offset."
          }
        ],
        "responses": {
          "200": {
            "description": "Stored first-party response; never triggers upstream acquisition.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EcosystemHistory"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query, missing record, or temporary database error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Invalid query, missing record, or temporary database error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Invalid query, missing record, or temporary database error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/research": {
      "get": {
        "operationId": "researchWorks",
        "summary": "Read source-neutral Research works",
        "tags": [
          "News"
        ],
        "x-document-page": "news",
        "parameters": [
          {
            "name": "before",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 2048
            },
            "description": "YYYY-MM-DD boundary or returned opaque cursor bound to this query."
          },
          {
            "name": "after",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 2048
            },
            "description": "YYYY-MM-DD boundary or returned opaque cursor bound to this query."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 10
            },
            "description": "Maximum records in one page."
          },
          {
            "name": "keywords",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 8192
            },
            "description": "JSON array of at most 16 literal entries matched in title and abstract. No full PDF retrieval."
          },
          {
            "name": "operator",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "and",
                "or"
              ],
              "default": "and"
            },
            "description": "How keyword entries combine; no second title/summary relevance filter."
          },
          {
            "name": "category",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "cs.AI",
                "cs.LG",
                "cs.CL",
                "cs.CV",
                "cs.NE",
                "stat.ML"
              ]
            },
            "description": "Filter by one supported arXiv AI/ML category."
          }
        ],
        "responses": {
          "200": {
            "description": "First-party database response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaperPage"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request or resource unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Invalid request or resource unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Invalid request or resource unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "description": "One work, multiple explicitly linked sources and publication versions. Existing /papers routes and numeric IDs remain compatible aliases."
      }
    },
    "/research/{id}": {
      "get": {
        "operationId": "researchWorkDetail",
        "summary": "Read Research by stable UUID or numeric alias",
        "tags": [
          "News"
        ],
        "x-document-page": "news",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^(?:[1-9][0-9]*|[0-9a-fA-F]{8}-(?:[0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12})$",
              "example": "550e8400-e29b-41d4-a716-446655440000"
            },
            "description": "Stable Research UUID, or the existing positive numeric ID alias."
          }
        ],
        "responses": {
          "200": {
            "description": "First-party database response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Paper"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request or resource unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Invalid request or resource unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Invalid request or resource unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "description": "One work, multiple explicitly linked sources and publication versions. Existing /papers routes and numeric IDs remain compatible aliases."
      }
    },
    "/benchmarks/context": {
      "get": {
        "operationId": "benchmarkContext",
        "summary": "Read report charts and real-world safety context inside Benchmarks",
        "description": "Reviewed Stanford charts, licensed AIID incidents and original AILuminate grades remain separate observations. Unknown denominators prohibit company-risk rankings.",
        "tags": [
          "Benchmarks"
        ],
        "x-document-page": "benchmarks",
        "parameters": [
          {
            "name": "source",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "stanfordAiIndex",
                "aiIncidents",
                "ailuminateResults",
                "mlCommons"
              ]
            },
            "description": "Optional source; mlCommons is an alias for ailuminateResults."
          },
          {
            "name": "kind",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "report_chart",
                "incident",
                "safety_grade"
              ]
            },
            "description": "Optional observation domain; these are not interchangeable model scores."
          },
          {
            "name": "group",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 1000
            },
            "description": "Exact context_id of a reviewed report chart or incident."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 18,
              "default": 12
            },
            "description": "Maximum number of context entries in one page."
          },
          {
            "name": "offset",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 2000000,
              "default": 0
            },
            "description": "Number of matching entries to skip."
          }
        ],
        "responses": {
          "200": {
            "description": "Stored typed context with source/date coverage.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/BenchmarkContext"
                      },
                      "maxItems": 18
                    },
                    "total_count": {
                      "type": "integer",
                      "minimum": 0
                    },
                    "canonical_source": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "summary": {
                      "$ref": "#/components/schemas/BenchmarkContextSummary"
                    }
                  },
                  "additionalProperties": false,
                  "required": [
                    "data",
                    "total_count",
                    "canonical_source",
                    "summary"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid filters or temporarily unavailable database.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Invalid filters or temporarily unavailable database.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/openusd/assets": {
      "get": {
        "operationId": "openUsdAssets",
        "summary": "Search 3D assets",
        "description": "Reads stored USD, GLB and glTF metadata without upstream acquisition. Public data only; source terms and preview fidelity vary by asset.",
        "tags": [
          "3D Assets"
        ],
        "x-document-page": "openusd",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Keywords matched against source-owned names, descriptions, tags, categories, authors, paths and dataset descriptions.",
            "schema": {
              "type": "string",
              "maxLength": 500
            }
          },
          {
            "name": "dataset",
            "in": "query",
            "required": false,
            "description": "Exact HF owner/repository identity.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "required": false,
            "description": "Match the primary format or an explicitly related source representation.",
            "schema": {
              "type": "string",
              "enum": [
                "usd",
                "usda",
                "usdc",
                "usdz",
                "glb",
                "gltf"
              ]
            }
          },
          {
            "name": "preview",
            "in": "query",
            "required": false,
            "description": "Use available for assets with a worker-validated ready thumbnail; all includes assets whose image is missing or still being prepared.",
            "schema": {
              "type": "string",
              "enum": [
                "available",
                "all"
              ],
              "default": "all"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Number of cards per page.",
            "schema": {
              "type": "integer",
              "default": 18,
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based offset in matching cards.",
            "schema": {
              "type": "integer",
              "default": 0,
              "minimum": 0,
              "maximum": 1000000
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Stored OpenUSD result.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "description": "Bounded asset cards, latest source update first.",
                      "items": {
                        "type": "object",
                        "description": "One logical 3D asset. Stable UUID is scoped by dataset and root path; revision changes update the same identity.",
                        "properties": {
                          "id": {
                            "type": "string",
                            "description": "Stable TensorTrace 3D asset UUID.",
                            "format": "uuid"
                          },
                          "title": {
                            "type": "string",
                            "description": "Human-facing source object or package name; official source metadata takes precedence over UID filenames."
                          },
                          "description": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Optional asset description."
                          },
                          "dataset_id": {
                            "type": "string",
                            "description": "Case-preserved Hugging Face owner/repository identity."
                          },
                          "dataset_name": {
                            "type": "string",
                            "description": "Dataset display name."
                          },
                          "publisher": {
                            "type": "string",
                            "description": "Hugging Face namespace; not a verification of authorship."
                          },
                          "path": {
                            "type": "string",
                            "description": "Logical root file within its dataset, excluding separate internal payload cards."
                          },
                          "format": {
                            "type": "string",
                            "description": "Root file format.",
                            "enum": [
                              "usd",
                              "usda",
                              "usdc",
                              "usdz",
                              "glb",
                              "gltf"
                            ]
                          },
                          "byte_size": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "description": "Root file bytes; excludes separately referenced dependencies.",
                            "minimum": 0
                          },
                          "source_thumbnail_url": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Raw upstream image candidate at the pinned source revision. It has not necessarily passed worker validation; clients should display thumbnail_url instead."
                          },
                          "thumbnail_url": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "format": "uri-reference",
                            "description": "Local versioned /api/v1/openusd/assets/{id}/thumbnail?v=... endpoint for the validated normalized WebP. Null until media.status is ready; never a speculative upstream image URL."
                          },
                          "preview": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "description": "A source-manifest or publisher-documented browser representation at the same immutable revision. The original source is preserved.",
                            "properties": {
                              "format": {
                                "type": "string",
                                "enum": [
                                  "glb"
                                ],
                                "description": "Source-manifest browser preview format."
                              },
                              "path": {
                                "type": "string",
                                "description": "Observed GLB path within the source dataset."
                              },
                              "url": {
                                "type": "string",
                                "format": "uri",
                                "description": "Immutable HF resolve URL at the same revision as the indexed USD asset."
                              },
                              "byte_size": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "minimum": 0,
                                "description": "Observed GLB file bytes, when supplied by the source tree."
                              },
                              "source": {
                                "type": "string",
                                "enum": [
                                  "source_manifest",
                                  "publisher_documentation"
                                ],
                                "description": "The source package explicitly declares this alternative; it is not guessed from a filename."
                              },
                              "manifest_path": {
                                "type": "string",
                                "description": "Dataset-relative source manifest declaring the GLB alternative."
                              }
                            },
                            "required": [
                              "format",
                              "path",
                              "url",
                              "byte_size",
                              "source"
                            ]
                          },
                          "media": {
                            "type": "object",
                            "description": "Worker-owned source-image or generated-3D thumbnail status. Public page and image reads never acquire or render upstream content.",
                            "properties": {
                              "status": {
                                "type": "string",
                                "enum": [
                                  "pending",
                                  "ready",
                                  "missing",
                                  "failed",
                                  "unusable"
                                ],
                                "description": "ready has a validated cached poster; pending awaits acquisition or rendering; failed retries later; missing/unusable has no usable image or supported render for the recorded policy."
                              },
                              "width": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "minimum": 1,
                                "description": "Stored normalized thumbnail width in pixels, when ready."
                              },
                              "height": {
                                "type": [
                                  "integer",
                                  "null"
                                ],
                                "minimum": 1,
                                "description": "Stored normalized thumbnail height in pixels, when ready."
                              },
                              "source": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Worker media origin or preparation kind, when one has been recorded."
                              },
                              "updated_at": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "format": "date-time",
                                "description": "Time the worker last checked this thumbnail version; absent before preparation."
                              },
                              "background_color": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "pattern": "^#[0-9a-fA-F]{6}$",
                                "description": "Measured source-image border colour or explicit generated-render background for image gutters; null when uncertain. Source pixels remain unchanged."
                              },
                              "generation_version": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Static-render policy version for worker-generated fallback attempts; null for source posters."
                              },
                              "provenance": {
                                "type": [
                                  "object",
                                  "null"
                                ],
                                "description": "Bounded worker render provenance, including source revision, renderer, appearance, geometry counts, warnings and download budgets. Empty for prepared source posters; null before the worker creates a media record. Generated previews are illustrative, not publisher-authored images.",
                                "additionalProperties": true
                              }
                            },
                            "required": [
                              "status",
                              "width",
                              "height",
                              "source",
                              "updated_at"
                            ]
                          },
                          "raw_url": {
                            "type": "string",
                            "description": "Immutable HF resolve URL for browser loading and download."
                          },
                          "source_url": {
                            "type": "string",
                            "description": "Original HF source page."
                          },
                          "source_updated_at": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Source file update if known, otherwise dataset modification time; not asset publication time.",
                            "format": "date-time"
                          },
                          "updated_scope": {
                            "type": "string",
                            "description": "Whether the update timestamp describes the asset or its containing dataset.",
                            "enum": [
                              "asset",
                              "dataset"
                            ]
                          },
                          "revision": {
                            "type": "string",
                            "description": "Immutable source commit SHA."
                          },
                          "license": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Source license claim; not a grant by TensorTrace."
                          },
                          "license_url": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Source license reference when available."
                          },
                          "sha256": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Observed root LFS SHA-256 when supplied."
                          },
                          "categories": {
                            "type": "array",
                            "description": "Source dataset tags; not inferred physical object classes.",
                            "items": {
                              "type": "string"
                            }
                          },
                          "metadata": {
                            "type": "object",
                            "description": "Optional observed source package metadata. Consumers must tolerate additional fields.",
                            "additionalProperties": true
                          },
                          "render": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "description": "Worker scene validation, independent from poster availability. Null until this input is checked. Ready publisher thumbnails do not establish 3D compatibility. Interactive loading uses the same scene engine and geometry limits; worker source-download budgets are bounded separately.",
                            "properties": {
                              "status": {
                                "type": "string",
                                "enum": [
                                  "ready",
                                  "failed",
                                  "unusable",
                                  "infrastructure"
                                ],
                                "description": "ready passed scene and poster coverage checks, possibly with reported best-effort repairs or partial geometry; failed retries after a delay; unusable is terminal for this immutable input and applicable check policy; infrastructure records an unavailable render environment."
                              },
                              "error_code": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Stable failure category such as source_invalid, source_invalid_geometry, source_fetch, resource_limit, renderer_timeout, renderer_crashed or renderer_unavailable. Null on success."
                              },
                              "message": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Bounded diagnostic text; do not branch on its wording."
                              },
                              "checked_at": {
                                "type": "string",
                                "format": "date-time"
                              },
                              "attempts": {
                                "type": "integer",
                                "minimum": 1
                              },
                              "retry_at": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "format": "date-time",
                                "description": "Earliest retry time; null for successful or terminal checks."
                              },
                              "warnings": {
                                "type": "array",
                                "maxItems": 16,
                                "description": "Known preview limitations or best-effort geometry repairs. Unique warning codes and fixed safe display messages only; private paths, source messages and diagnostic context are omitted. Empty when no known warning was recorded for the current check.",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "code": {
                                      "type": "string",
                                      "maxLength": 64
                                    },
                                    "message": {
                                      "type": "string",
                                      "maxLength": 160
                                    }
                                  },
                                  "required": [
                                    "code",
                                    "message"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "scene": {
                                "type": [
                                  "object",
                                  "null"
                                ],
                                "description": "Bounded scene metadata measured by the current worker check, including animation names/durations and skinned-mesh count. Metadata does not imply every animation is compatible with every device."
                              }
                            },
                            "required": [
                              "status",
                              "error_code",
                              "message",
                              "checked_at",
                              "attempts",
                              "retry_at",
                              "warnings"
                            ]
                          },
                          "object_identity": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "description": "Explicit source namespace, object ID and relationship evidence. Reconstruction methods retain separate logical assets."
                          },
                          "representations": {
                            "type": [
                              "array",
                              "null"
                            ],
                            "description": "Source-proven originals and their relationship basis; no implicit filename fusion.",
                            "items": {
                              "type": "object",
                              "description": "A source-proven representation at the same immutable repository revision. Similar filenames alone do not establish equivalence.",
                              "properties": {
                                "path": {
                                  "type": "string",
                                  "description": "Exact dataset-relative representation path."
                                },
                                "format": {
                                  "type": "string",
                                  "enum": [
                                    "usd",
                                    "usda",
                                    "usdc",
                                    "usdz",
                                    "glb",
                                    "gltf"
                                  ],
                                  "description": "Source representation format."
                                },
                                "url": {
                                  "type": "string",
                                  "format": "uri",
                                  "description": "Revision-pinned original file URL."
                                },
                                "byte_size": {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "minimum": 0,
                                  "description": "Observed source file bytes, when available."
                                },
                                "basis": {
                                  "type": "string",
                                  "description": "Explicit source identity, manifest or publisher-documentation relationship basis."
                                },
                                "source_url": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Immutable relationship evidence when supplied by the publisher."
                                }
                              },
                              "required": [
                                "path",
                                "format",
                                "url",
                                "basis"
                              ]
                            }
                          },
                          "tags": {
                            "type": [
                              "array",
                              "null"
                            ],
                            "items": {
                              "type": "string"
                            },
                            "description": "Bounded source-owned object tags."
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "description": "Source-annotated original author; distinct from Hub publisher namespace."
                          },
                          "license_name": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Readable source license identifier; no version is inferred when absent from source metadata."
                          },
                          "scene": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "description": "Optional worker-measured animation count, bounded clip names/durations and skinned-mesh count for the current immutable input."
                          },
                          "group_id": {
                            "type": "string",
                            "format": "uuid",
                            "description": "Persistent logical identity; synthetic for proven duplicate packages. Existing source UUIDs remain source-specific."
                          },
                          "primary_source_id": {
                            "type": "string",
                            "format": "uuid"
                          },
                          "canonical_url": {
                            "type": "string"
                          },
                          "source_count": {
                            "type": "integer",
                            "minimum": 1
                          },
                          "publishers": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "authors": {
                            "type": "array",
                            "items": {
                              "type": "object"
                            },
                            "description": "Distinct explicitly supplied source author objects, never inferred from publisher names."
                          },
                          "sources": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "description": "One original active source alias. Publisher/uploader and actual source author are distinct; rights apply to this source claim. Full original metadata remains at metadata_url.",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "format": "uuid"
                                },
                                "dataset_id": {
                                  "type": "string"
                                },
                                "publisher": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "author": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "revision": {
                                  "type": "string"
                                },
                                "download_url": {
                                  "type": "string"
                                },
                                "metadata_url": {
                                  "type": "string"
                                },
                                "license": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "raw_url": {
                                  "type": "string"
                                },
                                "source_url": {
                                  "type": "string"
                                }
                              },
                              "additionalProperties": true
                            },
                            "maxItems": 100
                          },
                          "sources_offset": {
                            "type": "integer",
                            "minimum": 0
                          },
                          "sources_has_more": {
                            "type": "boolean"
                          },
                          "media_source_id": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "format": "uuid"
                          },
                          "render_source_id": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "format": "uuid"
                          },
                          "identity": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "description": "Verified closed-package basis and safe closure summary. Filename/title/poster similarity is not identity evidence."
                          }
                        },
                        "required": [
                          "id",
                          "title",
                          "dataset_id",
                          "dataset_name",
                          "publisher",
                          "path",
                          "format",
                          "byte_size",
                          "thumbnail_url",
                          "raw_url",
                          "source_url",
                          "source_updated_at",
                          "updated_scope",
                          "revision",
                          "license",
                          "categories",
                          "metadata",
                          "source_thumbnail_url",
                          "preview",
                          "media"
                        ]
                      }
                    },
                    "total_count": {
                      "type": "integer",
                      "description": "Matching active assets before pagination.",
                      "minimum": 0
                    },
                    "unfiltered_total": {
                      "type": "integer",
                      "description": "All active assets before search or filters.",
                      "minimum": 0
                    },
                    "preview_total": {
                      "type": "integer",
                      "minimum": 0,
                      "description": "All active assets with a worker-validated ready thumbnail, before search, dataset, format or preview filtering."
                    },
                    "limit": {
                      "type": "integer",
                      "description": "Requested page size; defaults to 18.",
                      "minimum": 1,
                      "maximum": 100
                    },
                    "offset": {
                      "type": "integer",
                      "description": "Zero-based matched-result offset.",
                      "minimum": 0,
                      "maximum": 1000000
                    },
                    "indexing": {
                      "type": "object",
                      "properties": {
                        "datasets_discovered": {
                          "type": "integer",
                          "description": "Public datasets with repository metadata indexed.",
                          "minimum": 0
                        },
                        "datasets_indexed": {
                          "type": "integer",
                          "description": "Datasets whose full pinned tree and root metadata completed.",
                          "minimum": 0
                        },
                        "assets_indexed": {
                          "type": "integer",
                          "description": "Currently active assets.",
                          "minimum": 0
                        },
                        "pending": {
                          "type": "boolean",
                          "description": "True while discovery or inventory work remains."
                        },
                        "queued_repositories": {
                          "type": "integer",
                          "minimum": 0,
                          "description": "Repository metadata jobs waiting for an eligible turn."
                        },
                        "partial_inventories": {
                          "type": "integer",
                          "minimum": 0,
                          "description": "Active and paused revision-pinned inventories."
                        },
                        "retrying_repositories": {
                          "type": "integer",
                          "minimum": 0,
                          "description": "Repositories with independent retry records; their published assets remain available."
                        },
                        "discovery_complete": {
                          "type": "boolean",
                          "description": "The current tag/name discovery cycle completed; not a claim of complete Hub coverage."
                        },
                        "next_discovery_at": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "format": "date-time",
                          "description": "Next discovery cycle start, or null while the current cycle is unfinished."
                        },
                        "next_check_at": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "format": "date-time",
                          "description": "Next deferred acquisition wake, or null while work is immediately eligible."
                        },
                        "last_indexed_at": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Most recent completed inventory publication.",
                          "format": "date-time"
                        },
                        "coverage": {
                          "type": "string",
                          "description": "Discovery scope and known limits; this is not a claim to discover every untagged repository."
                        },
                        "paused": {
                          "type": "boolean",
                          "description": "True while an upstream retry cooldown is active; existing cards remain available."
                        },
                        "retry_at": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "format": "date-time",
                          "description": "Most recently scheduled upstream retry time, if any."
                        },
                        "counts": {
                          "type": "object",
                          "description": "Distinct source object identities, logical asset/method cards and source representations. Discovered datasets and staged entries are separate coverage measures."
                        },
                        "previews_checked": {
                          "type": "integer",
                          "minimum": 0,
                          "description": "Current immutable scene inputs checked by the worker, independently from ready source posters."
                        }
                      },
                      "required": [
                        "datasets_discovered",
                        "datasets_indexed",
                        "assets_indexed",
                        "pending",
                        "last_indexed_at",
                        "coverage"
                      ]
                    }
                  },
                  "required": [
                    "data",
                    "total_count",
                    "unfiltered_total",
                    "preview_total",
                    "limit",
                    "offset",
                    "indexing"
                  ]
                },
                "example": {
                  "data": [
                    {
                      "id": "a75ffbbc-138e-4e6e-98d8-f986c041491d",
                      "title": "Robotiq 2F 85",
                      "description": null,
                      "dataset_id": "Robotiq-Official/simready-assets",
                      "dataset_name": "Robotiq-Official/simready-assets",
                      "publisher": "Robotiq-Official",
                      "path": "Robotiq_2F_85/simready_usd/Robotiq_2F_85.usda",
                      "format": "usda",
                      "byte_size": 4096,
                      "thumbnail_url": null,
                      "raw_url": "https://huggingface.co/datasets/Robotiq-Official/simready-assets/resolve/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Robotiq_2F_85/simready_usd/Robotiq_2F_85.usda",
                      "source_url": "https://huggingface.co/datasets/Robotiq-Official/simready-assets",
                      "source_updated_at": "2026-10-22T14:39:38Z",
                      "updated_scope": "dataset",
                      "revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                      "license": null,
                      "license_url": null,
                      "sha256": null,
                      "categories": [
                        "openusd"
                      ],
                      "metadata": {},
                      "source_thumbnail_url": null,
                      "preview": null,
                      "media": {
                        "status": "missing",
                        "width": null,
                        "height": null,
                        "source": null,
                        "updated_at": null,
                        "background_color": null
                      }
                    }
                  ],
                  "total_count": 1,
                  "unfiltered_total": 1,
                  "limit": 18,
                  "offset": 0,
                  "indexing": {
                    "datasets_discovered": 1,
                    "datasets_indexed": 1,
                    "assets_indexed": 1,
                    "pending": false,
                    "last_indexed_at": "2026-10-24T12:00:00Z",
                    "coverage": "Illustrative completed public collection inventory; untagged repositories may be absent."
                  },
                  "preview_total": 0
                }
              }
            }
          },
          "400": {
            "description": "Invalid query parameters."
          },
          "404": {
            "description": "Asset does not exist or is unavailable."
          }
        }
      }
    },
    "/openusd/assets/{id}": {
      "get": {
        "operationId": "openUsdAsset",
        "summary": "Read one 3D asset",
        "description": "Reads stored USD, GLB and glTF metadata without upstream acquisition. Public data only; source terms and preview fidelity vary by asset.",
        "tags": [
          "3D Assets"
        ],
        "x-document-page": "openusd",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Stable TensorTrace 3D asset UUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Stored OpenUSD result.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "One logical 3D asset. Stable UUID is scoped by dataset and root path; revision changes update the same identity.",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Stable TensorTrace 3D asset UUID.",
                      "format": "uuid"
                    },
                    "title": {
                      "type": "string",
                      "description": "Human-facing source object or package name; official source metadata takes precedence over UID filenames."
                    },
                    "description": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Optional asset description."
                    },
                    "dataset_id": {
                      "type": "string",
                      "description": "Case-preserved Hugging Face owner/repository identity."
                    },
                    "dataset_name": {
                      "type": "string",
                      "description": "Dataset display name."
                    },
                    "publisher": {
                      "type": "string",
                      "description": "Hugging Face namespace; not a verification of authorship."
                    },
                    "path": {
                      "type": "string",
                      "description": "Logical root file within its dataset, excluding separate internal payload cards."
                    },
                    "format": {
                      "type": "string",
                      "description": "Root file format.",
                      "enum": [
                        "usd",
                        "usda",
                        "usdc",
                        "usdz",
                        "glb",
                        "gltf"
                      ]
                    },
                    "byte_size": {
                      "type": [
                        "integer",
                        "null"
                      ],
                      "description": "Root file bytes; excludes separately referenced dependencies.",
                      "minimum": 0
                    },
                    "source_thumbnail_url": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Raw upstream image candidate at the pinned source revision. It has not necessarily passed worker validation; clients should display thumbnail_url instead."
                    },
                    "thumbnail_url": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "format": "uri-reference",
                      "description": "Local versioned /api/v1/openusd/assets/{id}/thumbnail?v=... endpoint for the validated normalized WebP. Null until media.status is ready; never a speculative upstream image URL."
                    },
                    "preview": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "description": "A source-manifest or publisher-documented browser representation at the same immutable revision. The original source is preserved.",
                      "properties": {
                        "format": {
                          "type": "string",
                          "enum": [
                            "glb"
                          ],
                          "description": "Source-manifest browser preview format."
                        },
                        "path": {
                          "type": "string",
                          "description": "Observed GLB path within the source dataset."
                        },
                        "url": {
                          "type": "string",
                          "format": "uri",
                          "description": "Immutable HF resolve URL at the same revision as the indexed USD asset."
                        },
                        "byte_size": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 0,
                          "description": "Observed GLB file bytes, when supplied by the source tree."
                        },
                        "source": {
                          "type": "string",
                          "enum": [
                            "source_manifest",
                            "publisher_documentation"
                          ],
                          "description": "The source package explicitly declares this alternative; it is not guessed from a filename."
                        },
                        "manifest_path": {
                          "type": "string",
                          "description": "Dataset-relative source manifest declaring the GLB alternative."
                        }
                      },
                      "required": [
                        "format",
                        "path",
                        "url",
                        "byte_size",
                        "source"
                      ]
                    },
                    "media": {
                      "type": "object",
                      "description": "Worker-owned source-image or generated-3D thumbnail status. Public page and image reads never acquire or render upstream content.",
                      "properties": {
                        "status": {
                          "type": "string",
                          "enum": [
                            "pending",
                            "ready",
                            "missing",
                            "failed",
                            "unusable"
                          ],
                          "description": "ready has a validated cached poster; pending awaits acquisition or rendering; failed retries later; missing/unusable has no usable image or supported render for the recorded policy."
                        },
                        "width": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "description": "Stored normalized thumbnail width in pixels, when ready."
                        },
                        "height": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 1,
                          "description": "Stored normalized thumbnail height in pixels, when ready."
                        },
                        "source": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Worker media origin or preparation kind, when one has been recorded."
                        },
                        "updated_at": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "format": "date-time",
                          "description": "Time the worker last checked this thumbnail version; absent before preparation."
                        },
                        "background_color": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "pattern": "^#[0-9a-fA-F]{6}$",
                          "description": "Measured source-image border colour or explicit generated-render background for image gutters; null when uncertain. Source pixels remain unchanged."
                        },
                        "generation_version": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Static-render policy version for worker-generated fallback attempts; null for source posters."
                        },
                        "provenance": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "description": "Bounded worker render provenance, including source revision, renderer, appearance, geometry counts, warnings and download budgets. Empty for prepared source posters; null before the worker creates a media record. Generated previews are illustrative, not publisher-authored images.",
                          "additionalProperties": true
                        }
                      },
                      "required": [
                        "status",
                        "width",
                        "height",
                        "source",
                        "updated_at"
                      ]
                    },
                    "raw_url": {
                      "type": "string",
                      "description": "Immutable HF resolve URL for browser loading and download."
                    },
                    "source_url": {
                      "type": "string",
                      "description": "Original HF source page."
                    },
                    "source_updated_at": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Source file update if known, otherwise dataset modification time; not asset publication time.",
                      "format": "date-time"
                    },
                    "updated_scope": {
                      "type": "string",
                      "description": "Whether the update timestamp describes the asset or its containing dataset.",
                      "enum": [
                        "asset",
                        "dataset"
                      ]
                    },
                    "revision": {
                      "type": "string",
                      "description": "Immutable source commit SHA."
                    },
                    "license": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Source license claim; not a grant by TensorTrace."
                    },
                    "license_url": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Source license reference when available."
                    },
                    "sha256": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Observed root LFS SHA-256 when supplied."
                    },
                    "categories": {
                      "type": "array",
                      "description": "Source dataset tags; not inferred physical object classes.",
                      "items": {
                        "type": "string"
                      }
                    },
                    "metadata": {
                      "type": "object",
                      "description": "Optional observed source package metadata. Consumers must tolerate additional fields.",
                      "additionalProperties": true
                    },
                    "render": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "description": "Worker scene validation, independent from poster availability. Null until this input is checked. Ready publisher thumbnails do not establish 3D compatibility. Interactive loading uses the same scene engine and geometry limits; worker source-download budgets are bounded separately.",
                      "properties": {
                        "status": {
                          "type": "string",
                          "enum": [
                            "ready",
                            "failed",
                            "unusable",
                            "infrastructure"
                          ],
                          "description": "ready passed scene and poster coverage checks, possibly with reported best-effort repairs or partial geometry; failed retries after a delay; unusable is terminal for this immutable input and applicable check policy; infrastructure records an unavailable render environment."
                        },
                        "error_code": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Stable failure category such as source_invalid, source_invalid_geometry, source_fetch, resource_limit, renderer_timeout, renderer_crashed or renderer_unavailable. Null on success."
                        },
                        "message": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Bounded diagnostic text; do not branch on its wording."
                        },
                        "checked_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "attempts": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "retry_at": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "format": "date-time",
                          "description": "Earliest retry time; null for successful or terminal checks."
                        },
                        "warnings": {
                          "type": "array",
                          "maxItems": 16,
                          "description": "Known preview limitations or best-effort geometry repairs. Unique warning codes and fixed safe display messages only; private paths, source messages and diagnostic context are omitted. Empty when no known warning was recorded for the current check.",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string",
                                "maxLength": 64
                              },
                              "message": {
                                "type": "string",
                                "maxLength": 160
                              }
                            },
                            "required": [
                              "code",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "scene": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "description": "Bounded scene metadata measured by the current worker check, including animation names/durations and skinned-mesh count. Metadata does not imply every animation is compatible with every device."
                        }
                      },
                      "required": [
                        "status",
                        "error_code",
                        "message",
                        "checked_at",
                        "attempts",
                        "retry_at",
                        "warnings"
                      ]
                    },
                    "object_identity": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "description": "Explicit source namespace, object ID and relationship evidence. Reconstruction methods retain separate logical assets."
                    },
                    "representations": {
                      "type": [
                        "array",
                        "null"
                      ],
                      "description": "Source-proven originals and their relationship basis; no implicit filename fusion.",
                      "items": {
                        "type": "object",
                        "description": "A source-proven representation at the same immutable repository revision. Similar filenames alone do not establish equivalence.",
                        "properties": {
                          "path": {
                            "type": "string",
                            "description": "Exact dataset-relative representation path."
                          },
                          "format": {
                            "type": "string",
                            "enum": [
                              "usd",
                              "usda",
                              "usdc",
                              "usdz",
                              "glb",
                              "gltf"
                            ],
                            "description": "Source representation format."
                          },
                          "url": {
                            "type": "string",
                            "format": "uri",
                            "description": "Revision-pinned original file URL."
                          },
                          "byte_size": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "minimum": 0,
                            "description": "Observed source file bytes, when available."
                          },
                          "basis": {
                            "type": "string",
                            "description": "Explicit source identity, manifest or publisher-documentation relationship basis."
                          },
                          "source_url": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Immutable relationship evidence when supplied by the publisher."
                          }
                        },
                        "required": [
                          "path",
                          "format",
                          "url",
                          "basis"
                        ]
                      }
                    },
                    "tags": {
                      "type": [
                        "array",
                        "null"
                      ],
                      "items": {
                        "type": "string"
                      },
                      "description": "Bounded source-owned object tags."
                    },
                    "author": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "description": "Source-annotated original author; distinct from Hub publisher namespace."
                    },
                    "license_name": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Readable source license identifier; no version is inferred when absent from source metadata."
                    },
                    "scene": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "description": "Optional worker-measured animation count, bounded clip names/durations and skinned-mesh count for the current immutable input."
                    },
                    "group_id": {
                      "type": "string",
                      "format": "uuid",
                      "description": "Persistent logical identity; synthetic for proven duplicate packages. Existing source UUIDs remain source-specific."
                    },
                    "primary_source_id": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "canonical_url": {
                      "type": "string"
                    },
                    "source_count": {
                      "type": "integer",
                      "minimum": 1
                    },
                    "publishers": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "authors": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Distinct explicitly supplied source author objects, never inferred from publisher names."
                    },
                    "sources": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "description": "One original active source alias. Publisher/uploader and actual source author are distinct; rights apply to this source claim. Full original metadata remains at metadata_url.",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid"
                          },
                          "dataset_id": {
                            "type": "string"
                          },
                          "publisher": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ]
                          },
                          "revision": {
                            "type": "string"
                          },
                          "download_url": {
                            "type": "string"
                          },
                          "metadata_url": {
                            "type": "string"
                          },
                          "license": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "raw_url": {
                            "type": "string"
                          },
                          "source_url": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": true
                      },
                      "maxItems": 100
                    },
                    "sources_offset": {
                      "type": "integer",
                      "minimum": 0
                    },
                    "sources_has_more": {
                      "type": "boolean"
                    },
                    "media_source_id": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "format": "uuid"
                    },
                    "render_source_id": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "format": "uuid"
                    },
                    "identity": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "description": "Verified closed-package basis and safe closure summary. Filename/title/poster similarity is not identity evidence."
                    }
                  },
                  "required": [
                    "id",
                    "title",
                    "dataset_id",
                    "dataset_name",
                    "publisher",
                    "path",
                    "format",
                    "byte_size",
                    "thumbnail_url",
                    "raw_url",
                    "source_url",
                    "source_updated_at",
                    "updated_scope",
                    "revision",
                    "license",
                    "categories",
                    "metadata",
                    "source_thumbnail_url",
                    "preview",
                    "media"
                  ]
                },
                "example": {
                  "id": "a75ffbbc-138e-4e6e-98d8-f986c041491d",
                  "title": "Robotiq 2F 85",
                  "description": null,
                  "dataset_id": "Robotiq-Official/simready-assets",
                  "dataset_name": "Robotiq-Official/simready-assets",
                  "publisher": "Robotiq-Official",
                  "path": "Robotiq_2F_85/simready_usd/Robotiq_2F_85.usda",
                  "format": "usda",
                  "byte_size": 4096,
                  "thumbnail_url": null,
                  "raw_url": "https://huggingface.co/datasets/Robotiq-Official/simready-assets/resolve/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Robotiq_2F_85/simready_usd/Robotiq_2F_85.usda",
                  "source_url": "https://huggingface.co/datasets/Robotiq-Official/simready-assets",
                  "source_updated_at": "2026-10-22T14:39:38Z",
                  "updated_scope": "dataset",
                  "revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                  "license": null,
                  "license_url": null,
                  "sha256": null,
                  "categories": [
                    "openusd"
                  ],
                  "metadata": {},
                  "source_thumbnail_url": null,
                  "preview": null,
                  "media": {
                    "status": "missing",
                    "width": null,
                    "height": null,
                    "source": null,
                    "updated_at": null,
                    "background_color": null
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid query parameters."
          },
          "404": {
            "description": "Asset does not exist or is unavailable."
          }
        }
      }
    },
    "/openusd/assets/{id}/thumbnail": {
      "get": {
        "operationId": "openUsdThumbnail",
        "summary": "Read a validated 3D asset thumbnail",
        "description": "Serves an already prepared local WebP; never downloads or renders a source image during the request. Use the versioned thumbnail_url returned by the asset API. Only an active asset and a ready image at its current media version are served.",
        "tags": [
          "3D Assets"
        ],
        "x-document-page": "openusd",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Stable TensorTrace 3D asset UUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "v",
            "in": "query",
            "required": false,
            "description": "Current opaque media version from thumbnail_url. A matching version enables immutable caching; stale or unknown versions return 404.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "required": false,
            "description": "Previously returned image ETag; a matching validator returns an empty 304 response.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Worker-validated normalized WebP image.",
            "headers": {
              "ETag": {
                "description": "Quoted SHA-256 of the stored WebP bytes. If-None-Match supports strong or weak tags, comma-separated candidates and *.",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "With a matching v: public,max-age=31536000,immutable. Without v: public,max-age=300,must-revalidate. A stale v returns 404 rather than another revision image.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "image/webp": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "304": {
            "description": "Image ETag matches; no response body.",
            "headers": {
              "ETag": {
                "description": "Quoted SHA-256 of the stored WebP bytes. If-None-Match supports strong or weak tags, comma-separated candidates and *.",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "description": "With a matching v: public,max-age=31536000,immutable. Without v: public,max-age=300,must-revalidate. A stale v returns 404 rather than another revision image.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "description": "Asset or ready preview is unavailable, or v does not match the current media version."
          }
        }
      }
    },
    "/openusd/datasets": {
      "get": {
        "operationId": "openUsdDatasets",
        "summary": "Read 3D dataset indexing coverage",
        "description": "Reads stored USD, GLB and glTF metadata without upstream acquisition. Public data only; source terms and preview fidelity vary by asset.",
        "tags": [
          "3D Assets"
        ],
        "x-document-page": "openusd",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Stored OpenUSD result.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "description": "HF owner/repository identity."
                          },
                          "name": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Dataset display name."
                          },
                          "index_status": {
                            "type": "string",
                            "description": "Inventory state, such as scanning, indexed or gated."
                          },
                          "indexed_at": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Last complete inventory publication."
                          },
                          "asset_count": {
                            "type": "integer",
                            "description": "Current active asset count."
                          },
                          "source_url": {
                            "type": "string",
                            "description": "Original dataset page."
                          },
                          "inventory_summary": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "description": "Observed direct-file inventory totals and archive contents that were not expanded. Only completed inventories have a summary.",
                            "additionalProperties": true
                          }
                        }
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "data": [
                    {
                      "id": "Robotiq-Official/simready-assets",
                      "name": "Robotiq-Official/simready-assets",
                      "index_status": "indexed",
                      "indexed_at": "2026-10-24T12:00:00Z",
                      "asset_count": 1,
                      "source_url": "https://huggingface.co/datasets/Robotiq-Official/simready-assets"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid query parameters."
          },
          "404": {
            "description": "Asset does not exist or is unavailable."
          }
        }
      }
    },
    "/openusd/assets/{id}/download": {
      "get": {
        "operationId": "openUsdOriginalDownload",
        "summary": "Download an original 3D asset file",
        "description": "Explicitly streams the active asset’s stored, revision-pinned original file as an attachment. No caller URL, credentials, dependency packaging or GLB substitution. Public-IP/DNS pinning and per-hop Hugging Face HTTPS allowlisting guard the source request. Files with an indexed size above 512 MiB redirect to the pinned source with download=true. Proxy limits: 512 MiB, 120 seconds total and eight concurrent downloads. No buffering of the complete file or range/resume support. Size/deadline/network failures after headers abort the stream. Ordinary page and metadata reads never invoke this transfer.",
        "tags": [
          "3D Assets"
        ],
        "x-document-page": "openusd",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Stable TensorTrace 3D asset UUID; the stored dataset, immutable revision and root path select the original file.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "representation",
            "in": "query",
            "required": false,
            "description": "Exact path from the stored representations list. The default remains the original primary file. Arbitrary URLs and unlisted paths are rejected.",
            "schema": {
              "type": "string",
              "maxLength": 4096
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Original file bytes, streamed unchanged.",
            "headers": {
              "Content-Disposition": {
                "description": "Attachment with an ASCII fallback and RFC 5987 UTF-8 original basename.",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Length": {
                "description": "Expected original byte count when known. A streaming size mismatch aborts the transfer.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "Cache-Control": {
                "description": "private,no-store,no-transform; the proxy does not retain a copy.",
                "schema": {
                  "type": "string"
                }
              },
              "X-Content-Type-Options": {
                "description": "nosniff.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "404": {
            "description": "Asset is unavailable or the upstream original no longer exists."
          },
          "413": {
            "description": "Upstream transfer exceeds the proxy budget despite its stored size."
          },
          "502": {
            "description": "Stored source identity is invalid or the source response cannot be served safely."
          },
          "503": {
            "description": "Concurrent download limit reached or upstream source temporarily unavailable."
          },
          "504": {
            "description": "Source deadline exceeded before response headers; later expiration aborts the transfer."
          },
          "307": {
            "description": "Known original is larger than the proxy budget; download directly from its pinned Hugging Face source.",
            "headers": {
              "Location": {
                "description": "Validated source HTTPS resolve URL with download=true.",
                "schema": {
                  "type": "string",
                  "format": "uri"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "openUsdOriginalDownloadHeaders",
        "summary": "Inspect original 3D file download headers",
        "description": "Returns attachment headers from active stored metadata only. It never contacts Hugging Face, streams a body or verifies current upstream availability.",
        "tags": [
          "3D Assets"
        ],
        "x-document-page": "openusd",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Stable TensorTrace 3D asset UUID; the stored dataset, immutable revision and root path select the original file.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "representation",
            "in": "query",
            "required": false,
            "description": "Exact path from the stored representations list. The default remains the original primary file. Arbitrary URLs and unlisted paths are rejected.",
            "schema": {
              "type": "string",
              "maxLength": 4096
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Stored original-file attachment headers, without a body.",
            "headers": {
              "Content-Disposition": {
                "description": "Attachment with an ASCII fallback and RFC 5987 UTF-8 original basename.",
                "schema": {
                  "type": "string"
                }
              },
              "Content-Length": {
                "description": "Expected original byte count when known. A streaming size mismatch aborts the transfer.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "Cache-Control": {
                "description": "private,no-store,no-transform; the proxy does not retain a copy.",
                "schema": {
                  "type": "string"
                }
              },
              "X-Content-Type-Options": {
                "description": "nosniff.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "description": "Asset is unavailable."
          },
          "502": {
            "description": "Stored source identity is invalid."
          }
        }
      }
    },
    "/openusd/assets/{id}/sources": {
      "get": {
        "tags": [
          "3D Assets"
        ],
        "operationId": "getOpenUsdAssetSources",
        "summary": "Page original public sources of a logical 3D asset",
        "description": "Same active-member source list used by SSR and Web. Source UUIDs retain their original metadata/download semantics. Inactive/gated sources are absent.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "description": "An active original source UUID or stable logical group UUID."
          },
          {
            "name": "offset",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 0,
              "minimum": 0,
              "maximum": 1000000
            },
            "description": "Skip this many active public source aliases, ordered by original UUID."
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 100,
              "minimum": 1,
              "maximum": 100
            },
            "description": "Maximum source aliases returned in this bounded page."
          }
        ],
        "responses": {
          "200": {
            "description": "Bounded source page",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "description": "One original active source alias. Publisher/uploader and actual source author are distinct; rights apply to this source claim. Full original metadata remains at metadata_url.",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid"
                          },
                          "dataset_id": {
                            "type": "string"
                          },
                          "publisher": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ]
                          },
                          "revision": {
                            "type": "string"
                          },
                          "download_url": {
                            "type": "string"
                          },
                          "metadata_url": {
                            "type": "string"
                          },
                          "license": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "raw_url": {
                            "type": "string"
                          },
                          "source_url": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": true
                      }
                    },
                    "total_count": {
                      "type": "integer"
                    },
                    "offset": {
                      "type": "integer"
                    },
                    "limit": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "data",
                    "total_count",
                    "offset",
                    "limit"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid source page parameters"
          },
          "404": {
            "description": "No active source or logical asset"
          }
        },
        "x-document-page": "openusd"
      }
    }
  },
  "components": {
    "schemas": {
      "HealthResponse": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string"
          },
          "service": {
            "type": "string"
          }
        },
        "required": [
          "status",
          "service"
        ]
      },
      "ModelsResponse": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CatalogModel"
            }
          },
          "total_count": {
            "type": "integer"
          }
        },
        "required": [
          "data",
          "total_count"
        ]
      },
      "ModelQuery": {
        "type": "object",
        "properties": {
          "q": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "query": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "price": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "provider": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "source": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "input_modality": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "capability": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "sort": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "limit": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "offset": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "output_modalities": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "developer": {
            "type": [
              "string",
              "null"
            ],
            "description": "Canonical developer ID; groups reviewed publisher aliases."
          },
          "inference_provider": {
            "type": [
              "string",
              "null"
            ],
            "description": "Registered inference source ID; selects current source offerings, including price-only records. Adds source-scoped provider_prices; other model fields retain canonical scope."
          },
          "model_type": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 64
              },
              {
                "type": "null"
              }
            ],
            "description": "Match a displayed model classification, including secondary types. Use multimodal for MLLM, vlm for image-only VLM, llm for text LLM, or another model type ID from a classification link. unknown selects models without reported classification evidence. Omit or use all for no type filter. Combines with other discovery filters before pagination and counts; an unrecognized ID returns an empty result."
          }
        },
        "required": [
          "capability"
        ]
      },
      "CatalogWindowQuery": {
        "type": "object",
        "properties": {
          "limit": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "offset": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": []
      },
      "LeaderboardsQuery": {
        "type": "object",
        "properties": {
          "q": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "query": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "source": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "source_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "dimension": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "benchmark": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "benchmark_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "leaderboard": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "leaderboard_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "entry_limit": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "leaderboard_limit": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "limit": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "offset": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": []
      },
      "ModelAliasDto": {
        "type": "object",
        "properties": {
          "source_id": {
            "type": "string"
          },
          "source_model_id": {
            "type": "string"
          },
          "alias_type": {
            "type": "string",
            "description": "Source identity relationship. routing denotes an explicitly declared moving alias; its canonical target can change on source refresh."
          },
          "confidence": {
            "type": "number"
          }
        },
        "required": [
          "source_id",
          "source_model_id",
          "alias_type",
          "confidence"
        ]
      },
      "PricePointDto": {
        "type": "object",
        "properties": {
          "source_id": {
            "type": "string"
          },
          "platform": {
            "type": "string"
          },
          "source_model_id": {
            "type": "string"
          },
          "unit": {
            "type": "string"
          },
          "amount_usd": {
            "type": "number"
          },
          "currency": {
            "type": "string"
          },
          "effective_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "source_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "source_retrieved_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "conditions": {
            "type": "object",
            "additionalProperties": true,
            "description": "Billing qualifiers; compare only matching unit, currency and conditions."
          },
          "billing_label": {
            "type": [
              "string",
              "null"
            ],
            "description": "Original published billing label."
          },
          "pricing_via": {
            "type": [
              "string",
              "null"
            ],
            "description": "Gateway route, distinct from the actual serving platform."
          },
          "receipt_id": {
            "type": [
              "string",
              "null"
            ],
            "format": "uuid",
            "description": "Exact source receipt for this quote; null denotes unknown attribution."
          }
        },
        "required": [
          "source_id",
          "platform",
          "source_model_id",
          "unit",
          "amount_usd",
          "currency"
        ]
      },
      "PriceQuery": {
        "type": "object",
        "properties": {
          "q": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "query": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "provider": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "source": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "platform": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "unit": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "sort": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "limit": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "offset": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": []
      },
      "PriceComparisonResponse": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PriceComparisonRowDto"
            }
          },
          "total_count": {
            "type": "integer"
          }
        },
        "required": [
          "data",
          "total_count"
        ]
      },
      "PriceComparisonRowDto": {
        "type": "object",
        "properties": {
          "canonical_model_id": {
            "type": "string"
          },
          "provider": {
            "type": "string"
          },
          "display_name": {
            "type": "string"
          },
          "source_id": {
            "type": "string"
          },
          "platform": {
            "type": "string"
          },
          "source_model_id": {
            "type": "string"
          },
          "unit": {
            "type": "string"
          },
          "amount_usd": {
            "type": "number"
          },
          "currency": {
            "type": "string"
          },
          "effective_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "source_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "source_retrieved_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "conditions": {
            "type": "object",
            "additionalProperties": true,
            "description": "Billing qualifiers; compare only matching unit, currency and conditions."
          },
          "billing_label": {
            "type": [
              "string",
              "null"
            ],
            "description": "Original published billing label."
          },
          "pricing_via": {
            "type": [
              "string",
              "null"
            ],
            "description": "Gateway route, distinct from the actual serving platform."
          },
          "receipt_id": {
            "type": [
              "string",
              "null"
            ],
            "format": "uuid",
            "description": "Exact source receipt for this quote; null denotes unknown attribution."
          }
        },
        "required": [
          "canonical_model_id",
          "provider",
          "display_name",
          "source_id",
          "platform",
          "source_model_id",
          "unit",
          "amount_usd",
          "currency",
          "updated_at"
        ]
      },
      "BenchmarkScoreDto": {
        "type": "object",
        "properties": {
          "source_id": {
            "type": "string"
          },
          "benchmark_id": {
            "type": "string"
          },
          "benchmark_name": {
            "type": "string"
          },
          "leaderboard_id": {
            "type": "string"
          },
          "leaderboard_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "dimension": {
            "type": "string"
          },
          "metric": {
            "type": "string"
          },
          "score": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "unit": {
            "type": "string"
          },
          "rank": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "confidence_lower": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "confidence_upper": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "sample_size": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "evaluated_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "source_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "source_retrieved_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "source_record_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "source_model_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "aggregation_scope": {
            "type": [
              "object",
              "null"
            ],
            "description": "Source aggregation coverage, including task count, revision count and sample, dataset splits and subset coverage. An aggregate spanning revisions is not a single-checkpoint measurement.",
            "additionalProperties": true
          },
          "receipt_id": {
            "type": [
              "string",
              "null"
            ],
            "format": "uuid",
            "description": "Exact source receipt for this observation; null denotes unknown attribution."
          }
        },
        "required": [
          "source_id",
          "benchmark_id",
          "benchmark_name",
          "leaderboard_id",
          "dimension",
          "metric",
          "unit"
        ]
      },
      "SourceReceiptDto": {
        "type": "object",
        "properties": {
          "receipt_id": {
            "type": "string",
            "format": "uuid"
          },
          "source_id": {
            "type": "string"
          },
          "source_url": {
            "type": "string"
          },
          "retrieved_at": {
            "type": "string",
            "format": "date-time"
          },
          "published_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "parser_version": {
            "type": "string"
          },
          "record_count": {
            "type": "integer"
          },
          "checksum_sha256": {
            "type": "string"
          }
        },
        "required": [
          "receipt_id",
          "source_id",
          "source_url",
          "retrieved_at",
          "parser_version",
          "record_count",
          "checksum_sha256"
        ]
      },
      "SourceRecordDto": {
        "type": "object",
        "properties": {
          "source_id": {
            "type": "string"
          },
          "source_record_id": {
            "type": "string"
          },
          "receipt_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ]
          },
          "confidence": {
            "type": "number"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "raw_payload": {},
          "link_corrections": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SourceLinkCorrection"
            }
          }
        },
        "required": [
          "source_id",
          "source_record_id",
          "confidence",
          "updated_at",
          "raw_payload"
        ]
      },
      "ModelSourceSummaryDto": {
        "type": "object",
        "properties": {
          "source_id": {
            "type": "string"
          },
          "data_kinds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "record_count": {
            "type": "integer"
          },
          "latest_updated_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "source_retrieved_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "source_id",
          "data_kinds",
          "record_count"
        ]
      },
      "SourceDto": {
        "type": "object",
        "properties": {
          "source_id": {
            "type": "string"
          },
          "display_name": {
            "type": "string"
          },
          "short_name": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "authority": {
            "type": "string"
          },
          "access_method": {
            "type": "string"
          },
          "homepage": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "icon_name": {
            "type": "string"
          },
          "accent": {
            "type": "string"
          },
          "data_kinds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "is_official": {
            "type": "boolean"
          },
          "refresh_interval_seconds": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "status": {
            "type": "string"
          },
          "freshness": {
            "type": "string"
          },
          "latest_receipt_age_seconds": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "seconds_until_refresh": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_stale": {
            "type": "boolean"
          },
          "is_refresh_due": {
            "type": "boolean"
          },
          "has_active_failure": {
            "type": "boolean"
          },
          "latest_receipt": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SourceReceiptDto"
              },
              {
                "type": "null"
              }
            ]
          },
          "latest_job": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SourceJobDto"
              },
              {
                "type": "null"
              }
            ]
          },
          "last_success_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "last_failure_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "consecutive_failures": {
            "type": "integer"
          },
          "next_refresh_after": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "last_error_message": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "coverage": {
            "$ref": "#/components/schemas/SourceCoverageDto"
          },
          "refresh_policy": {
            "$ref": "#/components/schemas/RefreshPolicy"
          },
          "provider_status": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ProviderStatus"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "source_id",
          "display_name",
          "short_name",
          "category",
          "authority",
          "access_method",
          "icon_name",
          "accent",
          "data_kinds",
          "is_official",
          "status",
          "freshness",
          "is_stale",
          "is_refresh_due",
          "has_active_failure",
          "consecutive_failures",
          "coverage"
        ]
      },
      "SourceQuery": {
        "type": "object",
        "properties": {
          "source": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "source_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "status": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "authority": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "access_method": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "freshness": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": []
      },
      "SourceCoverageDto": {
        "type": "object",
        "properties": {
          "canonical_model_count": {
            "type": "integer"
          },
          "alias_count": {
            "type": "integer"
          },
          "source_record_count": {
            "type": "integer"
          },
          "linked_source_record_count": {
            "type": "integer"
          },
          "capability_count": {
            "type": "integer"
          },
          "price_point_count": {
            "type": "integer"
          },
          "benchmark_score_count": {
            "type": "integer"
          },
          "runtime_metric_count": {
            "type": "integer"
          },
          "system_performance_result_count": {
            "type": "integer"
          },
          "safety_finding_count": {
            "type": "integer"
          },
          "receipt_count": {
            "type": "integer"
          },
          "distribution_coverage": {
            "type": "object",
            "additionalProperties": true
          }
        },
        "required": [
          "canonical_model_count",
          "alias_count",
          "source_record_count",
          "linked_source_record_count",
          "capability_count",
          "price_point_count",
          "benchmark_score_count",
          "runtime_metric_count",
          "system_performance_result_count",
          "safety_finding_count",
          "receipt_count"
        ]
      },
      "SourceJobDto": {
        "type": "object",
        "properties": {
          "refresh_job_id": {
            "type": "string",
            "format": "uuid"
          },
          "source_id": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "requested_by": {
            "type": "string"
          },
          "force": {
            "type": "boolean"
          },
          "started_at": {
            "type": "string",
            "format": "date-time"
          },
          "finished_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "record_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "error_message": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "refresh_job_id",
          "source_id",
          "status",
          "requested_by",
          "force",
          "started_at"
        ]
      },
      "RefreshJobsQuery": {
        "type": "object",
        "properties": {
          "source": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "source_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "limit": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "offset": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": []
      },
      "RefreshJobsResponse": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SourceJobDto"
            }
          },
          "total_count": {
            "type": "integer"
          }
        },
        "required": [
          "data",
          "total_count"
        ]
      },
      "SystemPerformanceQuery": {
        "type": "object",
        "properties": {
          "model": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "scenario": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "suite": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "unit": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "limit": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "offset": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": []
      },
      "SystemPerformanceResponse": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SystemPerformanceResultDto"
            }
          },
          "total_count": {
            "type": "integer"
          }
        },
        "required": [
          "data",
          "total_count"
        ]
      },
      "SystemPerformanceResultDto": {
        "type": "object",
        "properties": {
          "source_id": {
            "type": "string"
          },
          "source_record_id": {
            "type": "string"
          },
          "canonical_model_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "benchmark_version": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "suite": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "category": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "submitter": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "availability": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "system_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "platform": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "model_name": {
            "type": "string"
          },
          "used_model": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "scenario": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "accuracy": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "nodes": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "processor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "accelerator": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "total_accelerators": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "software": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "operating_system": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "weight_data_types": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "performance_result": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "performance_units": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "details_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "code_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "source_id",
          "source_record_id",
          "model_name",
          "updated_at"
        ]
      },
      "SafetyFindingsQuery": {
        "type": "object",
        "properties": {
          "source": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "model": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "benchmark": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "hazard": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "severity": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "limit": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "offset": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": []
      },
      "SafetyFindingsResponse": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SafetyFindingDto"
            }
          },
          "total_count": {
            "type": "integer"
          }
        },
        "required": [
          "data",
          "total_count"
        ]
      },
      "SafetyFindingDto": {
        "type": "object",
        "properties": {
          "source_id": {
            "type": "string"
          },
          "source_record_id": {
            "type": "string"
          },
          "canonical_model_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "benchmark_id": {
            "type": "string"
          },
          "benchmark_name": {
            "type": "string"
          },
          "taxonomy": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "hazard_category": {
            "type": "string"
          },
          "hazard_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "policy_area": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "assessment_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "prompt_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "metric": {
            "type": "string"
          },
          "score": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "unit": {
            "type": "string"
          },
          "grade": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "severity": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "result_label": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "confidence_lower": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "confidence_upper": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "sample_size": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "evaluated_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "source_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "source_id",
          "source_record_id",
          "benchmark_id",
          "benchmark_name",
          "hazard_category",
          "metric",
          "unit",
          "updated_at"
        ]
      },
      "OverviewResponse": {
        "type": "object",
        "properties": {
          "total_models": {
            "type": "integer"
          },
          "free_models": {
            "type": "integer"
          },
          "paid_models": {
            "type": "integer"
          },
          "multimodal_models": {
            "type": "integer"
          },
          "reasoning_models": {
            "type": "integer"
          },
          "tool_calling_models": {
            "type": "integer"
          },
          "best_context_window": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "average_capability_score": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "latest_refresh_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "model_count": {
            "type": "integer",
            "minimum": 0
          },
          "family_count": {
            "type": "integer",
            "minimum": 0
          },
          "distribution_count": {
            "type": "integer",
            "minimum": 0
          }
        },
        "required": [
          "total_models",
          "free_models",
          "paid_models",
          "multimodal_models",
          "reasoning_models",
          "tool_calling_models",
          "model_count",
          "family_count",
          "distribution_count"
        ]
      },
      "FacetsResponse": {
        "type": "object",
        "properties": {
          "models": {
            "$ref": "#/components/schemas/ModelFacetsDto"
          },
          "leaderboards": {
            "$ref": "#/components/schemas/LeaderboardFacetsDto"
          },
          "prices": {
            "$ref": "#/components/schemas/PriceFacetsDto"
          },
          "sources": {
            "$ref": "#/components/schemas/SourceFacetsDto"
          }
        },
        "required": [
          "models",
          "leaderboards",
          "prices",
          "sources"
        ]
      },
      "ModelFacetsDto": {
        "type": "object",
        "properties": {
          "providers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FacetOptionDto"
            }
          },
          "price_filters": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FacetOptionDto"
            }
          },
          "capabilities": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FacetOptionDto"
            }
          },
          "input_modalities": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FacetOptionDto"
            }
          },
          "output_modalities": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FacetOptionDto"
            }
          },
          "sorts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FacetOptionDto"
            }
          },
          "developers": {
            "type": "array",
            "description": "Canonical model developers in strongest-model order: Intelligence Index, capability score, Arena rating, then name. Counts include all publisher aliases; use values with the developer query parameter.",
            "items": {
              "$ref": "#/components/schemas/FacetOptionDto"
            }
          },
          "inference_providers": {
            "type": "array",
            "description": "Inference sources with indexed models, ordered by model count then name. Includes editor availability such as GitHub Copilot and Cursor when linked. Use values with inference_provider; availability does not establish token prices.",
            "items": {
              "$ref": "#/components/schemas/FacetOptionDto"
            }
          },
          "model_types": {
            "type": "array",
            "description": "Model classifications counted from published models, including primary and secondary types. Counts match the model_type filter before pagination. Ordered by count descending, then value; unknown remains available to API consumers. Optional on older prepared facet documents.",
            "items": {
              "$ref": "#/components/schemas/FacetOptionDto"
            }
          }
        },
        "required": [
          "providers",
          "price_filters",
          "capabilities",
          "input_modalities",
          "output_modalities",
          "sorts",
          "developers",
          "inference_providers"
        ]
      },
      "LeaderboardFacetsDto": {
        "type": "object",
        "properties": {
          "sources": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FacetOptionDto"
            }
          },
          "dimensions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FacetOptionDto"
            }
          },
          "benchmarks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FacetOptionDto"
            }
          }
        },
        "required": [
          "sources",
          "dimensions",
          "benchmarks"
        ]
      },
      "PriceFacetsDto": {
        "type": "object",
        "properties": {
          "sources": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FacetOptionDto"
            }
          },
          "platforms": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FacetOptionDto"
            }
          },
          "units": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FacetOptionDto"
            }
          }
        },
        "required": [
          "sources",
          "platforms",
          "units"
        ]
      },
      "SourceFacetsDto": {
        "type": "object",
        "properties": {
          "statuses": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FacetOptionDto"
            }
          },
          "authorities": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FacetOptionDto"
            }
          },
          "access_methods": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FacetOptionDto"
            }
          },
          "freshness": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FacetOptionDto"
            }
          }
        },
        "required": [
          "statuses",
          "authorities",
          "access_methods",
          "freshness"
        ]
      },
      "FacetOptionDto": {
        "type": "object",
        "properties": {
          "value": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "icon_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "group": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "value",
          "label"
        ]
      },
      "LeaderboardsResponse": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LeaderboardDto"
            }
          },
          "total_count": {
            "type": "integer"
          }
        },
        "required": [
          "data",
          "total_count"
        ]
      },
      "LeaderboardDto": {
        "type": "object",
        "properties": {
          "benchmark_id": {
            "type": "string"
          },
          "leaderboard_id": {
            "type": "string"
          },
          "benchmark_name": {
            "type": "string"
          },
          "leaderboard_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "dimension": {
            "type": "string"
          },
          "entries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LeaderboardEntryDto"
            }
          },
          "source_id": {
            "type": "string"
          },
          "metric": {
            "type": "string"
          },
          "unit": {
            "type": "string"
          }
        },
        "required": [
          "benchmark_id",
          "leaderboard_id",
          "benchmark_name",
          "dimension",
          "entries",
          "source_id",
          "metric",
          "unit"
        ]
      },
      "LeaderboardEntryDto": {
        "type": "object",
        "properties": {
          "source_id": {
            "type": "string"
          },
          "canonical_model_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Indexed TensorTrace model destination; null if no prepared model page exists."
          },
          "display_name": {
            "type": "string"
          },
          "provider": {
            "type": "string"
          },
          "score": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "unit": {
            "type": "string"
          },
          "rank": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "source_retrieved_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "source_record_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "source_model_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "aggregation_scope": {
            "type": [
              "object",
              "null"
            ],
            "description": "Source aggregation coverage, including task count, revision count and sample, dataset splits and subset coverage. An aggregate spanning revisions is not a single-checkpoint measurement.",
            "additionalProperties": true
          },
          "receipt_id": {
            "type": [
              "string",
              "null"
            ],
            "format": "uuid",
            "description": "Exact source receipt for this observation; null denotes unknown attribution."
          },
          "model_url": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri",
            "description": "Model URL preserved from the original result or official publisher metadata. Use only when canonical_model_id is null; no URL means plain text."
          },
          "source_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "Official result or export URL for this observation; falls back to the registered source website."
          }
        },
        "required": [
          "source_id",
          "canonical_model_id",
          "display_name",
          "provider",
          "unit"
        ]
      },
      "RefreshRequest": {
        "type": "object",
        "properties": {
          "source": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "force": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": []
      },
      "RefreshResult": {
        "type": "object",
        "properties": {
          "source_id": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "record_count": {
            "type": "integer"
          },
          "receipt_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ]
          },
          "job_id": {
            "type": "string",
            "format": "uuid"
          }
        },
        "required": [
          "source_id",
          "status",
          "record_count",
          "job_id"
        ]
      },
      "ErrorResponse": {
        "type": "object",
        "properties": {
          "error": {
            "type": "string"
          }
        },
        "required": [
          "error"
        ]
      },
      "CatalogModel": {
        "type": "object",
        "required": [
          "id",
          "canonical_model_id",
          "provider",
          "name"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Primary source identifier retained for v1 compatibility."
          },
          "canonical_model_id": {
            "type": "string",
            "description": "Stable, source-scoped model identity. Treat as opaque; encode path components."
          },
          "provider": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "created": {
            "type": [
              "integer",
              "null"
            ]
          },
          "context_length": {
            "type": [
              "integer",
              "null"
            ]
          },
          "hugging_face_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "canonical_slug": {
            "type": [
              "string",
              "null"
            ]
          },
          "architecture": {
            "type": "object",
            "properties": {
              "input_modalities": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "output_modalities": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "additionalProperties": true
          },
          "pricing": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true
          },
          "branding": {
            "$ref": "#/components/schemas/Branding"
          },
          "source_badges": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "source_summaries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ModelSourceSummaryDto"
            }
          },
          "top_benchmark_scores": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BenchmarkScoreDto"
            },
            "description": "One selected finite representative per linked benchmark source, prioritizing its main or overall evaluation. Units, scope and source evidence are preserved; values from different metrics are not directly comparable. Use the model scores endpoint for the complete evaluation set."
          },
          "is_free": {
            "type": "boolean"
          },
          "is_paid": {
            "type": "boolean"
          },
          "minimum_price_points": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PricePointDto"
            },
            "description": "Selected global quote minima per currency/unit, retaining both preferred base and conditional minima with full conditions and attribution. Input/output minima may come from different platforms. Use provider_prices for a provider-scoped comparison. This discovery selection is not the complete price evidence."
          },
          "platform_profiles": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PlatformProfile"
            },
            "description": "Source-specific task, hosting, schema and limits. Full schemas are included in model detail; catalog summaries omit schemas."
          },
          "cutoff_summary": {
            "$ref": "#/components/schemas/CutoffSummary"
          },
          "specification_observations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SpecificationObservation"
            },
            "description": "Positive numeric limits and original cutoff date labels, attributed to each source model/deployment. No synthetic cross-platform token limit."
          },
          "embedding_dimensions": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1,
            "description": "Reported default vector dimensions. Task-specific request dimensions may vary; this is not an output-token limit."
          },
          "external_resources": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ExternalResource"
            },
            "description": "Current source-derived human-facing references, ordered by model scope and resource kind. Empty when evidence supplies no usable public reference."
          },
          "collection_memberships": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CollectionMembership"
            }
          },
          "developer_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Canonical model author directory ID; null when author attribution is unknown or only a hosting fallback."
          },
          "provider_prices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PricePointDto"
            },
            "description": "Only present for an inference_provider query. Quotes from that source, preserving route, unit and conditions. Discovery/summary selects media minima and one coherent USD token offering using Input then Output; its rates also determine provider-scoped price ordering. view=offerings returns all published quotes for the provider."
          },
          "price_scope": {
            "type": "string"
          },
          "provider_price_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Total complete quotes for the requested inference provider; discovery returns selected media minima and one coherent basic token offering. Fetch /prices for paged quotes."
          },
          "card_price_points": {
            "type": "array",
            "maxItems": 5,
            "items": {
              "$ref": "#/components/schemas/PricePointDto"
            },
            "description": "One coherent USD token offering for cards: input, output, cached input and cache-write quotes share source, platform, native model ID and exact billing conditions. Preferred base rates precede conditional alternatives; compare Input then Output, missing rates last, and prefer the model developer on equal basic prices (native source before gateway-attributed developer platform). Cache rates never affect selection. Prepared by the worker; independent global minima and full evidence remain separate."
          },
          "official_model_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Publisher-independent official model identifier: the final slash-delimited segment of an established first-party API ID, publisher-matched upstream response ID or exact publisher-owned Hub checkpoint ID. For Ollama family entries, this is the catalog's exact family name, verified against its source record and linked family. Prepared once by the serial pipeline; casing, version and checkpoint suffixes are preserved. Full observed IDs remain in official_identity.value and source profiles. Response evidence must match the model family and any explicit checkpoint date; conflicting IDs remain unknown. Null when not established; neither the gateway route nor TensorTrace canonical ID is a fallback. This string is not globally unique and must not be used as a URL or cross-developer merge key."
          },
          "official_identity": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Provenance for official_model_id. value retains the exact complete observed API/repository identifier or Ollama catalog family name, including publisher or transport namespaces; it is not shortened with official_model_id. Also retains API/repository/family kind, evidence_type (native_catalog or provider_response), original field path, source ID, source model ID, source record ID, source URL, receipt and acquisition time when available, or repository origins."
          },
          "developer_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Display name of the canonical model developer, shared with developer directories; null when author attribution is unknown."
          },
          "task": {
            "type": [
              "string",
              "null"
            ],
            "description": "Prepared model task. A first-party fallback is explicitly attributed in tensortrace_knowledge; source observations remain unchanged."
          },
          "pipeline_tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "Source-reported task tag. Explicit source classification takes priority over first-party fallback rules."
          },
          "tensortrace_knowledge": {
            "$ref": "#/components/schemas/TensorTraceKnowledge",
            "description": "Applied first-party supplements, separate from source observations. Absent when no reviewed rule was needed."
          },
          "distribution_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Active deployment variants for a model family."
          },
          "distribution_summary": {
            "$ref": "#/components/schemas/FamilyDistributionSummary"
          }
        },
        "additionalProperties": true
      },
      "Branding": {
        "type": "object",
        "properties": {
          "company": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BrandAsset"
              },
              {
                "type": "null"
              }
            ]
          },
          "model": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BrandAsset"
              },
              {
                "type": "null"
              }
            ]
          },
          "fallback": {
            "type": "string"
          },
          "attribution_url": {
            "type": "string"
          }
        }
      },
      "BrandAsset": {
        "type": "object",
        "required": [
          "name",
          "logo_url"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "logo_url": {
            "type": "string",
            "description": "Asset path relative to the API host."
          }
        }
      },
      "FieldAssertion": {
        "type": "object",
        "required": [
          "field",
          "value",
          "source_id",
          "source_record_id",
          "confidence"
        ],
        "properties": {
          "field": {
            "type": "string"
          },
          "value": {},
          "source_id": {
            "type": "string"
          },
          "source_record_id": {
            "type": "string"
          },
          "receipt_id": {
            "type": [
              "string",
              "null"
            ],
            "format": "uuid"
          },
          "confidence": {
            "type": "number"
          },
          "retrieved_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "source_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "parser_version": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "IdentityConflict": {
        "type": "object",
        "properties": {
          "source_id": {
            "type": "string"
          },
          "source_model_id": {
            "type": "string"
          },
          "existing_canonical_model_id": {
            "type": "string"
          },
          "proposed_canonical_model_id": {
            "type": "string"
          },
          "detected_at": {
            "type": "string"
          },
          "last_seen_at": {
            "type": "string"
          }
        }
      },
      "ObservationHistory": {
        "type": "object",
        "required": [
          "data",
          "total_count",
          "limit",
          "offset"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "revision_id": {
                  "type": "integer"
                },
                "source_id": {
                  "type": "string"
                },
                "source_record_id": {
                  "type": "string"
                },
                "canonical_model_id": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "receipt_id": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "format": "uuid"
                },
                "payload_sha256": {
                  "type": "string"
                },
                "raw_payload": {},
                "observed_at": {
                  "type": "string",
                  "format": "date-time"
                },
                "retrieved_at": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "format": "date-time"
                },
                "source_url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "parser_version": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            }
          },
          "total_count": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "offset": {
            "type": "integer"
          }
        }
      },
      "NativeProviderModelIdentity": {
        "type": "object",
        "properties": {
          "canonical_model_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "source_model_id": {
            "type": "string"
          }
        },
        "description": "Added to each native provider object. Null canonical_model_id means no confirmed identity; clients must not infer one from names."
      },
      "NativeProviderModelsResponse": {
        "description": "Provider-compatible cached catalog. DeepInfra uses a top-level array; other providers retain their native object wrappers. Each cached model object includes confirmed TensorTrace identity metadata.",
        "oneOf": [
          {
            "type": "object",
            "additionalProperties": true
          },
          {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/NativeProviderModelIdentity"
            }
          }
        ]
      },
      "Distribution": {
        "type": "object",
        "properties": {
          "source_id": {
            "type": "string"
          },
          "source_model_id": {
            "type": "string"
          },
          "family_model_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "canonical_model_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "execution_mode": {
            "type": "string",
            "enum": [
              "local",
              "cloud"
            ]
          },
          "receipt_id": {
            "type": "string",
            "format": "uuid"
          },
          "discovery_receipt_id": {
            "type": "string",
            "format": "uuid"
          },
          "identity_relation": {
            "type": "string",
            "enum": [
              "deployment_of",
              "unresolved"
            ]
          },
          "parameter_count": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1
          },
          "artifact_size_bytes": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1
          },
          "context_window": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1
          },
          "context_window_is_approximate": {
            "type": "boolean"
          },
          "quantization_level": {
            "type": [
              "string",
              "null"
            ]
          },
          "format": {
            "type": [
              "string",
              "null"
            ]
          },
          "capabilities": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "input_modalities": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "supporting_receipt_ids": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            }
          }
        },
        "required": [
          "source_id",
          "source_model_id",
          "family_model_id",
          "canonical_model_id",
          "execution_mode",
          "receipt_id",
          "discovery_receipt_id",
          "identity_relation"
        ],
        "additionalProperties": true
      },
      "DistributionResponse": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Distribution"
            }
          },
          "total_count": {
            "type": "integer",
            "minimum": 0
          }
        },
        "required": [
          "data",
          "total_count"
        ],
        "additionalProperties": true
      },
      "PlatformProfile": {
        "type": "object",
        "description": "Source-backed deployment profile. Absent limits and capabilities remain unknown.",
        "properties": {
          "source_model_id": {
            "type": "string"
          },
          "publisher": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "pipeline_tag": {
            "type": "string"
          },
          "task": {
            "type": "string"
          },
          "hosting": {
            "type": "string",
            "description": "Deployment hosting kind, including cloudflare-hosted, siliconflow-hosted, kling-hosted and third-party. Future source hosting kinds may be added."
          },
          "context_length": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1
          },
          "max_output_tokens": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1
          },
          "max_questions": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1
          },
          "architecture": {
            "type": "object",
            "properties": {
              "input_modalities": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "output_modalities": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          },
          "supported_parameters": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "question_types": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "schema": {
            "type": [
              "object",
              "null"
            ]
          },
          "properties": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object"
            }
          },
          "metadata": {
            "type": [
              "object",
              "null"
            ],
            "description": "Source-scoped original details. BFL includes parameter_constraints, api_operation, checkpoint (official Hub metadata), published_pricing, family and checksummed observations. List prices exclude promotions. CMS/Hub timestamps are not release dates or knowledge cutoffs."
          },
          "tags": {
            "type": [
              "array",
              "null"
            ]
          },
          "provider_details": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object"
            }
          },
          "zdr": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "source_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "source_retrieved_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "checksum_sha256": {
            "type": [
              "string",
              "null"
            ]
          },
          "created_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "source_id": {
            "type": "string"
          },
          "platforms": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "capabilities": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "generation": {
            "$ref": "#/components/schemas/GenerationProfile"
          },
          "embedding_dimensions": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1,
            "description": "Reported default vector dimensions. Task-specific request dimensions may vary; this is not an output-token limit."
          },
          "deployments": {
            "type": "array",
            "description": "Tag-scoped NVIDIA container deployment evidence. Omitted in compact catalog reads; never promoted to canonical hardware requirements.",
            "items": {
              "$ref": "#/components/schemas/NvidiaDeployment"
            }
          },
          "deployment_count": {
            "type": "integer",
            "minimum": 0
          },
          "family_url": {
            "type": "string",
            "description": "Related official model family page; does not establish checkpoint equivalence."
          },
          "api_path": {
            "type": "string",
            "description": "Published BFL operation path. Missing for checkpoint-only and price-only records."
          },
          "availability": {
            "$ref": "#/components/schemas/CursorAvailability"
          }
        },
        "required": [
          "source_model_id",
          "publisher",
          "architecture",
          "hosting",
          "source_id",
          "platforms"
        ],
        "additionalProperties": true
      },
      "GenerationProfile": {
        "type": "object",
        "description": "Source-reported generation capabilities; restrictions apply to the named interface group. Model-independent services are excluded.",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "image",
              "video"
            ]
          },
          "resolutions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "duration_label": {
            "type": [
              "string",
              "null"
            ]
          },
          "aspect_ratios": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "features": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "group": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "supported": {
                  "type": "boolean"
                },
                "restriction": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "id",
                "group",
                "name",
                "supported"
              ],
              "additionalProperties": true
            }
          }
        },
        "required": [
          "kind",
          "resolutions",
          "features"
        ],
        "additionalProperties": true
      },
      "CutoffDateSummary": {
        "type": "object",
        "required": [
          "status",
          "value",
          "precision",
          "observation_count"
        ],
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "unknown",
              "reported",
              "conflict",
              "unresolved"
            ]
          },
          "value": {
            "type": [
              "string",
              "null"
            ]
          },
          "precision": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "year",
              "month",
              "day",
              null
            ]
          },
          "observation_count": {
            "type": "integer",
            "minimum": 0
          }
        }
      },
      "CutoffSummary": {
        "type": "object",
        "required": [
          "knowledge"
        ],
        "properties": {
          "knowledge": {
            "$ref": "#/components/schemas/CutoffDateSummary"
          }
        },
        "description": "Knowledge cutoff includes reported training-data dates. Compatible date precision yields consensus; contradictions remain conflicts. Original date labels and field names remain attributed in specification observations.",
        "additionalProperties": false
      },
      "SpecificationObservation": {
        "type": "object",
        "required": [
          "field",
          "value",
          "normalized_value",
          "precision",
          "scope",
          "source_id",
          "source_record_id",
          "receipt_id"
        ],
        "properties": {
          "field": {
            "type": "string",
            "enum": [
              "knowledge_cutoff",
              "context_length",
              "max_input_tokens",
              "max_output_tokens",
              "embedding_dimensions"
            ]
          },
          "value": {},
          "normalized_value": {
            "type": [
              "string",
              "integer",
              "null"
            ]
          },
          "precision": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "year",
              "month",
              "day",
              null
            ]
          },
          "scope": {
            "const": "source-model"
          },
          "source_id": {
            "type": "string"
          },
          "source_record_id": {
            "type": "string"
          },
          "receipt_id": {
            "type": [
              "string",
              "null"
            ],
            "format": "uuid"
          },
          "confidence": {
            "type": "number"
          },
          "retrieved_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "parser_version": {
            "type": [
              "string",
              "null"
            ]
          },
          "source_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "reported_field": {
            "type": "string",
            "description": "Original source date field before normalization to knowledge_cutoff, such as training_data_cutoff. Raw source payloads remain unchanged."
          }
        }
      },
      "ExternalResourceOrigin": {
        "type": "object",
        "required": [
          "source_id",
          "source_name",
          "source_record_id",
          "receipt_id",
          "field",
          "scope"
        ],
        "properties": {
          "source_id": {
            "type": "string"
          },
          "source_name": {
            "type": "string"
          },
          "source_record_id": {
            "type": "string"
          },
          "receipt_id": {
            "type": [
              "string",
              "null"
            ],
            "format": "uuid"
          },
          "field": {
            "type": "string",
            "description": "Observed field or source-owned identifier used to construct this reference."
          },
          "scope": {
            "type": "string",
            "enum": [
              "model",
              "related",
              "catalog"
            ]
          },
          "repository_match": {
            "$ref": "#/components/schemas/RepositoryMatchEvidence"
          }
        }
      },
      "ExternalResource": {
        "type": "object",
        "required": [
          "url",
          "title",
          "kind",
          "scope",
          "host",
          "origins",
          "destination"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "pattern": "^https://"
          },
          "title": {
            "type": "string",
            "description": "Destination website and reference purpose. Attribution remains in origins."
          },
          "host": {
            "type": "string"
          },
          "kind": {
            "type": "string",
            "enum": [
              "official",
              "repository",
              "platform",
              "documentation",
              "paper",
              "code",
              "license",
              "evaluation",
              "catalog"
            ]
          },
          "scope": {
            "type": "string",
            "enum": [
              "model",
              "related",
              "catalog"
            ]
          },
          "origins": {
            "type": "array",
            "minItems": 1,
            "items": {
              "$ref": "#/components/schemas/ExternalResourceOrigin"
            }
          },
          "destination": {
            "$ref": "#/components/schemas/ExternalResourceDestination"
          }
        },
        "description": "Deduplicated, attributed public reference. Links do not assert equivalent checkpoints, successful HTTP reachability or a live inference offer."
      },
      "MetricPercentiles": {
        "type": "object",
        "required": [
          "p50",
          "p75",
          "p90",
          "p99"
        ],
        "properties": {
          "p50": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0
          },
          "p75": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0
          },
          "p90": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0
          },
          "p99": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0
          }
        }
      },
      "WorkloadMetrics": {
        "type": "object",
        "required": [
          "latency_seconds",
          "latency_kind",
          "throughput_tokens_per_second",
          "request_count"
        ],
        "properties": {
          "latency_seconds": {
            "$ref": "#/components/schemas/MetricPercentiles"
          },
          "latency_kind": {
            "type": "string",
            "enum": [
              "end_to_end",
              "time_to_first_token",
              "time_to_first_token_or_result"
            ]
          },
          "throughput_tokens_per_second": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/MetricPercentiles"
              },
              {
                "type": "null"
              }
            ]
          },
          "request_count": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0
          }
        }
      },
      "EndpointMetric": {
        "type": "object",
        "required": [
          "provider_name",
          "route",
          "endpoint_name",
          "status",
          "latency_seconds",
          "latency_kind",
          "throughput_tokens_per_second",
          "uptime_percent",
          "workloads"
        ],
        "properties": {
          "provider_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "route": {
            "type": [
              "string",
              "null"
            ]
          },
          "endpoint_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "type": [
              "integer",
              "null"
            ]
          },
          "latency_seconds": {
            "$ref": "#/components/schemas/MetricPercentiles"
          },
          "latency_kind": {
            "const": "time_to_first_token"
          },
          "throughput_tokens_per_second": {
            "$ref": "#/components/schemas/MetricPercentiles"
          },
          "uptime_percent": {
            "type": "object",
            "required": [
              "last_5m",
              "last_30m",
              "last_1d"
            ],
            "properties": {
              "last_5m": {
                "type": [
                  "number",
                  "null"
                ],
                "minimum": 0,
                "maximum": 100
              },
              "last_30m": {
                "type": [
                  "number",
                  "null"
                ],
                "minimum": 0,
                "maximum": 100
              },
              "last_1d": {
                "type": [
                  "number",
                  "null"
                ],
                "minimum": 0,
                "maximum": 100
              }
            }
          },
          "workloads": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": {
              "$ref": "#/components/schemas/WorkloadMetrics"
            }
          }
        },
        "description": "One provider route in the captured OpenRouter snapshot. Legacy latency is TTFT in seconds after conversion from source milliseconds. Uptime is successful/(successful+error) requests times 100, excluding rate-limited requests; it is not time-based availability. Null is unreported, never zero."
      },
      "ModelMetricsResponse": {
        "type": "object",
        "required": [
          "canonical_model_id",
          "source_id",
          "source_model_id",
          "source_url",
          "retrieved_at",
          "stale",
          "coverage",
          "window",
          "providers"
        ],
        "properties": {
          "canonical_model_id": {
            "type": "string"
          },
          "source_id": {
            "const": "openRouter"
          },
          "source_model_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "source_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "retrieved_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "stale": {
            "type": "boolean"
          },
          "coverage": {
            "enum": [
              "listed",
              "not_listed"
            ]
          },
          "window": {
            "const": "30m"
          },
          "providers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EndpointMetric"
            }
          }
        },
        "description": "Exact source snapshot metadata. An unlisted model has no OpenRouter routing alias; listed is catalog coverage, not an inference health assertion. First-fetch failure returns 503."
      },
      "ListedQuoteObservation": {
        "type": "object",
        "required": [
          "source_model_id",
          "receipt_id",
          "source_url",
          "observed_at",
          "unit",
          "amount_usd",
          "currency",
          "raw_field",
          "original_amount",
          "source_pricing"
        ],
        "properties": {
          "source_model_id": {
            "type": "string"
          },
          "receipt_id": {
            "type": "string",
            "format": "uuid"
          },
          "source_url": {
            "type": "string"
          },
          "observed_at": {
            "type": "string",
            "format": "date-time"
          },
          "unit": {
            "enum": [
              "input_tokens_per_million",
              "output_tokens_per_million"
            ]
          },
          "amount_usd": {
            "type": "number",
            "minimum": 0
          },
          "currency": {
            "const": "USD"
          },
          "raw_field": {
            "type": "string"
          },
          "original_amount": {},
          "source_pricing": {
            "type": "object"
          }
        }
      },
      "ModelPriceHistoryResponse": {
        "type": "object",
        "required": [
          "canonical_model_id",
          "source_id",
          "quote_kind",
          "data",
          "total_observations",
          "returned_observations",
          "limit",
          "offset",
          "has_more"
        ],
        "properties": {
          "canonical_model_id": {
            "type": "string"
          },
          "source_id": {
            "const": "openRouter"
          },
          "quote_kind": {
            "const": "listed_catalog_quote"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ListedQuoteObservation"
            }
          },
          "total_observations": {
            "type": "integer",
            "minimum": 0
          },
          "returned_observations": {
            "type": "integer",
            "minimum": 0
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 1000
          },
          "offset": {
            "type": "integer",
            "minimum": 0
          },
          "has_more": {
            "type": "boolean"
          }
        },
        "description": "Immutable catalog quote observations, including evidenced canonical redirect lineage. Pagination counts raw observations; an observation can yield zero, one or two reviewed token quotes. Times are source retrieval times, not effective price-change times or actual customer payments. Pages select newest observations first; each page returns points chronologically."
      },
      "CopilotModelsResponse": {
        "type": "object",
        "required": [
          "source_id",
          "models",
          "count",
          "total",
          "limit",
          "offset"
        ],
        "properties": {
          "source_id": {
            "const": "githubCopilot"
          },
          "models": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "source_id",
                "source_model_id",
                "canonical_model_id",
                "metadata",
                "revision",
                "receipt_id"
              ],
              "properties": {
                "source_id": {
                  "const": "githubCopilot"
                },
                "source_model_id": {
                  "type": "string"
                },
                "canonical_model_id": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "revision": {
                  "type": "string",
                  "pattern": "^[a-fA-F0-9]{40}$"
                },
                "receipt_id": {
                  "type": "string",
                  "format": "uuid"
                },
                "metadata": {
                  "type": "object"
                }
              },
              "additionalProperties": true
            }
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "total": {
            "type": "integer",
            "minimum": 0
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 1000
          },
          "offset": {
            "type": "integer",
            "minimum": 0
          }
        }
      },
      "RepositoryMatchEvidence": {
        "type": "object",
        "required": [
          "rule",
          "source_id",
          "source_record_id",
          "canonical_model_id",
          "receipt_id",
          "field"
        ],
        "properties": {
          "rule": {
            "type": "string",
            "enum": [
              "same-publisher-exact-model-name"
            ]
          },
          "source_id": {
            "type": "string",
            "enum": [
              "huggingFace"
            ]
          },
          "source_record_id": {
            "type": "string"
          },
          "canonical_model_id": {
            "type": "string"
          },
          "receipt_id": {
            "type": "string",
            "format": "uuid"
          },
          "field": {
            "type": "string",
            "enum": [
              "source_record_id"
            ]
          }
        },
        "description": "Optional evidence for an exact publisher and repository-name link to an indexed Hugging Face observation. The outer origin identifies the current model record; this evidence identifies the independent repository record and its receipt. No identities or model facts are merged."
      },
      "CollectionMembership": {
        "type": "object",
        "description": "Current curated selection, not a rank or capability; removed with the next successful complete snapshot.",
        "properties": {
          "source_id": {
            "type": "string"
          },
          "source_name": {
            "type": "string"
          },
          "source_record_id": {
            "type": "string"
          },
          "receipt_id": {
            "type": "string",
            "format": "uuid"
          },
          "collection_id": {
            "type": "string"
          },
          "collection_title": {
            "type": "string"
          },
          "collection_url": {
            "type": "string",
            "format": "uri"
          },
          "repository_id": {
            "type": "string"
          },
          "repository_url": {
            "type": "string",
            "format": "uri"
          },
          "kind": {
            "const": "curated_selection"
          },
          "label": {
            "type": "string"
          },
          "position": {
            "type": "integer",
            "minimum": 0,
            "description": "Order within collection, not benchmark rank."
          },
          "source_updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "observed_at": {
            "type": "string",
            "format": "date-time"
          },
          "note": {
            "type": [
              "string",
              "null"
            ],
            "description": "Attributed original source note; may describe an older evaluation."
          }
        },
        "required": [
          "source_id",
          "source_name",
          "source_record_id",
          "receipt_id",
          "collection_id",
          "collection_title",
          "collection_url",
          "repository_id",
          "repository_url",
          "kind",
          "label",
          "position",
          "source_updated_at",
          "observed_at"
        ]
      },
      "RefreshPolicy": {
        "type": "object",
        "properties": {
          "mode": {
            "type": "string",
            "enum": [
              "scheduled",
              "disabled",
              "needsConfiguration",
              "derived",
              "unavailable",
              "paused"
            ]
          },
          "adapter_supported": {
            "type": "boolean"
          },
          "configured": {
            "type": "boolean"
          },
          "scheduler_enabled": {
            "type": "boolean"
          },
          "scheduler_interval_seconds": {
            "type": "integer",
            "minimum": 1
          },
          "parent_source_id": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "mode",
          "adapter_supported",
          "configured",
          "scheduler_enabled",
          "scheduler_interval_seconds",
          "parent_source_id"
        ]
      },
      "InsightEntry": {
        "type": "object",
        "required": [
          "source_record_id",
          "canonical_model_id",
          "label",
          "organization",
          "score",
          "rank",
          "confidence_lower",
          "confidence_upper",
          "sample_size",
          "sample_unit",
          "cost_usd",
          "latency_seconds",
          "profile",
          "submitted_at",
          "checked",
          "warning"
        ],
        "properties": {
          "source_record_id": {
            "type": "string"
          },
          "canonical_model_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "label": {
            "type": "string"
          },
          "organization": {
            "type": [
              "string",
              "null"
            ]
          },
          "score": {
            "type": "number"
          },
          "rank": {
            "type": [
              "integer",
              "null"
            ]
          },
          "confidence_lower": {
            "type": [
              "number",
              "null"
            ]
          },
          "confidence_upper": {
            "type": [
              "number",
              "null"
            ]
          },
          "sample_size": {
            "type": [
              "integer",
              "null"
            ]
          },
          "sample_unit": {
            "type": [
              "string",
              "null"
            ]
          },
          "cost_usd": {
            "type": [
              "number",
              "null"
            ],
            "description": "BFCL estimated cost of the entire benchmark in USD; not per-token or per-task price."
          },
          "latency_seconds": {
            "type": [
              "number",
              "null"
            ],
            "description": "BFCL mean call latency, seconds."
          },
          "profile": {
            "type": [
              "string",
              "null"
            ]
          },
          "submitted_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "checked": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "warning": {
            "type": [
              "string",
              "null"
            ]
          },
          "model_url": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri",
            "description": "Model URL preserved from the original result or official publisher metadata. Use only when canonical_model_id is null; no URL means plain text."
          }
        },
        "additionalProperties": false
      },
      "InsightBoard": {
        "type": "object",
        "required": [
          "id",
          "title",
          "source_id",
          "source_url",
          "metric",
          "unit",
          "methodology",
          "published_at",
          "retrieved_at",
          "receipt_id",
          "source_record_count",
          "scored_entry_count",
          "linked_entry_count",
          "entries"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "source_id": {
            "type": "string"
          },
          "source_url": {
            "type": "string",
            "format": "uri"
          },
          "metric": {
            "type": "string"
          },
          "unit": {
            "type": "string",
            "enum": [
              "rating",
              "percent"
            ]
          },
          "methodology": {
            "type": "string"
          },
          "published_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "retrieved_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "receipt_id": {
            "type": [
              "string",
              "null"
            ],
            "format": "uuid"
          },
          "source_record_count": {
            "type": "integer",
            "minimum": 0
          },
          "scored_entry_count": {
            "type": "integer",
            "minimum": 0
          },
          "linked_entry_count": {
            "type": "integer",
            "minimum": 0
          },
          "entries": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/InsightEntry"
            }
          }
        },
        "additionalProperties": false
      },
      "InsightsResponse": {
        "type": "object",
        "required": [
          "boards"
        ],
        "properties": {
          "boards": {
            "type": "array",
            "maxItems": 13,
            "items": {
              "$ref": "#/components/schemas/InsightBoard"
            }
          }
        },
        "additionalProperties": false
      },
      "NvidiaDeployment": {
        "type": "object",
        "required": [
          "resource_id",
          "source_url",
          "retrieved_at",
          "checksum_sha256",
          "metadata_status"
        ],
        "properties": {
          "resource_id": {
            "type": "string"
          },
          "tag": {
            "type": "string"
          },
          "source_url": {
            "type": "string",
            "format": "uri"
          },
          "retrieved_at": {
            "type": "string",
            "format": "date-time"
          },
          "checksum_sha256": {
            "type": "string"
          },
          "metadata_status": {
            "type": "string",
            "enum": [
              "available",
              "restricted",
              "not_found",
              "not_reported",
              "outside_nim_namespace"
            ]
          },
          "container": {
            "type": "object",
            "additionalProperties": true
          },
          "metadata_source_url": {
            "type": "string",
            "format": "uri"
          },
          "metadata_checksum_sha256": {
            "type": "string"
          },
          "metadata_retrieved_at": {
            "type": "string",
            "format": "date-time"
          },
          "metadata": {
            "type": "object",
            "additionalProperties": true,
            "description": "Complete reported NIM Metadata JSON for this resource/tag, including unknown future fields. Missing values differ from false/zero. Hardware memory is per device; non-standard throughput is not a comparable benchmark.",
            "properties": {
              "profiles": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": true,
                  "required": [
                    "profile_id"
                  ],
                  "properties": {
                    "profile_id": {
                      "type": "string"
                    }
                  }
                }
              },
              "features": {
                "type": "object",
                "additionalProperties": true
              },
              "release_details": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        }
      },
      "ProviderStatus": {
        "type": "object",
        "description": "Live serving-platform status, independent of catalog ingestion and individual model endpoint health. Unverified/failing/stale feeds have state unknown. Last reported state is retained separately. All times are UTC. Raw evidence and checks are retained seven days plus the last successful evidence.",
        "required": [
          "source_id",
          "display_name",
          "state",
          "freshness",
          "scope",
          "feed_urls",
          "poll_interval_seconds",
          "scheduler_enabled",
          "history_retention_days"
        ],
        "properties": {
          "source_id": {
            "type": "string"
          },
          "display_name": {
            "type": "string"
          },
          "scope": {
            "type": "string"
          },
          "page_url": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "format": {
            "type": [
              "string",
              "null"
            ]
          },
          "feed_urls": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uri"
            }
          },
          "component_ids": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "group_ids": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "note": {
            "type": [
              "string",
              "null"
            ]
          },
          "state": {
            "type": "string",
            "enum": [
              "operational",
              "degraded",
              "partial_outage",
              "major_outage",
              "maintenance",
              "incident_reported",
              "no_reported_incidents",
              "unknown"
            ]
          },
          "freshness": {
            "type": "string",
            "enum": [
              "fresh",
              "stale",
              "fetch_failed",
              "not_checked",
              "unverified"
            ]
          },
          "reported_state": {
            "type": [
              "string",
              "null"
            ]
          },
          "checked_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "last_success_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "expires_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "consecutive_failures": {
            "type": "integer"
          },
          "error_message": {
            "type": [
              "string",
              "null"
            ]
          },
          "snapshot": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "state": {
                "type": "string"
              },
              "source_updated_at": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time"
              },
              "measurement_expires_at": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time"
              },
              "components": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "id",
                    "name",
                    "state",
                    "reported_state"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "state": {
                      "type": "string"
                    },
                    "reported_state": {
                      "type": "string"
                    },
                    "details": {
                      "type": [
                        "object",
                        "null"
                      ]
                    }
                  }
                }
              },
              "incidents": {
                "type": "array",
                "items": {
                  "type": "object"
                }
              },
              "scheduled_maintenances": {
                "type": "array",
                "items": {
                  "type": "object"
                }
              }
            }
          },
          "evidence": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "url",
                "checksum_sha256",
                "retrieved_at"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "format": "uri"
                },
                "checksum_sha256": {
                  "type": "string"
                },
                "retrieved_at": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          },
          "poll_interval_seconds": {
            "type": "integer"
          },
          "scheduler_enabled": {
            "type": "boolean"
          },
          "history_retention_days": {
            "type": "integer"
          }
        }
      },
      "Organization": {
        "type": "object",
        "required": [
          "id",
          "name",
          "role",
          "model_count",
          "description",
          "catalog_scope"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "role": {
            "type": "string",
            "enum": [
              "developer",
              "inference_provider"
            ]
          },
          "model_count": {
            "type": "integer",
            "minimum": 0
          },
          "description": {
            "type": "string",
            "description": "Collected short introduction; empty when no usable official description has been collected."
          },
          "catalog_scope": {
            "type": "string"
          },
          "aliases": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "logo_url": {
            "type": "string"
          },
          "homepage": {
            "type": [
              "string",
              "null"
            ]
          },
          "source_status": {
            "type": "string"
          },
          "observed_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "offering_count": {
            "type": "integer"
          },
          "priced_model_count": {
            "type": "integer"
          },
          "best_model": {
            "type": [
              "object",
              "null"
            ],
            "required": [
              "canonical_model_id",
              "name",
              "intelligence_index",
              "capability_score",
              "best_rating"
            ],
            "properties": {
              "canonical_model_id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "provider": {
                "type": "string",
                "description": "Publisher of the prepared leading model; omitted if that model is unavailable."
              },
              "branding": {
                "$ref": "#/components/schemas/Branding",
                "description": "Branding from the prepared leading model, including its model-family logo when known; omitted if that model is unavailable."
              },
              "intelligence_index": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "capability_score": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "best_rating": {
                "type": [
                  "number",
                  "null"
                ]
              }
            }
          },
          "governance": {
            "type": "array",
            "description": "Developer company disclosure assessments, prepared independently of model matches. Empty when no assessment is recorded; omitted for inference providers.",
            "items": {
              "$ref": "#/components/schemas/OrganizationGovernanceFinding"
            }
          },
          "leading_models": {
            "type": "array",
            "maxItems": 3,
            "description": "Up to three leaders from the developer's models or inference provider's catalog, ordered by intelligence, capability, benchmark rating, name and canonical ID. Publisher aliases are combined for developers and each canonical model appears once. Empty when no models are available; omitted by older prepared directories. Developer best_model is retained as the first entry for compatibility.",
            "items": {
              "$ref": "#/components/schemas/ProviderLeadingModel"
            }
          },
          "profile": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/OrganizationProfile"
              },
              {
                "type": "null"
              }
            ],
            "description": "Worker-collected company or inference-service profile. Null when unavailable; collection never runs in API requests."
          }
        }
      },
      "OrganizationDirectory": {
        "type": "object",
        "required": [
          "data",
          "total_count",
          "offset",
          "limit"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Organization"
            }
          },
          "total_count": {
            "type": "integer"
          },
          "offset": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          }
        }
      },
      "PublicUser": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "username": {
            "type": "string",
            "maxLength": 15
          },
          "display_name": {
            "type": "string",
            "maxLength": 100
          },
          "avatar_url": {
            "type": "string"
          },
          "avatar_fallback": {
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "id",
          "username",
          "display_name",
          "avatar_url",
          "avatar_fallback",
          "created_at"
        ]
      },
      "Account": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PublicUser"
          },
          {
            "type": "object",
            "properties": {
              "email": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "first_name": {
                "type": "string"
              },
              "last_name": {
                "type": "string"
              },
              "username_confirmed": {
                "type": "boolean"
              },
              "identities": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "required": [
              "email",
              "username_confirmed",
              "identities"
            ]
          }
        ]
      },
      "AccountSession": {
        "type": "object",
        "properties": {
          "user": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Account"
              },
              {
                "type": "null"
              }
            ]
          },
          "csrf_token": {
            "type": "string"
          }
        },
        "required": [
          "user",
          "csrf_token"
        ]
      },
      "ProfileUpdate": {
        "type": "object",
        "properties": {
          "username": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_][A-Za-z0-9_-]{0,14}$",
            "description": "Globally unique username: 1–15 ASCII letters, digits, underscores or hyphens. Case-insensitive collisions and reserved names are rejected. Updating also confirms a generated candidate."
          },
          "display_name": {
            "type": "string",
            "maxLength": 100,
            "description": "Optional public display name; does not need to be globally unique."
          },
          "first_name": {
            "type": "string",
            "maxLength": 100,
            "description": "Optional first name from the account profile."
          },
          "last_name": {
            "type": "string",
            "maxLength": 100,
            "description": "Optional last name from the account profile."
          }
        },
        "required": [
          "username"
        ]
      },
      "CommentReference": {
        "type": "object",
        "properties": {
          "text": {
            "type": "string"
          },
          "kind": {
            "type": "string",
            "enum": [
              "user",
              "topic",
              "stock",
              "model"
            ]
          },
          "href": {
            "type": "string"
          },
          "user_id": {
            "type": "string",
            "format": "uuid"
          },
          "model_id": {
            "type": "string"
          }
        },
        "required": [
          "text",
          "kind",
          "href"
        ]
      },
      "CommunityComment": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "author": {
            "$ref": "#/components/schemas/PublicUser"
          },
          "model_id": {
            "type": "string"
          },
          "model_name": {
            "type": "string"
          },
          "body": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1024
          },
          "references": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CommentReference"
            }
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "id",
          "author",
          "model_id",
          "body",
          "references",
          "created_at"
        ]
      },
      "CommentPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CommunityComment"
            }
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "data",
          "next_cursor"
        ]
      },
      "CursorModelsResponse": {
        "type": "object",
        "required": [
          "source_id",
          "models",
          "count",
          "total",
          "limit",
          "offset"
        ],
        "properties": {
          "source_id": {
            "const": "cursor"
          },
          "models": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "source_id",
                "source_model_id",
                "canonical_model_id",
                "metadata",
                "receipt_id",
                "availability"
              ],
              "properties": {
                "source_id": {
                  "const": "cursor"
                },
                "source_model_id": {
                  "type": "string"
                },
                "canonical_model_id": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "receipt_id": {
                  "type": "string",
                  "format": "uuid"
                },
                "metadata": {
                  "type": "object",
                  "properties": {
                    "display_name": {
                      "type": "string"
                    },
                    "description": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "identity_link": {
                      "enum": [
                        "unique_publisher_exact_id",
                        "unmatched_or_ambiguous"
                      ]
                    },
                    "publisher_basis": {
                      "type": "string"
                    },
                    "aliases": {
                      "type": [
                        "array",
                        "null"
                      ],
                      "items": {
                        "type": "string"
                      }
                    },
                    "parameters": {
                      "type": [
                        "array",
                        "null"
                      ],
                      "items": {
                        "$ref": "#/components/schemas/CursorParameter"
                      }
                    },
                    "variants": {
                      "type": [
                        "array",
                        "null"
                      ],
                      "items": {
                        "$ref": "#/components/schemas/CursorVariant"
                      }
                    }
                  },
                  "additionalProperties": true
                },
                "availability": {
                  "$ref": "#/components/schemas/CursorAvailability"
                }
              },
              "additionalProperties": true
            }
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "total": {
            "type": "integer",
            "minimum": 0
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 1000
          },
          "offset": {
            "type": "integer",
            "minimum": 0
          }
        },
        "description": "Cursor recommended agent models for the configured account/team only. Includes unmatched observations and routing IDs, with null canonical_model_id. Platform aliases/parameters/variants do not establish model identity, universal access or token prices. Empty before the first authenticated refresh. Updated every six hours when CURSOR_API_KEY is configured."
      },
      "CursorAvailability": {
        "type": "object",
        "required": [
          "status",
          "scope",
          "surface",
          "coverage",
          "observed_at"
        ],
        "properties": {
          "status": {
            "const": "listed"
          },
          "scope": {
            "const": "configured_account_team"
          },
          "surface": {
            "const": "agents_api"
          },
          "coverage": {
            "const": "recommended_models"
          },
          "observed_at": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "CursorParameterValue": {
        "type": "object",
        "required": [
          "value"
        ],
        "properties": {
          "value": {
            "type": "string"
          },
          "displayName": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": true
      },
      "CursorParameter": {
        "type": "object",
        "required": [
          "id",
          "values"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "displayName": {
            "type": [
              "string",
              "null"
            ]
          },
          "values": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CursorParameterValue"
            }
          }
        },
        "additionalProperties": true
      },
      "CursorVariant": {
        "type": "object",
        "required": [
          "displayName",
          "params"
        ],
        "properties": {
          "displayName": {
            "type": "string"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "isDefault": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "params": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "value"
              ],
              "properties": {
                "id": {
                  "type": "string"
                },
                "value": {
                  "type": "string"
                }
              }
            }
          }
        },
        "additionalProperties": true
      },
      "ModelPage": {
        "type": "object",
        "required": [
          "data",
          "total_count",
          "limit",
          "offset"
        ],
        "properties": {
          "data": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/CatalogModel"
            }
          },
          "total_count": {
            "type": "integer",
            "minimum": 0
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100
          },
          "offset": {
            "type": "integer",
            "minimum": 0
          }
        }
      },
      "DirectoryPage": {
        "type": "object",
        "required": [
          "data",
          "total_count",
          "limit",
          "offset"
        ],
        "properties": {
          "data": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/Organization"
            }
          },
          "total_count": {
            "type": "integer",
            "minimum": 0
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100
          },
          "offset": {
            "type": "integer",
            "minimum": 0
          }
        }
      },
      "CatalogFacets": {
        "type": "object",
        "required": [
          "models",
          "model_sources"
        ],
        "properties": {
          "models": {
            "$ref": "#/components/schemas/ModelFacetsDto"
          },
          "model_sources": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "value",
                "label"
              ],
              "properties": {
                "value": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "CatalogOverview": {
        "type": "object",
        "properties": {
          "total_models": {
            "type": "integer"
          },
          "free_models": {
            "type": "integer"
          },
          "paid_models": {
            "type": "integer"
          },
          "multimodal_models": {
            "type": "integer"
          },
          "reasoning_models": {
            "type": "integer"
          },
          "tool_calling_models": {
            "type": "integer"
          },
          "best_context_window": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "average_capability_score": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "latest_refresh_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "model_count": {
            "type": "integer",
            "minimum": 0
          },
          "family_count": {
            "type": "integer",
            "minimum": 0
          },
          "distribution_count": {
            "type": "integer",
            "minimum": 0
          }
        },
        "required": [
          "total_models",
          "free_models",
          "paid_models",
          "multimodal_models",
          "reasoning_models",
          "tool_calling_models",
          "model_count",
          "family_count",
          "distribution_count"
        ]
      },
      "ModelPricePage": {
        "type": "object",
        "required": [
          "data",
          "platform_profiles",
          "total_count",
          "limit",
          "offset"
        ],
        "properties": {
          "data": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/PricePointDto"
            }
          },
          "platform_profiles": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PlatformProfile"
            }
          },
          "total_count": {
            "type": "integer",
            "minimum": 0
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100
          },
          "offset": {
            "type": "integer",
            "minimum": 0
          }
        }
      },
      "ModelOverview": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "canonical_model_id",
          "model",
          "capabilities",
          "benchmark_score_counts",
          "sections"
        ],
        "properties": {
          "canonical_model_id": {
            "type": "string"
          },
          "model": {
            "$ref": "#/components/schemas/CatalogModel"
          },
          "capabilities": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "benchmark_score_counts": {
            "type": "object",
            "additionalProperties": {
              "type": "integer",
              "minimum": 0
            }
          },
          "sections": {
            "type": "object",
            "additionalProperties": {
              "type": "integer",
              "minimum": 0
            }
          },
          "references": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ContentReference"
            },
            "maxItems": 20,
            "description": "Exactly anchored model/distribution metadata. Base-model or derived-from relationships do not establish identity."
          }
        }
      },
      "DetailSectionPage": {
        "type": "object",
        "required": [
          "data",
          "total_count",
          "limit",
          "offset"
        ],
        "properties": {
          "data": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "type": "object"
            }
          },
          "total_count": {
            "type": "integer",
            "minimum": 0
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100
          },
          "offset": {
            "type": "integer",
            "minimum": 0
          }
        }
      },
      "SourceLinkCorrection": {
        "type": "object",
        "description": "Audited canonical association repair; the original receipt and observation history are unchanged.",
        "properties": {
          "source_id": {
            "type": "string"
          },
          "source_record_id": {
            "type": "string"
          },
          "previous_model_id": {
            "type": "string"
          },
          "reason": {
            "type": "string"
          },
          "receipt_id": {
            "type": "string",
            "format": "uuid"
          },
          "canonical_model_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "evidence": {
            "type": "object",
            "additionalProperties": true
          },
          "corrected_at": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "source_id",
          "source_record_id",
          "receipt_id",
          "previous_model_id",
          "canonical_model_id",
          "reason",
          "evidence",
          "corrected_at"
        ]
      },
      "ExternalResourceDestination": {
        "type": "object",
        "required": [
          "id",
          "name"
        ],
        "properties": {
          "id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Recognized destination platform branding ID, independent of origin source IDs. Null for unrecognized hosts.",
            "minLength": 1
          },
          "name": {
            "type": "string",
            "description": "Target website name, or its exact hostname when unrecognized.",
            "minLength": 1
          }
        },
        "description": "Derived from the reference URL at preparation time; never inferred from the observation source."
      },
      "OrganizationGovernanceFinding": {
        "type": "object",
        "description": "Company disclosure assessment from the original organization record. Not a score of any individual model.",
        "required": [
          "source_id",
          "source_record_id",
          "scope",
          "score",
          "unit"
        ],
        "properties": {
          "source_id": {
            "type": "string"
          },
          "source_record_id": {
            "type": "string"
          },
          "receipt_id": {
            "type": [
              "string",
              "null"
            ],
            "format": "uuid"
          },
          "source_url": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "observed_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "scope": {
            "type": "string",
            "enum": [
              "organization"
            ]
          },
          "score": {
            "type": "number"
          },
          "unit": {
            "type": "string",
            "enum": [
              "score"
            ]
          },
          "organization": {
            "type": [
              "string",
              "null"
            ]
          },
          "benchmark_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "benchmark_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "assessment_type": {
            "type": [
              "string",
              "null"
            ]
          },
          "hazard_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "metric": {
            "type": [
              "string",
              "null"
            ]
          },
          "result_label": {
            "type": [
              "string",
              "null"
            ]
          },
          "max_score": {
            "type": [
              "number",
              "null"
            ]
          },
          "indicator_count": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0
          },
          "disclosed_indicator_count": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0
          },
          "partial_indicator_count": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0
          }
        }
      },
      "OfflineManifest": {
        "type": "object",
        "required": [
          "schema",
          "generation",
          "generated_at",
          "model_count",
          "chunks"
        ],
        "properties": {
          "schema": {
            "type": "integer",
            "const": 1
          },
          "generation": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "model_count": {
            "type": "integer"
          },
          "chunks": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "kind",
                "sha256",
                "bytes",
                "rows"
              ],
              "properties": {
                "id": {
                  "type": "string"
                },
                "kind": {
                  "type": "string",
                  "enum": [
                    "models",
                    "boards",
                    "metadata"
                  ]
                },
                "sha256": {
                  "type": "string",
                  "pattern": "^[0-9a-f]{64}$"
                },
                "bytes": {
                  "type": "integer"
                },
                "rows": {
                  "type": "integer"
                }
              }
            }
          }
        }
      },
      "TensorTraceKnowledge": {
        "type": "object",
        "description": "Versioned TensorTrace knowledge applied during serial preparation. Shared by discovery, detail and offline documents.",
        "required": [
          "revision",
          "applied_rules"
        ],
        "properties": {
          "revision": {
            "type": "integer",
            "minimum": 1
          },
          "applied_rules": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TensorTraceKnowledgeRule"
            }
          }
        },
        "additionalProperties": false
      },
      "TensorTraceKnowledgeRule": {
        "type": "object",
        "description": "Attribution for a reviewed first-party fallback. This is not an acquired source observation or proof of model equivalence.",
        "required": [
          "rule_id",
          "rule_revision",
          "reviewed_at",
          "kind",
          "field",
          "value",
          "references"
        ],
        "properties": {
          "rule_id": {
            "type": "string"
          },
          "rule_revision": {
            "type": "integer",
            "minimum": 1
          },
          "reviewed_at": {
            "type": "string",
            "format": "date"
          },
          "kind": {
            "type": "string",
            "enum": [
              "model_type_fallback"
            ]
          },
          "field": {
            "type": "string",
            "enum": [
              "task"
            ]
          },
          "value": {
            "type": "string",
            "enum": [
              "text-generation"
            ]
          },
          "references": {
            "type": "array",
            "minItems": 1,
            "items": {
              "type": "string",
              "format": "uri"
            }
          }
        },
        "additionalProperties": false
      },
      "FamilyDistributionSummary": {
        "type": "object",
        "additionalProperties": false,
        "description": "Prepared counts of active family deployments, independent of paged artifact rows. Base models count distinct confirmed canonical links.",
        "required": [
          "variants",
          "local",
          "cloud",
          "confirmed_base_models"
        ],
        "properties": {
          "variants": {
            "type": "integer",
            "minimum": 0
          },
          "local": {
            "type": "integer",
            "minimum": 0
          },
          "cloud": {
            "type": "integer",
            "minimum": 0
          },
          "confirmed_base_models": {
            "type": "integer",
            "minimum": 0
          }
        }
      },
      "NewsPublisher": {
        "type": "object",
        "required": [
          "name",
          "url"
        ],
        "properties": {
          "role": {
            "type": "string",
            "enum": [
              "official",
              "media",
              "author"
            ],
            "description": "Optional curated feed publisher classification, not a verification of its claims."
          },
          "name": {
            "type": "string",
            "description": "Selected article publisher."
          },
          "url": {
            "type": "string",
            "description": "Publisher homepage, or empty if unsafe."
          },
          "icon_url": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri",
            "description": "Optional declared publisher icon from Mercury; unsafe URLs are removed."
          }
        },
        "additionalProperties": false
      },
      "NewsContext": {
        "type": "object",
        "required": [
          "kind",
          "model_id",
          "developer",
          "model_terms",
          "developer_terms",
          "keywords",
          "operator",
          "language"
        ],
        "properties": {
          "kind": {
            "type": "string",
            "description": "Context chosen by the server.",
            "enum": [
              "topic",
              "model"
            ]
          },
          "model_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Resolved canonical model, null for topic feed."
          },
          "developer": {
            "type": [
              "string",
              "null"
            ],
            "description": "Indexed developer, null if unreported."
          },
          "model_terms": {
            "type": "array",
            "description": "Derived model spellings.",
            "items": {
              "type": "string"
            }
          },
          "developer_terms": {
            "type": "array",
            "description": "Derived developer terms with AI qualifiers where necessary.",
            "items": {
              "type": "string"
            }
          },
          "keywords": {
            "type": "array",
            "description": "Effective query entries, normalized by the shared search engine.",
            "items": {
              "type": "string"
            }
          },
          "operator": {
            "type": "string",
            "enum": [
              "and",
              "or"
            ]
          },
          "language": {
            "type": "string",
            "maxLength": 63
          }
        },
        "additionalProperties": false
      },
      "NewsArticle": {
        "type": "object",
        "required": [
          "id",
          "title",
          "summary",
          "url",
          "source",
          "published_at",
          "created_at",
          "discussion_url",
          "relevance"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "description": "Selected TensorTrace news-entry ID."
          },
          "title": {
            "type": "string",
            "description": "Original article title."
          },
          "summary": {
            "type": [
              "string",
              "null"
            ],
            "description": "Stored preview: up to 300 visible characters with ellipsis; balanced inline Markdown/links/TeX, up to 4 KiB encoded. Full body unchanged."
          },
          "url": {
            "type": "string",
            "description": "Selected original HTTP(S) article URL.",
            "format": "uri"
          },
          "source": {
            "$ref": "#/components/schemas/NewsPublisher"
          },
          "published_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "Source publication time, null when missing.",
            "format": "date-time"
          },
          "created_at": {
            "type": "string",
            "description": "TensorTrace receipt time and ordering fallback.",
            "format": "date-time"
          },
          "discussion_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "Optional original discussion URL.",
            "format": "uri"
          },
          "relevance": {
            "type": "string",
            "description": "Topic query, or explicit model/developer context in the title/summary. Related means TensorTrace matched elsewhere; labels never filter articles.",
            "enum": [
              "topic",
              "model",
              "developer",
              "related"
            ]
          },
          "image_urls": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uri"
            },
            "maxItems": 20,
            "description": "Safe, deduplicated original article images in TensorTrace order, preview first. Empty when unavailable; clients may show the first image."
          },
          "references": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PackageReference"
            },
            "maxItems": 5,
            "description": "Optional exact-version package evidence, separate from the article/release text."
          }
        },
        "additionalProperties": false
      },
      "NewsFeed": {
        "type": "object",
        "required": [
          "data",
          "context",
          "fetched_at",
          "upstream_total",
          "source",
          "next_cursor",
          "pagination"
        ],
        "properties": {
          "data": {
            "type": "array",
            "description": "Matching first-party articles in publication order; body-only and shared-URL records are retained.",
            "items": {
              "$ref": "#/components/schemas/NewsArticle"
            },
            "maxItems": 100
          },
          "context": {
            "$ref": "#/components/schemas/NewsContext"
          },
          "fetched_at": {
            "type": "string",
            "description": "Time this database query completed; not source acquisition or publication time.",
            "format": "date-time"
          },
          "upstream_total": {
            "type": "integer",
            "description": "Matching database entry count retained for installed-client compatibility.",
            "minimum": 0
          },
          "source": {
            "type": "string",
            "description": "First-party service.",
            "enum": [
              "TensorTrace"
            ]
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Opaque continuation for older results, or null when exhausted."
          },
          "pagination": {
            "$ref": "#/components/schemas/NewsPagination"
          }
        },
        "additionalProperties": false
      },
      "ProviderLeadingModel": {
        "type": "object",
        "required": [
          "canonical_model_id",
          "name",
          "intelligence_index",
          "capability_score",
          "best_rating",
          "provider",
          "developer_id",
          "developer_name",
          "branding"
        ],
        "properties": {
          "canonical_model_id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "provider": {
            "type": "string",
            "description": "Original model publisher, distinct from the inference provider."
          },
          "branding": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Branding"
              },
              {
                "type": "null"
              }
            ],
            "description": "Prepared model-family and company branding from the Model Library. Null only when absent from an older prepared model."
          },
          "intelligence_index": {
            "type": [
              "number",
              "null"
            ]
          },
          "capability_score": {
            "type": [
              "number",
              "null"
            ]
          },
          "best_rating": {
            "type": [
              "number",
              "null"
            ]
          },
          "developer_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Normalized developer directory ID, or null when attribution is unknown."
          },
          "developer_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Developer company, lab or author name, or null when attribution is unknown."
          }
        }
      },
      "NewsPagination": {
        "type": "object",
        "required": [
          "language",
          "keywords",
          "operator",
          "total",
          "unfiltered_total",
          "count",
          "limit",
          "has_older",
          "has_newer",
          "older_cursor",
          "newer_cursor",
          "older_url",
          "newer_url"
        ],
        "properties": {
          "language": {
            "type": "string"
          },
          "keywords": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "operator": {
            "type": "string",
            "enum": [
              "and",
              "or"
            ]
          },
          "total": {
            "type": "integer",
            "minimum": 0
          },
          "unfiltered_total": {
            "type": "integer",
            "minimum": 0
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100
          },
          "has_older": {
            "type": "boolean"
          },
          "has_newer": {
            "type": "boolean"
          },
          "older_cursor": {
            "type": [
              "string",
              "null"
            ]
          },
          "newer_cursor": {
            "type": [
              "string",
              "null"
            ]
          },
          "older_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "newer_url": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": false
      },
      "NewsDetail": {
        "type": "object",
        "required": [
          "id",
          "title",
          "summary",
          "url",
          "source",
          "published_at",
          "created_at",
          "content",
          "language",
          "author"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "description": "Selected TensorTrace news-entry ID."
          },
          "title": {
            "type": "string",
            "description": "Original article title."
          },
          "summary": {
            "type": [
              "string",
              "null"
            ],
            "description": "Stored description from accepted article/release text, at most 300 characters with a final ellipsis when shortened."
          },
          "url": {
            "type": "string",
            "description": "Selected original HTTP(S) article URL.",
            "format": "uri"
          },
          "source": {
            "$ref": "#/components/schemas/NewsPublisher"
          },
          "published_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "Source publication time, null when missing.",
            "format": "date-time"
          },
          "created_at": {
            "type": "string",
            "description": "TensorTrace receipt time and ordering fallback.",
            "format": "date-time"
          },
          "discussion_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "Optional original discussion URL.",
            "format": "uri"
          },
          "image_urls": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uri"
            },
            "maxItems": 20,
            "description": "Safe, deduplicated original article images in TensorTrace order, preview first. Empty when unavailable; clients may show the first image."
          },
          "content": {
            "type": "string",
            "description": "Complete plain-text article; no raw extraction HTML."
          },
          "language": {
            "type": "string"
          },
          "author": {
            "type": [
              "string",
              "null"
            ]
          },
          "references": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PackageReference"
            },
            "maxItems": 5,
            "description": "Optional exact-version package evidence, separate from the article/release text."
          }
        },
        "additionalProperties": false
      },
      "Paper": {
        "type": "object",
        "required": [
          "arxiv_id",
          "title",
          "abstract",
          "url",
          "id",
          "pdf_url",
          "doi",
          "license_url",
          "comments",
          "journal_ref",
          "authors",
          "categories",
          "published_on",
          "revised_on",
          "created_at",
          "updated_at",
          "source",
          "image_urls",
          "published_date",
          "published_precision"
        ],
        "properties": {
          "arxiv_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "External arXiv identity; null for works indexed only from other sources."
          },
          "title": {
            "type": "string"
          },
          "abstract": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "id": {
            "type": "integer",
            "minimum": 1
          },
          "pdf_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "doi": {
            "type": [
              "string",
              "null"
            ]
          },
          "license_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "comments": {
            "type": [
              "string",
              "null"
            ]
          },
          "journal_ref": {
            "type": [
              "string",
              "null"
            ]
          },
          "authors": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "published_on": {
            "$ref": "#/components/schemas/ResearchCalendarDate"
          },
          "revised_on": {
            "$ref": "#/components/schemas/ResearchCalendarDate"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "source": {
            "type": "object",
            "required": [
              "name",
              "url"
            ],
            "properties": {
              "name": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "image_urls": {
            "type": "array",
            "maxItems": 5,
            "items": {
              "type": "string",
              "format": "uri"
            },
            "description": "Up to 5 safe source media URLs. arXiv HTML enrichment supplies its first figure; HF metadata can supply more. Empty means unavailable or not yet indexed."
          },
          "ecosystem_url": {
            "type": "string",
            "description": "Optional same-origin discovery link, supplied only when an exact arXiv/DOI relationship is indexed."
          },
          "published_date": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Compatible YYYYMMDD calendar integer; DD=00 for month precision, MMDD=0000 for year precision, null when unknown. Never a Unix timestamp.",
            "examples": [
              20261009,
              20261000,
              20260000,
              null
            ]
          },
          "published_precision": {
            "type": "string",
            "enum": [
              "day",
              "month",
              "year",
              "unknown"
            ]
          },
          "research_id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable source-neutral work UUID. The positive numeric id remains a compatible alias."
          },
          "research_url": {
            "type": "string",
            "example": "/research/550e8400-e29b-41d4-a716-446655440000",
            "description": "Same-origin canonical work page."
          },
          "sources": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ResearchSource"
            },
            "description": "Explicit external identities for one work; no title similarity matching."
          },
          "versions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ResearchVersion"
            },
            "description": "Source-specific preprint/publication versions retain their own dates."
          },
          "notices": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "kind": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                },
                "published_on": {
                  "$ref": "#/components/schemas/ResearchCalendarDate"
                },
                "source_id": {
                  "type": "string",
                  "description": "Source reporting this correction or retraction."
                }
              },
              "additionalProperties": false,
              "required": [
                "kind",
                "title",
                "url"
              ]
            },
            "description": "Correction/retraction relationships, not aliases or replacement publication dates."
          },
          "reviews": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ResearchReview"
            }
          },
          "references": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ContentReference"
            },
            "maxItems": 20,
            "description": "Up to 3 compact list references or 20 full detail references; reference_count reports the complete total."
          },
          "reference_count": {
            "type": "integer",
            "minimum": 0,
            "description": "All current exact supporting relationships; may exceed the bounded preview."
          },
          "availability": {
            "type": "string",
            "description": "Stored work availability. Withdrawn/retracted evidence remains attributable."
          }
        },
        "additionalProperties": false
      },
      "PaperPagination": {
        "type": "object",
        "required": [
          "count",
          "total",
          "unfiltered_total",
          "limit",
          "keywords",
          "operator",
          "category",
          "before",
          "after",
          "next_cursor",
          "previous_cursor",
          "next",
          "previous"
        ],
        "properties": {
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "total": {
            "type": "integer",
            "minimum": 0
          },
          "unfiltered_total": {
            "type": "integer",
            "minimum": 0
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100
          },
          "keywords": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "operator": {
            "type": "string",
            "enum": [
              "and",
              "or"
            ]
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "before": {
            "type": [
              "string",
              "null"
            ]
          },
          "after": {
            "type": [
              "string",
              "null"
            ]
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          },
          "previous_cursor": {
            "type": [
              "string",
              "null"
            ]
          },
          "next": {
            "type": [
              "string",
              "null"
            ]
          },
          "previous": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": false
      },
      "PaperPage": {
        "type": "object",
        "required": [
          "data",
          "pagination"
        ],
        "properties": {
          "data": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/Paper"
            }
          },
          "pagination": {
            "$ref": "#/components/schemas/PaperPagination"
          }
        },
        "additionalProperties": false
      },
      "OrganizationProfile": {
        "type": "object",
        "required": [
          "summary",
          "description",
          "homepage",
          "links",
          "source_url",
          "source_kind",
          "retrieved_at",
          "receipt_id",
          "parser_version"
        ],
        "properties": {
          "summary": {
            "type": "string",
            "description": "Plain-text excerpt, at most 260 characters plus an ellipsis."
          },
          "description": {
            "type": "string",
            "description": "Plain text with blank lines between collected paragraphs. No AI rewriting or untrusted HTML."
          },
          "homepage": {
            "type": "string",
            "format": "uri"
          },
          "source_url": {
            "type": "string",
            "format": "uri"
          },
          "source_kind": {
            "type": "string",
            "enum": [
              "official_website",
              "publisher_profile"
            ]
          },
          "retrieved_at": {
            "type": "string",
            "format": "date-time"
          },
          "receipt_id": {
            "type": "string",
            "format": "uuid"
          },
          "parser_version": {
            "type": "string"
          },
          "links": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "kind",
                "label",
                "url"
              ],
              "properties": {
                "kind": {
                  "type": "string",
                  "enum": [
                    "website",
                    "github",
                    "hugging_face",
                    "documentation"
                  ]
                },
                "label": {
                  "type": "string"
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                }
              }
            }
          }
        }
      },
      "UnifiedSearchItem": {
        "type": "object",
        "required": [
          "id",
          "title",
          "url",
          "description",
          "image_url",
          "subtitle"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Stable source or canonical ID within the category."
          },
          "title": {
            "type": "string",
            "description": "Public title or display name, as plain text."
          },
          "url": {
            "type": "string",
            "description": "TensorTrace model or organization path, or the original HTTP(S) news/paper source URL."
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Bounded plain-text description; escape before rendering."
          },
          "image_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "Optional public image URL."
          },
          "subtitle": {
            "type": [
              "string",
              "null"
            ],
            "description": "Optional public publisher, author or category context."
          }
        }
      },
      "UnifiedSearchGroup": {
        "type": "object",
        "required": [
          "category",
          "total",
          "offset",
          "limit",
          "has_more",
          "items"
        ],
        "properties": {
          "category": {
            "type": "string",
            "description": "Kind of content in this group.",
            "enum": [
              "models",
              "news",
              "papers",
              "developers",
              "providers"
            ]
          },
          "total": {
            "type": "integer",
            "description": "Exact number of matches in this category.",
            "minimum": 0
          },
          "offset": {
            "type": "integer",
            "description": "Ranked hits skipped in this category.",
            "minimum": 0,
            "maximum": 10000
          },
          "limit": {
            "type": "integer",
            "description": "Requested maximum number of hits in this group.",
            "minimum": 1,
            "maximum": 18
          },
          "has_more": {
            "type": "boolean",
            "description": "Whether further matching hits follow this page."
          },
          "items": {
            "type": "array",
            "description": "Ranked hits in this page, ordered by relevance then stable ID.",
            "items": {
              "$ref": "#/components/schemas/UnifiedSearchItem"
            }
          }
        }
      },
      "UnifiedSearchResponse": {
        "type": "object",
        "required": [
          "query",
          "total",
          "groups"
        ],
        "properties": {
          "query": {
            "type": "string",
            "description": "Normalized query used for matching."
          },
          "total": {
            "type": "integer",
            "description": "Sum of match counts for the returned groups.",
            "minimum": 0
          },
          "groups": {
            "type": "array",
            "description": "Models, news, papers, developers and providers in that order, or one selected category.",
            "items": {
              "$ref": "#/components/schemas/UnifiedSearchGroup"
            }
          }
        }
      },
      "EcosystemLink": {
        "type": "object",
        "required": [
          "relation",
          "namespace",
          "external_id"
        ],
        "properties": {
          "relation": {
            "type": "string"
          },
          "namespace": {
            "type": "string"
          },
          "external_id": {
            "type": "string"
          },
          "url": {
            "type": [
              "string",
              "null"
            ]
          },
          "model_id": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "EcosystemRecord": {
        "type": "object",
        "required": [
          "id",
          "external_id",
          "kind",
          "title",
          "url",
          "facts",
          "source",
          "links",
          "receipt_id"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "external_id": {
            "type": "string"
          },
          "kind": {
            "type": "string",
            "enum": [
              "paper",
              "review",
              "release",
              "software",
              "dataset",
              "dataset_schema",
              "tool",
              "advisory",
              "artifact",
              "evaluation",
              "incident",
              "statistic",
              "change",
              "entity"
            ]
          },
          "title": {
            "type": "string"
          },
          "summary": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "published_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "date_precision": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "date",
              "timestamp",
              null
            ]
          },
          "availability": {
            "type": "string",
            "enum": [
              "active",
              "deprecated",
              "deleted",
              "withdrawn",
              "retracted",
              "unknown"
            ]
          },
          "license": {
            "type": [
              "string",
              "null"
            ]
          },
          "facts": {
            "type": "object",
            "additionalProperties": true
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EcosystemLink"
            }
          },
          "source": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            }
          },
          "receipt_id": {
            "type": "string",
            "format": "uuid"
          },
          "first_observed_at": {
            "type": "string",
            "format": "date-time"
          },
          "last_observed_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          }
        },
        "description": "Source-native facts retain their units, cohorts, licensing and observation clocks. Missing facts are null/omitted, never invented. Card responses contain a bounded subset of facts; detail contains all normalized facts."
      },
      "EcosystemPage": {
        "type": "object",
        "required": [
          "data",
          "pagination",
          "observed_at"
        ],
        "properties": {
          "data": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "$ref": "#/components/schemas/EcosystemRecord"
            }
          },
          "pagination": {
            "type": "object",
            "properties": {
              "total": {
                "type": "integer",
                "minimum": 0
              },
              "limit": {
                "type": "integer",
                "minimum": 1,
                "maximum": 20
              },
              "next_cursor": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "observed_at": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "EcosystemSources": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "name": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "status": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "last_success_at": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "last_error": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "access_gate": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "terms": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "category": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "scheduled": {
                  "type": "boolean",
                  "description": "Whether ordinary automatic/bulk refresh includes this source. Explicit manual access and license gates remain separate."
                },
                "collection_scope": {
                  "type": "string",
                  "description": "Current source policy, including targeted-only or paused scope."
                }
              },
              "additionalProperties": true
            }
          }
        }
      },
      "EcosystemHistory": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "object",
              "description": "Normalized historical record, receipt and acquisition SHA-256 metadata. Raw source bytes are not redistributed.",
              "additionalProperties": true
            }
          },
          "total_count": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "offset": {
            "type": "integer"
          },
          "evidence_scope": {
            "type": "string"
          }
        }
      },
      "ResearchSource": {
        "type": "object",
        "properties": {
          "source_id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "external_id": {
            "type": "string"
          },
          "license": {
            "type": [
              "string",
              "null"
            ]
          },
          "citations": {
            "type": [
              "integer",
              "null"
            ]
          },
          "citation_scope": {
            "type": [
              "string",
              "null"
            ]
          },
          "venue": {
            "type": [
              "string",
              "null"
            ]
          },
          "availability": {
            "type": "string",
            "description": "Current availability reported by this source; independent of availability of the whole work."
          },
          "published_on": {
            "$ref": "#/components/schemas/ResearchCalendarDate"
          },
          "published_precision": {
            "type": "string",
            "enum": [
              "day",
              "month",
              "year",
              "unknown"
            ]
          }
        },
        "additionalProperties": false,
        "required": [
          "source_id",
          "name",
          "url",
          "external_id"
        ]
      },
      "ResearchVersion": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "source_id": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "published_on": {
            "$ref": "#/components/schemas/ResearchCalendarDate"
          },
          "published_precision": {
            "type": "string",
            "enum": [
              "day",
              "month",
              "year",
              "unknown"
            ]
          },
          "revised_on": {
            "$ref": "#/components/schemas/ResearchCalendarDate"
          }
        },
        "additionalProperties": false,
        "required": [
          "id",
          "kind",
          "source_id",
          "url"
        ]
      },
      "ResearchReview": {
        "type": "object",
        "properties": {
          "source_id": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "venue": {
            "type": [
              "string",
              "null"
            ]
          },
          "decision": {
            "type": [
              "string",
              "null"
            ]
          },
          "review_count": {
            "type": "integer",
            "minimum": 0
          },
          "ratings": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "label": {
                  "type": "string"
                },
                "value": {
                  "description": "Original venue-specific scalar or label; never converted to a common scale."
                },
                "scale": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                }
              },
              "additionalProperties": false,
              "required": [
                "label",
                "value",
                "url"
              ]
            }
          },
          "scope": {
            "type": "string",
            "description": "Reviews observed in the indexed public notes; not a guaranteed complete forum total."
          }
        },
        "additionalProperties": false,
        "required": [
          "source_id",
          "url",
          "venue",
          "decision",
          "review_count",
          "ratings"
        ],
        "description": "Original venue-specific review evidence; no averaged quality score."
      },
      "ContentReference": {
        "type": "object",
        "properties": {
          "source_id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "external_id": {
            "type": "string"
          },
          "source_homepage": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "relation": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "facts": {
            "type": "object",
            "additionalProperties": true,
            "description": "Source-qualified metadata. Lists use compact facts; detail retains bounded audit/schema/file facts."
          },
          "license": {
            "type": [
              "string",
              "null"
            ]
          },
          "receipt_id": {
            "type": "string",
            "format": "uuid"
          },
          "observed_at": {
            "type": "string",
            "format": "date-time"
          },
          "audit_url": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "dataset_url": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri",
            "description": "Recognized Hugging Face dataset repository URL; null when the original pointer does not establish dataset identity."
          },
          "related_url": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri",
            "description": "Original safe related pointer from the source; may be a paper or project homepage rather than a dataset."
          }
        },
        "additionalProperties": false,
        "required": [
          "source_id",
          "name",
          "url",
          "relation",
          "kind",
          "title",
          "facts"
        ],
        "description": "Exact supporting evidence; file facts describe only the inspected file/shard."
      },
      "PackageReference": {
        "type": "object",
        "properties": {
          "relation": {
            "type": "string",
            "const": "package_metadata"
          },
          "kind": {
            "type": "string",
            "const": "software"
          },
          "source_id": {
            "type": "string",
            "const": "pypiPackages"
          },
          "name": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "version": {
            "type": "string"
          },
          "requires_python": {
            "type": [
              "string",
              "null"
            ]
          },
          "requires_dist": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 50
          },
          "dependency_count": {
            "type": "integer",
            "minimum": 0
          },
          "license": {
            "type": [
              "string",
              "null"
            ]
          },
          "receipt_id": {
            "type": "string",
            "format": "uuid"
          },
          "observed_at": {
            "type": "string",
            "format": "date-time"
          },
          "scope": {
            "type": "string"
          }
        },
        "additionalProperties": false,
        "required": [
          "relation",
          "kind",
          "source_id",
          "name",
          "url",
          "version",
          "requires_python",
          "requires_dist",
          "dependency_count",
          "license",
          "receipt_id",
          "observed_at",
          "scope"
        ],
        "description": "Declared PyPI metadata, not resolved dependencies or compatibility/security assurance."
      },
      "ReportChartContext": {
        "type": "object",
        "properties": {
          "report_year": {
            "type": "integer"
          },
          "chapter": {
            "type": [
              "string",
              "null"
            ]
          },
          "chart": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "bar",
                  "line"
                ]
              },
              "metric": {
                "type": "string"
              },
              "unit": {
                "type": "string"
              },
              "direction": {
                "type": "string"
              },
              "label_column": {
                "type": "integer",
                "minimum": 0
              },
              "value_column": {
                "type": "integer",
                "minimum": 0
              },
              "x_column": {
                "type": "integer",
                "minimum": 0
              },
              "series_column": {
                "type": "integer",
                "minimum": 0
              },
              "report_figure": {
                "type": "string"
              },
              "report_page": {
                "type": "integer",
                "minimum": 0
              },
              "data_provider": {
                "type": "string"
              },
              "baseline": {
                "type": "number"
              }
            },
            "additionalProperties": true,
            "required": [
              "type",
              "metric",
              "unit",
              "label_column",
              "value_column"
            ]
          },
          "columns": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "maxItems": 100
          },
          "source_file": {
            "type": "string",
            "format": "uri"
          },
          "source_file_id": {
            "type": "string"
          },
          "source_filename": {
            "type": "string"
          },
          "report_url": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "semantic_reference": {
            "type": "string",
            "format": "uri"
          },
          "attribution": {
            "type": [
              "string",
              "null"
            ]
          },
          "scope": {
            "type": "string"
          }
        },
        "additionalProperties": true,
        "required": [
          "report_year",
          "chart",
          "columns",
          "rows",
          "source_file",
          "scope"
        ]
      },
      "IncidentContext": {
        "type": "object",
        "properties": {
          "summary": {
            "type": [
              "string",
              "null"
            ]
          },
          "license": {
            "type": [
              "string",
              "null"
            ]
          },
          "incident": {
            "type": "object",
            "additionalProperties": true,
            "description": "Original incident/classification fields, with unknown/estimated dates retained."
          },
          "roles": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EcosystemLink"
            }
          },
          "scope": {
            "type": "string"
          },
          "denominator": {
            "type": "null"
          },
          "causality_inferred": {
            "type": "boolean",
            "const": false
          }
        },
        "additionalProperties": true,
        "required": [
          "incident",
          "roles",
          "scope",
          "denominator",
          "causality_inferred"
        ]
      },
      "SafetyGradeContext": {
        "type": "object",
        "properties": {
          "grade": {
            "type": [
              "string",
              "null"
            ]
          },
          "score": {
            "type": [
              "number",
              "null"
            ]
          },
          "metric": {
            "type": "string"
          },
          "unit": {
            "type": "string"
          },
          "evidence": {
            "type": "object",
            "additionalProperties": true
          }
        },
        "additionalProperties": true,
        "required": [
          "grade",
          "score",
          "metric",
          "unit",
          "evidence"
        ],
        "description": "Original ordinal grade; absent numeric scores remain null."
      },
      "BenchmarkContext": {
        "type": "object",
        "properties": {
          "source_id": {
            "type": "string"
          },
          "context_id": {
            "type": "string"
          },
          "kind": {
            "type": "string",
            "enum": [
              "report_chart",
              "incident",
              "safety_grade"
            ]
          },
          "title": {
            "type": "string"
          },
          "source_url": {
            "type": "string",
            "format": "uri"
          },
          "receipt_id": {
            "type": "string",
            "format": "uuid"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "context": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/ReportChartContext"
              },
              {
                "$ref": "#/components/schemas/IncidentContext"
              },
              {
                "$ref": "#/components/schemas/SafetyGradeContext"
              }
            ]
          }
        },
        "additionalProperties": false,
        "required": [
          "source_id",
          "context_id",
          "kind",
          "title",
          "source_url",
          "receipt_id",
          "updated_at",
          "context"
        ],
        "description": "A reviewed report chart, incident, or original safety grade; separate observation domains."
      },
      "BenchmarkContextSummary": {
        "type": "object",
        "properties": {
          "sources": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "source_id": {
                  "type": "string"
                },
                "kind": {
                  "type": "string"
                },
                "count": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "additionalProperties": false,
              "required": [
                "source_id",
                "count"
              ]
            }
          },
          "evaluations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "source_id": {
                  "type": "string"
                },
                "kind": {
                  "type": "string"
                },
                "count": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "additionalProperties": false,
              "required": [
                "source_id",
                "count"
              ]
            }
          },
          "incident_years": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "label": {
                  "type": "string"
                },
                "count": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "additionalProperties": false,
              "required": [
                "label",
                "count"
              ]
            }
          },
          "incident_risks": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "label": {
                  "type": "string"
                },
                "count": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "additionalProperties": false,
              "required": [
                "label",
                "count"
              ]
            }
          },
          "incident_date_coverage": {
            "type": "object",
            "properties": {
              "total": {
                "type": "integer",
                "minimum": 0
              },
              "estimated_or_unknown": {
                "type": "integer",
                "minimum": 0
              }
            },
            "additionalProperties": false,
            "required": [
              "total",
              "estimated_or_unknown"
            ]
          },
          "denominator": {
            "type": "null"
          },
          "company_risk_ranking": {
            "type": "boolean",
            "const": false
          }
        },
        "additionalProperties": false,
        "required": [
          "sources",
          "evaluations",
          "incident_years",
          "incident_risks",
          "incident_date_coverage",
          "denominator",
          "company_risk_ranking"
        ],
        "description": "Stored coverage across sources, independent of page filters; not prevalence or company risk rates."
      },
      "ResearchCalendarDate": {
        "type": [
          "string",
          "null"
        ],
        "pattern": "^[0-9]{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12][0-9]|3[01]))?)?$",
        "example": "2026-10-23",
        "description": "Original YYYY-MM-DD, YYYY-MM, YYYY or null. No invented first day or timestamp."
      }
    },
    "securitySchemes": {
      "AccountCookie": {
        "type": "apiKey",
        "in": "cookie",
        "name": "__Host-tt_session",
        "description": "HttpOnly Secure session cookie. Local HTTP uses tt_session. GET /auth/session supplies a session-bound CSRF token."
      },
      "AccountCSRF": {
        "type": "apiKey",
        "in": "header",
        "name": "X-CSRF-Token",
        "description": "Required with an exact Origin header for mutations. Call GET /auth/session first; refresh after login/logout/reset."
      }
    }
  }
}
