Skip to the content

DocsReferenceAPI reference

Answer schemas

Every answer of the Rhumb API as JSON Schema, by name: the same definitions as the OpenAPI document, one to a section.

Each answer's body follows one of these. /v1 is additive only, so a schema gains fields and never loses one; the same definitions are in /v1/openapi.json.

Resolution
Resolution (JSON Schema)
{
  "type": "object",
  "properties": {
    "shape": {
      "type": "string",
      "enum": [
        "single",
        "team",
        "escalation"
      ],
      "description": "single: `model`. team: `team`, with `model` its first role's first member. escalation: `escalation`, with `model` its first step."
    },
    "catalog_version": {
      "type": "string"
    },
    "need": {
      "type": "object",
      "properties": {
        "task": {
          "type": "string"
        },
        "purpose": {
          "type": "string"
        },
        "needs": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "capability": {
                "type": "string"
              },
              "level": {
                "type": "string"
              }
            },
            "required": [
              "capability",
              "level"
            ]
          }
        },
        "providers": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "provider_terms": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "kind": {
                  "type": "string"
                }
              },
              "required": [
                "kind"
              ],
              "additionalProperties": {}
            }
          }
        },
        "origin": {
          "type": "object",
          "properties": {
            "include": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "exclude": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "strict": {
              "type": "boolean"
            }
          },
          "required": [
            "include",
            "exclude",
            "strict"
          ]
        },
        "budget": {
          "type": "string"
        },
        "max_price": {
          "type": "string"
        },
        "optimize": {
          "type": "string"
        },
        "quality_margin": {
          "type": "number"
        },
        "usage": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "type": [
              "number",
              "string"
            ]
          }
        },
        "allow_preview": {
          "type": "boolean"
        },
        "allow_trial": {
          "type": "boolean"
        },
        "allow_closed": {
          "type": "boolean"
        },
        "exclude": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "service_tier": {
          "type": "string"
        },
        "hours": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "start": {
                "type": "number"
              },
              "end": {
                "type": "number"
              }
            },
            "required": [
              "start",
              "end"
            ]
          },
          "description": "The request's hours, as UTC hours from start to end."
        },
        "currency": {
          "type": "string"
        }
      },
      "required": [
        "task",
        "needs",
        "providers",
        "provider_terms",
        "optimize",
        "quality_margin",
        "usage",
        "allow_preview",
        "exclude",
        "service_tier"
      ],
      "additionalProperties": {}
    },
    "model": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Canonical model id, vendor/model."
        },
        "vendor": {
          "type": "string"
        },
        "origin": {
          "type": "string"
        },
        "provider": {
          "type": "string"
        },
        "provider_model_id": {
          "type": "string",
          "description": "Use this as the model name in the provider's API."
        },
        "status": {
          "type": "string",
          "enum": [
            "preview",
            "ga",
            "deprecated",
            "retired"
          ]
        },
        "released": {
          "type": "string"
        },
        "capabilities": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "type": "object",
            "properties": {
              "level": {
                "type": "string",
                "enum": [
                  "claimed",
                  "parsed",
                  "native",
                  "probed"
                ]
              },
              "probed_on": {
                "type": "string"
              },
              "efforts": {
                "description": "Reasoning effort levels the offering accepts, for reasoning.",
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "required": [
              "level"
            ]
          }
        },
        "limits": {
          "type": "object",
          "properties": {
            "context": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "max_input": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "max_output": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "dimensions": {
              "description": "Embedding vector length, as a probe measured it.",
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            }
          }
        },
        "price": {
          "type": "object",
          "properties": {
            "currency": {
              "type": "string"
            },
            "per_1m": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {
                "type": "string",
                "description": "A decimal number as a string; never a float."
              }
            },
            "typical_call": {
              "type": "string",
              "description": "USD, after fees and your provider_terms, at the day's highest rate."
            },
            "typical_call_average": {
              "type": "string",
              "description": "With cheaper hours: typical_call averaged over the request's hours, or over a flat week without them, which is what answers rank on."
            },
            "per_1m_average": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {
                "type": "string",
                "description": "A decimal number as a string; never a float."
              },
              "description": "With cheaper hours: per_1m averaged over the request's hours, or over a flat week without them."
            },
            "time_windows": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "days": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "start": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  "end": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  "per_1m": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "type": "string",
                      "description": "A decimal number as a string; never a float."
                    }
                  }
                },
                "required": [
                  "per_1m"
                ],
                "description": "Hours a price is below per_1m, in UTC. days are lower-case English names, and none means every day. start and end are hhmm, an end of 0 means midnight, and neither means the whole day."
              }
            },
            "converted": {
              "type": "object",
              "properties": {
                "currency": {
                  "type": "string"
                },
                "typical_call": {
                  "type": "string",
                  "description": "A decimal number as a string; never a float."
                },
                "typical_call_average": {
                  "type": "string",
                  "description": "A decimal number as a string; never a float."
                }
              },
              "required": [
                "currency",
                "typical_call"
              ]
            },
            "unverified": {
              "type": "boolean"
            }
          },
          "required": [
            "currency",
            "per_1m",
            "typical_call"
          ]
        },
        "quality": {
          "type": "object",
          "properties": {
            "score": {
              "type": "number"
            },
            "basis": {
              "type": "string",
              "description": "<source>:<signal>, or curated."
            },
            "measured_on": {
              "type": "string"
            },
            "attribution": {
              "type": "string",
              "description": "Show this wherever the score is shown."
            },
            "kind": {
              "type": "string",
              "enum": [
                "measured",
                "estimated"
              ]
            },
            "quantization_penalty": {
              "type": "number",
              "description": "Local runtimes: taken off the model's score for the quantization (q8_0 0, q6_K 0.005, q5_K_M 0.01, q4_K_M 0.03); above 0 the score is an estimate."
            }
          },
          "required": [
            "score",
            "basis",
            "measured_on",
            "attribution",
            "kind"
          ]
        },
        "routing": {
          "description": "Provider-specific request fields the answer depends on; send them with the call. On OpenRouter with needs=zdr: { \"openrouter\": { \"provider\": { \"zdr\": true } } }, so OpenRouter routes only to zero-data-retention upstreams.",
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {}
          }
        },
        "quantization": {
          "type": "string",
          "description": "Local runtimes: the weights' quantization, e.g. \"Q4_K_M\"."
        },
        "parameters_b": {
          "type": "number",
          "description": "Local runtimes: parameters, in billions."
        },
        "requirements": {
          "type": "object",
          "properties": {
            "memory_gb": {
              "type": "number",
              "description": "Memory to run it: weights, KV cache at context_for_memory tokens and about 10% runtime overhead. GB are 10^9 bytes."
            },
            "vram_gb": {
              "type": "number",
              "description": "GPU memory for a full offload, at the same context."
            },
            "disk_gb": {
              "type": "number",
              "description": "The weights' download size."
            },
            "context_for_memory": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991,
              "description": "The context, in tokens, memory_gb is stated at: the request's min_context when larger than the stored 8,192 (WebLLM: its fixed context)."
            },
            "kv_bytes_per_token": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991,
              "description": "KV cache bytes per further token of context."
            },
            "low_resource": {
              "type": "boolean",
              "description": "WebLLM: runs on low-resource devices."
            }
          },
          "required": [
            "memory_gb",
            "context_for_memory"
          ],
          "description": "Local runtimes: what the device needs."
        },
        "license": {
          "type": "string",
          "description": "Local runtimes: the weights' license, e.g. \"apache-2.0\"."
        }
      },
      "required": [
        "id",
        "vendor",
        "provider",
        "provider_model_id",
        "status",
        "capabilities",
        "limits"
      ]
    },
    "also_on": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "provider": {
            "type": "string"
          },
          "provider_model_id": {
            "type": "string"
          },
          "typical_call": {
            "type": "string",
            "description": "A decimal number as a string; never a float."
          },
          "typical_call_average": {
            "type": "string",
            "description": "A decimal number as a string; never a float."
          },
          "note": {
            "type": "string"
          }
        },
        "required": [
          "provider",
          "provider_model_id"
        ]
      }
    },
    "alternatives": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Canonical model id, vendor/model."
          },
          "vendor": {
            "type": "string"
          },
          "origin": {
            "type": "string"
          },
          "provider": {
            "type": "string"
          },
          "provider_model_id": {
            "type": "string",
            "description": "Use this as the model name in the provider's API."
          },
          "status": {
            "type": "string",
            "enum": [
              "preview",
              "ga",
              "deprecated",
              "retired"
            ]
          },
          "released": {
            "type": "string"
          },
          "capabilities": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {
              "type": "object",
              "properties": {
                "level": {
                  "type": "string",
                  "enum": [
                    "claimed",
                    "parsed",
                    "native",
                    "probed"
                  ]
                },
                "probed_on": {
                  "type": "string"
                },
                "efforts": {
                  "description": "Reasoning effort levels the offering accepts, for reasoning.",
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              },
              "required": [
                "level"
              ]
            }
          },
          "limits": {
            "type": "object",
            "properties": {
              "context": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              "max_input": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              "max_output": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              "dimensions": {
                "description": "Embedding vector length, as a probe measured it.",
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              }
            }
          },
          "price": {
            "type": "object",
            "properties": {
              "currency": {
                "type": "string"
              },
              "per_1m": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {
                  "type": "string",
                  "description": "A decimal number as a string; never a float."
                }
              },
              "typical_call": {
                "type": "string",
                "description": "USD, after fees and your provider_terms, at the day's highest rate."
              },
              "typical_call_average": {
                "type": "string",
                "description": "With cheaper hours: typical_call averaged over the request's hours, or over a flat week without them, which is what answers rank on."
              },
              "per_1m_average": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {
                  "type": "string",
                  "description": "A decimal number as a string; never a float."
                },
                "description": "With cheaper hours: per_1m averaged over the request's hours, or over a flat week without them."
              },
              "time_windows": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "days": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "start": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "end": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "per_1m": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "type": "string",
                        "description": "A decimal number as a string; never a float."
                      }
                    }
                  },
                  "required": [
                    "per_1m"
                  ],
                  "description": "Hours a price is below per_1m, in UTC. days are lower-case English names, and none means every day. start and end are hhmm, an end of 0 means midnight, and neither means the whole day."
                }
              },
              "converted": {
                "type": "object",
                "properties": {
                  "currency": {
                    "type": "string"
                  },
                  "typical_call": {
                    "type": "string",
                    "description": "A decimal number as a string; never a float."
                  },
                  "typical_call_average": {
                    "type": "string",
                    "description": "A decimal number as a string; never a float."
                  }
                },
                "required": [
                  "currency",
                  "typical_call"
                ]
              },
              "unverified": {
                "type": "boolean"
              }
            },
            "required": [
              "currency",
              "per_1m",
              "typical_call"
            ]
          },
          "quality": {
            "type": "object",
            "properties": {
              "score": {
                "type": "number"
              },
              "basis": {
                "type": "string",
                "description": "<source>:<signal>, or curated."
              },
              "measured_on": {
                "type": "string"
              },
              "attribution": {
                "type": "string",
                "description": "Show this wherever the score is shown."
              },
              "kind": {
                "type": "string",
                "enum": [
                  "measured",
                  "estimated"
                ]
              },
              "quantization_penalty": {
                "type": "number",
                "description": "Local runtimes: taken off the model's score for the quantization (q8_0 0, q6_K 0.005, q5_K_M 0.01, q4_K_M 0.03); above 0 the score is an estimate."
              }
            },
            "required": [
              "score",
              "basis",
              "measured_on",
              "attribution",
              "kind"
            ]
          },
          "routing": {
            "description": "Provider-specific request fields the answer depends on; send them with the call. On OpenRouter with needs=zdr: { \"openrouter\": { \"provider\": { \"zdr\": true } } }, so OpenRouter routes only to zero-data-retention upstreams.",
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            }
          },
          "quantization": {
            "type": "string",
            "description": "Local runtimes: the weights' quantization, e.g. \"Q4_K_M\"."
          },
          "parameters_b": {
            "type": "number",
            "description": "Local runtimes: parameters, in billions."
          },
          "requirements": {
            "type": "object",
            "properties": {
              "memory_gb": {
                "type": "number",
                "description": "Memory to run it: weights, KV cache at context_for_memory tokens and about 10% runtime overhead. GB are 10^9 bytes."
              },
              "vram_gb": {
                "type": "number",
                "description": "GPU memory for a full offload, at the same context."
              },
              "disk_gb": {
                "type": "number",
                "description": "The weights' download size."
              },
              "context_for_memory": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991,
                "description": "The context, in tokens, memory_gb is stated at: the request's min_context when larger than the stored 8,192 (WebLLM: its fixed context)."
              },
              "kv_bytes_per_token": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991,
                "description": "KV cache bytes per further token of context."
              },
              "low_resource": {
                "type": "boolean",
                "description": "WebLLM: runs on low-resource devices."
              }
            },
            "required": [
              "memory_gb",
              "context_for_memory"
            ],
            "description": "Local runtimes: what the device needs."
          },
          "license": {
            "type": "string",
            "description": "Local runtimes: the weights' license, e.g. \"apache-2.0\"."
          }
        },
        "required": [
          "id",
          "vendor",
          "provider",
          "provider_model_id",
          "status",
          "capabilities",
          "limits"
        ]
      }
    },
    "reason": {
      "type": "string"
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          }
        },
        "required": [
          "code"
        ],
        "additionalProperties": {}
      }
    },
    "team": {
      "type": "object",
      "properties": {
        "strategy": {
          "type": "string"
        },
        "roles": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "type": "object",
            "properties": {
              "task": {
                "type": "string"
              },
              "members": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Canonical model id, vendor/model."
                    },
                    "vendor": {
                      "type": "string"
                    },
                    "origin": {
                      "type": "string"
                    },
                    "provider": {
                      "type": "string"
                    },
                    "provider_model_id": {
                      "type": "string",
                      "description": "Use this as the model name in the provider's API."
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "preview",
                        "ga",
                        "deprecated",
                        "retired"
                      ]
                    },
                    "released": {
                      "type": "string"
                    },
                    "capabilities": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "type": "object",
                        "properties": {
                          "level": {
                            "type": "string",
                            "enum": [
                              "claimed",
                              "parsed",
                              "native",
                              "probed"
                            ]
                          },
                          "probed_on": {
                            "type": "string"
                          },
                          "efforts": {
                            "description": "Reasoning effort levels the offering accepts, for reasoning.",
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          }
                        },
                        "required": [
                          "level"
                        ]
                      }
                    },
                    "limits": {
                      "type": "object",
                      "properties": {
                        "context": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "max_input": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "max_output": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "dimensions": {
                          "description": "Embedding vector length, as a probe measured it.",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        }
                      }
                    },
                    "price": {
                      "type": "object",
                      "properties": {
                        "currency": {
                          "type": "string"
                        },
                        "per_1m": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "type": "string",
                            "description": "A decimal number as a string; never a float."
                          }
                        },
                        "typical_call": {
                          "type": "string",
                          "description": "USD, after fees and your provider_terms, at the day's highest rate."
                        },
                        "typical_call_average": {
                          "type": "string",
                          "description": "With cheaper hours: typical_call averaged over the request's hours, or over a flat week without them, which is what answers rank on."
                        },
                        "per_1m_average": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "type": "string",
                            "description": "A decimal number as a string; never a float."
                          },
                          "description": "With cheaper hours: per_1m averaged over the request's hours, or over a flat week without them."
                        },
                        "time_windows": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "days": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "start": {
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              },
                              "end": {
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              },
                              "per_1m": {
                                "type": "object",
                                "propertyNames": {
                                  "type": "string"
                                },
                                "additionalProperties": {
                                  "type": "string",
                                  "description": "A decimal number as a string; never a float."
                                }
                              }
                            },
                            "required": [
                              "per_1m"
                            ],
                            "description": "Hours a price is below per_1m, in UTC. days are lower-case English names, and none means every day. start and end are hhmm, an end of 0 means midnight, and neither means the whole day."
                          }
                        },
                        "converted": {
                          "type": "object",
                          "properties": {
                            "currency": {
                              "type": "string"
                            },
                            "typical_call": {
                              "type": "string",
                              "description": "A decimal number as a string; never a float."
                            },
                            "typical_call_average": {
                              "type": "string",
                              "description": "A decimal number as a string; never a float."
                            }
                          },
                          "required": [
                            "currency",
                            "typical_call"
                          ]
                        },
                        "unverified": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "currency",
                        "per_1m",
                        "typical_call"
                      ]
                    },
                    "quality": {
                      "type": "object",
                      "properties": {
                        "score": {
                          "type": "number"
                        },
                        "basis": {
                          "type": "string",
                          "description": "<source>:<signal>, or curated."
                        },
                        "measured_on": {
                          "type": "string"
                        },
                        "attribution": {
                          "type": "string",
                          "description": "Show this wherever the score is shown."
                        },
                        "kind": {
                          "type": "string",
                          "enum": [
                            "measured",
                            "estimated"
                          ]
                        },
                        "quantization_penalty": {
                          "type": "number",
                          "description": "Local runtimes: taken off the model's score for the quantization (q8_0 0, q6_K 0.005, q5_K_M 0.01, q4_K_M 0.03); above 0 the score is an estimate."
                        }
                      },
                      "required": [
                        "score",
                        "basis",
                        "measured_on",
                        "attribution",
                        "kind"
                      ]
                    },
                    "routing": {
                      "description": "Provider-specific request fields the answer depends on; send them with the call. On OpenRouter with needs=zdr: { \"openrouter\": { \"provider\": { \"zdr\": true } } }, so OpenRouter routes only to zero-data-retention upstreams.",
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {}
                      }
                    },
                    "quantization": {
                      "type": "string",
                      "description": "Local runtimes: the weights' quantization, e.g. \"Q4_K_M\"."
                    },
                    "parameters_b": {
                      "type": "number",
                      "description": "Local runtimes: parameters, in billions."
                    },
                    "requirements": {
                      "type": "object",
                      "properties": {
                        "memory_gb": {
                          "type": "number",
                          "description": "Memory to run it: weights, KV cache at context_for_memory tokens and about 10% runtime overhead. GB are 10^9 bytes."
                        },
                        "vram_gb": {
                          "type": "number",
                          "description": "GPU memory for a full offload, at the same context."
                        },
                        "disk_gb": {
                          "type": "number",
                          "description": "The weights' download size."
                        },
                        "context_for_memory": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991,
                          "description": "The context, in tokens, memory_gb is stated at: the request's min_context when larger than the stored 8,192 (WebLLM: its fixed context)."
                        },
                        "kv_bytes_per_token": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991,
                          "description": "KV cache bytes per further token of context."
                        },
                        "low_resource": {
                          "type": "boolean",
                          "description": "WebLLM: runs on low-resource devices."
                        }
                      },
                      "required": [
                        "memory_gb",
                        "context_for_memory"
                      ],
                      "description": "Local runtimes: what the device needs."
                    },
                    "license": {
                      "type": "string",
                      "description": "Local runtimes: the weights' license, e.g. \"apache-2.0\"."
                    }
                  },
                  "required": [
                    "id",
                    "vendor",
                    "provider",
                    "provider_model_id",
                    "status",
                    "capabilities",
                    "limits"
                  ]
                }
              }
            },
            "required": [
              "task",
              "members"
            ]
          },
          "description": "Role name → its task and members, in the roles' order."
        },
        "typical_call": {
          "type": "string",
          "description": "The whole team's typical call in USD, when every member is priced."
        }
      },
      "required": [
        "roles"
      ],
      "description": "shape=team: the members by role."
    },
    "escalation": {
      "type": "object",
      "properties": {
        "steps": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Canonical model id, vendor/model."
              },
              "vendor": {
                "type": "string"
              },
              "origin": {
                "type": "string"
              },
              "provider": {
                "type": "string"
              },
              "provider_model_id": {
                "type": "string",
                "description": "Use this as the model name in the provider's API."
              },
              "status": {
                "type": "string",
                "enum": [
                  "preview",
                  "ga",
                  "deprecated",
                  "retired"
                ]
              },
              "released": {
                "type": "string"
              },
              "capabilities": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {
                  "type": "object",
                  "properties": {
                    "level": {
                      "type": "string",
                      "enum": [
                        "claimed",
                        "parsed",
                        "native",
                        "probed"
                      ]
                    },
                    "probed_on": {
                      "type": "string"
                    },
                    "efforts": {
                      "description": "Reasoning effort levels the offering accepts, for reasoning.",
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "required": [
                    "level"
                  ]
                }
              },
              "limits": {
                "type": "object",
                "properties": {
                  "context": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  "max_input": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  "max_output": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  "dimensions": {
                    "description": "Embedding vector length, as a probe measured it.",
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  }
                }
              },
              "price": {
                "type": "object",
                "properties": {
                  "currency": {
                    "type": "string"
                  },
                  "per_1m": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "type": "string",
                      "description": "A decimal number as a string; never a float."
                    }
                  },
                  "typical_call": {
                    "type": "string",
                    "description": "USD, after fees and your provider_terms, at the day's highest rate."
                  },
                  "typical_call_average": {
                    "type": "string",
                    "description": "With cheaper hours: typical_call averaged over the request's hours, or over a flat week without them, which is what answers rank on."
                  },
                  "per_1m_average": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "type": "string",
                      "description": "A decimal number as a string; never a float."
                    },
                    "description": "With cheaper hours: per_1m averaged over the request's hours, or over a flat week without them."
                  },
                  "time_windows": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "days": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "start": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "end": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "per_1m": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "type": "string",
                            "description": "A decimal number as a string; never a float."
                          }
                        }
                      },
                      "required": [
                        "per_1m"
                      ],
                      "description": "Hours a price is below per_1m, in UTC. days are lower-case English names, and none means every day. start and end are hhmm, an end of 0 means midnight, and neither means the whole day."
                    }
                  },
                  "converted": {
                    "type": "object",
                    "properties": {
                      "currency": {
                        "type": "string"
                      },
                      "typical_call": {
                        "type": "string",
                        "description": "A decimal number as a string; never a float."
                      },
                      "typical_call_average": {
                        "type": "string",
                        "description": "A decimal number as a string; never a float."
                      }
                    },
                    "required": [
                      "currency",
                      "typical_call"
                    ]
                  },
                  "unverified": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "currency",
                  "per_1m",
                  "typical_call"
                ]
              },
              "quality": {
                "type": "object",
                "properties": {
                  "score": {
                    "type": "number"
                  },
                  "basis": {
                    "type": "string",
                    "description": "<source>:<signal>, or curated."
                  },
                  "measured_on": {
                    "type": "string"
                  },
                  "attribution": {
                    "type": "string",
                    "description": "Show this wherever the score is shown."
                  },
                  "kind": {
                    "type": "string",
                    "enum": [
                      "measured",
                      "estimated"
                    ]
                  },
                  "quantization_penalty": {
                    "type": "number",
                    "description": "Local runtimes: taken off the model's score for the quantization (q8_0 0, q6_K 0.005, q5_K_M 0.01, q4_K_M 0.03); above 0 the score is an estimate."
                  }
                },
                "required": [
                  "score",
                  "basis",
                  "measured_on",
                  "attribution",
                  "kind"
                ]
              },
              "routing": {
                "description": "Provider-specific request fields the answer depends on; send them with the call. On OpenRouter with needs=zdr: { \"openrouter\": { \"provider\": { \"zdr\": true } } }, so OpenRouter routes only to zero-data-retention upstreams.",
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {}
                }
              },
              "quantization": {
                "type": "string",
                "description": "Local runtimes: the weights' quantization, e.g. \"Q4_K_M\"."
              },
              "parameters_b": {
                "type": "number",
                "description": "Local runtimes: parameters, in billions."
              },
              "requirements": {
                "type": "object",
                "properties": {
                  "memory_gb": {
                    "type": "number",
                    "description": "Memory to run it: weights, KV cache at context_for_memory tokens and about 10% runtime overhead. GB are 10^9 bytes."
                  },
                  "vram_gb": {
                    "type": "number",
                    "description": "GPU memory for a full offload, at the same context."
                  },
                  "disk_gb": {
                    "type": "number",
                    "description": "The weights' download size."
                  },
                  "context_for_memory": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991,
                    "description": "The context, in tokens, memory_gb is stated at: the request's min_context when larger than the stored 8,192 (WebLLM: its fixed context)."
                  },
                  "kv_bytes_per_token": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991,
                    "description": "KV cache bytes per further token of context."
                  },
                  "low_resource": {
                    "type": "boolean",
                    "description": "WebLLM: runs on low-resource devices."
                  }
                },
                "required": [
                  "memory_gb",
                  "context_for_memory"
                ],
                "description": "Local runtimes: what the device needs."
              },
              "license": {
                "type": "string",
                "description": "Local runtimes: the weights' license, e.g. \"apache-2.0\"."
              }
            },
            "required": [
              "id",
              "vendor",
              "provider",
              "provider_model_id",
              "status",
              "capabilities",
              "limits"
            ]
          },
          "description": "Cheapest first; each step clears a higher quality tier."
        },
        "team": {
          "type": "object",
          "properties": {
            "strategy": {
              "type": "string"
            },
            "roles": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {
                "type": "object",
                "properties": {
                  "task": {
                    "type": "string"
                  },
                  "members": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "description": "Canonical model id, vendor/model."
                        },
                        "vendor": {
                          "type": "string"
                        },
                        "origin": {
                          "type": "string"
                        },
                        "provider": {
                          "type": "string"
                        },
                        "provider_model_id": {
                          "type": "string",
                          "description": "Use this as the model name in the provider's API."
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "preview",
                            "ga",
                            "deprecated",
                            "retired"
                          ]
                        },
                        "released": {
                          "type": "string"
                        },
                        "capabilities": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "type": "object",
                            "properties": {
                              "level": {
                                "type": "string",
                                "enum": [
                                  "claimed",
                                  "parsed",
                                  "native",
                                  "probed"
                                ]
                              },
                              "probed_on": {
                                "type": "string"
                              },
                              "efforts": {
                                "description": "Reasoning effort levels the offering accepts, for reasoning.",
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              }
                            },
                            "required": [
                              "level"
                            ]
                          }
                        },
                        "limits": {
                          "type": "object",
                          "properties": {
                            "context": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "max_input": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "max_output": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "dimensions": {
                              "description": "Embedding vector length, as a probe measured it.",
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            }
                          }
                        },
                        "price": {
                          "type": "object",
                          "properties": {
                            "currency": {
                              "type": "string"
                            },
                            "per_1m": {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "type": "string",
                                "description": "A decimal number as a string; never a float."
                              }
                            },
                            "typical_call": {
                              "type": "string",
                              "description": "USD, after fees and your provider_terms, at the day's highest rate."
                            },
                            "typical_call_average": {
                              "type": "string",
                              "description": "With cheaper hours: typical_call averaged over the request's hours, or over a flat week without them, which is what answers rank on."
                            },
                            "per_1m_average": {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "type": "string",
                                "description": "A decimal number as a string; never a float."
                              },
                              "description": "With cheaper hours: per_1m averaged over the request's hours, or over a flat week without them."
                            },
                            "time_windows": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "days": {
                                    "type": "array",
                                    "items": {
                                      "type": "string"
                                    }
                                  },
                                  "start": {
                                    "type": "integer",
                                    "minimum": -9007199254740991,
                                    "maximum": 9007199254740991
                                  },
                                  "end": {
                                    "type": "integer",
                                    "minimum": -9007199254740991,
                                    "maximum": 9007199254740991
                                  },
                                  "per_1m": {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string"
                                    },
                                    "additionalProperties": {
                                      "type": "string",
                                      "description": "A decimal number as a string; never a float."
                                    }
                                  }
                                },
                                "required": [
                                  "per_1m"
                                ],
                                "description": "Hours a price is below per_1m, in UTC. days are lower-case English names, and none means every day. start and end are hhmm, an end of 0 means midnight, and neither means the whole day."
                              }
                            },
                            "converted": {
                              "type": "object",
                              "properties": {
                                "currency": {
                                  "type": "string"
                                },
                                "typical_call": {
                                  "type": "string",
                                  "description": "A decimal number as a string; never a float."
                                },
                                "typical_call_average": {
                                  "type": "string",
                                  "description": "A decimal number as a string; never a float."
                                }
                              },
                              "required": [
                                "currency",
                                "typical_call"
                              ]
                            },
                            "unverified": {
                              "type": "boolean"
                            }
                          },
                          "required": [
                            "currency",
                            "per_1m",
                            "typical_call"
                          ]
                        },
                        "quality": {
                          "type": "object",
                          "properties": {
                            "score": {
                              "type": "number"
                            },
                            "basis": {
                              "type": "string",
                              "description": "<source>:<signal>, or curated."
                            },
                            "measured_on": {
                              "type": "string"
                            },
                            "attribution": {
                              "type": "string",
                              "description": "Show this wherever the score is shown."
                            },
                            "kind": {
                              "type": "string",
                              "enum": [
                                "measured",
                                "estimated"
                              ]
                            },
                            "quantization_penalty": {
                              "type": "number",
                              "description": "Local runtimes: taken off the model's score for the quantization (q8_0 0, q6_K 0.005, q5_K_M 0.01, q4_K_M 0.03); above 0 the score is an estimate."
                            }
                          },
                          "required": [
                            "score",
                            "basis",
                            "measured_on",
                            "attribution",
                            "kind"
                          ]
                        },
                        "routing": {
                          "description": "Provider-specific request fields the answer depends on; send them with the call. On OpenRouter with needs=zdr: { \"openrouter\": { \"provider\": { \"zdr\": true } } }, so OpenRouter routes only to zero-data-retention upstreams.",
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {}
                          }
                        },
                        "quantization": {
                          "type": "string",
                          "description": "Local runtimes: the weights' quantization, e.g. \"Q4_K_M\"."
                        },
                        "parameters_b": {
                          "type": "number",
                          "description": "Local runtimes: parameters, in billions."
                        },
                        "requirements": {
                          "type": "object",
                          "properties": {
                            "memory_gb": {
                              "type": "number",
                              "description": "Memory to run it: weights, KV cache at context_for_memory tokens and about 10% runtime overhead. GB are 10^9 bytes."
                            },
                            "vram_gb": {
                              "type": "number",
                              "description": "GPU memory for a full offload, at the same context."
                            },
                            "disk_gb": {
                              "type": "number",
                              "description": "The weights' download size."
                            },
                            "context_for_memory": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991,
                              "description": "The context, in tokens, memory_gb is stated at: the request's min_context when larger than the stored 8,192 (WebLLM: its fixed context)."
                            },
                            "kv_bytes_per_token": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991,
                              "description": "KV cache bytes per further token of context."
                            },
                            "low_resource": {
                              "type": "boolean",
                              "description": "WebLLM: runs on low-resource devices."
                            }
                          },
                          "required": [
                            "memory_gb",
                            "context_for_memory"
                          ],
                          "description": "Local runtimes: what the device needs."
                        },
                        "license": {
                          "type": "string",
                          "description": "Local runtimes: the weights' license, e.g. \"apache-2.0\"."
                        }
                      },
                      "required": [
                        "id",
                        "vendor",
                        "provider",
                        "provider_model_id",
                        "status",
                        "capabilities",
                        "limits"
                      ]
                    }
                  }
                },
                "required": [
                  "task",
                  "members"
                ]
              },
              "description": "Role name → its task and members, in the roles' order."
            },
            "typical_call": {
              "type": "string",
              "description": "The whole team's typical call in USD, when every member is priced."
            }
          },
          "required": [
            "roles"
          ],
          "description": "Check then escalate: the team to escalate to."
        }
      },
      "required": [
        "steps"
      ],
      "description": "shape=escalation: the steps, and the team to escalate to."
    }
  },
  "required": [
    "shape",
    "catalog_version",
    "need",
    "model",
    "also_on",
    "alternatives",
    "reason",
    "warnings"
  ]
}
PlanRequest
PlanRequest (JSON Schema)
{
  "type": "object",
  "properties": {
    "providers": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Required. Provider names, in order of preference for ties."
    },
    "prompt": {
      "type": "string",
      "description": "The request to read. Sent only to the decision model you choose; never stored or logged."
    },
    "tags": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 100
      },
      "description": "Free tags, e.g. [\"vision\", \"read receipts\", \"usa\", \"medium\"]."
    },
    "attachments": {
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "MIME type, e.g. image/jpeg. Only type and size are sent, never the file."
          },
          "bytes": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "pages": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          },
          "seconds": {
            "type": "number",
            "minimum": 0
          }
        },
        "required": [
          "type",
          "bytes"
        ],
        "additionalProperties": false
      }
    },
    "decision": {
      "type": "object",
      "properties": {
        "model": {
          "type": "string",
          "enum": [
            "openai",
            "local",
            "jev"
          ],
          "description": "openai (default) or local; jev is for internal accounts only."
        },
        "allow_remote": {
          "type": "boolean",
          "description": "false keeps the prompt on the server: the local classifier only. When the account turns on \"Keep prompts on Rhumb's server\" in Settings, every request reads this way."
        }
      },
      "additionalProperties": false
    },
    "device": {
      "type": "object",
      "properties": {
        "memory_gb": {
          "type": "number",
          "exclusiveMinimum": 0
        },
        "vram_gb": {
          "type": "number",
          "exclusiveMinimum": 0
        },
        "disk_gb": {
          "type": "number",
          "exclusiveMinimum": 0
        }
      },
      "additionalProperties": false,
      "description": "The device's memory, GPU memory and free disk in GB, for local runtimes: facts that become max_memory_gb, max_vram_gb and max_disk_gb unless constraints set them."
    },
    "shape": {
      "type": "string",
      "enum": [
        "single",
        "team",
        "escalation",
        "auto"
      ],
      "description": "As in /v1/resolve, or auto: a team purpose's team and an escalation purpose's ladder; else a team when the reading says several models would help (ensemble_helps), an escalation when the request gives length, else single."
    },
    "constraints": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      },
      "description": "Any /v1/resolve query parameter except providers, as strings; these win over the reading. When these and the recognised tags settle the task or purpose and the budget, give needs (even empty), no tag is unrecognised, and no shape is left to the reading, the prompt is not read: the reading is empty and decision.model is local."
    }
  },
  "required": [
    "providers"
  ],
  "additionalProperties": false
}
PlanResponse
PlanResponse (JSON Schema)
{
  "type": "object",
  "properties": {
    "shape": {
      "type": "string",
      "enum": [
        "single",
        "team",
        "escalation"
      ],
      "description": "single: `model`. team: `team`, with `model` its first role's first member. escalation: `escalation`, with `model` its first step."
    },
    "catalog_version": {
      "type": "string"
    },
    "need": {
      "type": "object",
      "properties": {
        "task": {
          "type": "string"
        },
        "purpose": {
          "type": "string"
        },
        "needs": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "capability": {
                "type": "string"
              },
              "level": {
                "type": "string"
              }
            },
            "required": [
              "capability",
              "level"
            ]
          }
        },
        "providers": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "provider_terms": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "kind": {
                  "type": "string"
                }
              },
              "required": [
                "kind"
              ],
              "additionalProperties": {}
            }
          }
        },
        "origin": {
          "type": "object",
          "properties": {
            "include": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "exclude": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "strict": {
              "type": "boolean"
            }
          },
          "required": [
            "include",
            "exclude",
            "strict"
          ]
        },
        "budget": {
          "type": "string"
        },
        "max_price": {
          "type": "string"
        },
        "optimize": {
          "type": "string"
        },
        "quality_margin": {
          "type": "number"
        },
        "usage": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "type": [
              "number",
              "string"
            ]
          }
        },
        "allow_preview": {
          "type": "boolean"
        },
        "allow_trial": {
          "type": "boolean"
        },
        "allow_closed": {
          "type": "boolean"
        },
        "exclude": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "service_tier": {
          "type": "string"
        },
        "hours": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "start": {
                "type": "number"
              },
              "end": {
                "type": "number"
              }
            },
            "required": [
              "start",
              "end"
            ]
          },
          "description": "The request's hours, as UTC hours from start to end."
        },
        "currency": {
          "type": "string"
        }
      },
      "required": [
        "task",
        "needs",
        "providers",
        "provider_terms",
        "optimize",
        "quality_margin",
        "usage",
        "allow_preview",
        "exclude",
        "service_tier"
      ],
      "additionalProperties": {}
    },
    "model": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Canonical model id, vendor/model."
        },
        "vendor": {
          "type": "string"
        },
        "origin": {
          "type": "string"
        },
        "provider": {
          "type": "string"
        },
        "provider_model_id": {
          "type": "string",
          "description": "Use this as the model name in the provider's API."
        },
        "status": {
          "type": "string",
          "enum": [
            "preview",
            "ga",
            "deprecated",
            "retired"
          ]
        },
        "released": {
          "type": "string"
        },
        "capabilities": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "type": "object",
            "properties": {
              "level": {
                "type": "string",
                "enum": [
                  "claimed",
                  "parsed",
                  "native",
                  "probed"
                ]
              },
              "probed_on": {
                "type": "string"
              },
              "efforts": {
                "description": "Reasoning effort levels the offering accepts, for reasoning.",
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "required": [
              "level"
            ]
          }
        },
        "limits": {
          "type": "object",
          "properties": {
            "context": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "max_input": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "max_output": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "dimensions": {
              "description": "Embedding vector length, as a probe measured it.",
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            }
          }
        },
        "price": {
          "type": "object",
          "properties": {
            "currency": {
              "type": "string"
            },
            "per_1m": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {
                "type": "string",
                "description": "A decimal number as a string; never a float."
              }
            },
            "typical_call": {
              "type": "string",
              "description": "USD, after fees and your provider_terms, at the day's highest rate."
            },
            "typical_call_average": {
              "type": "string",
              "description": "With cheaper hours: typical_call averaged over the request's hours, or over a flat week without them, which is what answers rank on."
            },
            "per_1m_average": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {
                "type": "string",
                "description": "A decimal number as a string; never a float."
              },
              "description": "With cheaper hours: per_1m averaged over the request's hours, or over a flat week without them."
            },
            "time_windows": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "days": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "start": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  "end": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  "per_1m": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "type": "string",
                      "description": "A decimal number as a string; never a float."
                    }
                  }
                },
                "required": [
                  "per_1m"
                ],
                "description": "Hours a price is below per_1m, in UTC. days are lower-case English names, and none means every day. start and end are hhmm, an end of 0 means midnight, and neither means the whole day."
              }
            },
            "converted": {
              "type": "object",
              "properties": {
                "currency": {
                  "type": "string"
                },
                "typical_call": {
                  "type": "string",
                  "description": "A decimal number as a string; never a float."
                },
                "typical_call_average": {
                  "type": "string",
                  "description": "A decimal number as a string; never a float."
                }
              },
              "required": [
                "currency",
                "typical_call"
              ]
            },
            "unverified": {
              "type": "boolean"
            }
          },
          "required": [
            "currency",
            "per_1m",
            "typical_call"
          ]
        },
        "quality": {
          "type": "object",
          "properties": {
            "score": {
              "type": "number"
            },
            "basis": {
              "type": "string",
              "description": "<source>:<signal>, or curated."
            },
            "measured_on": {
              "type": "string"
            },
            "attribution": {
              "type": "string",
              "description": "Show this wherever the score is shown."
            },
            "kind": {
              "type": "string",
              "enum": [
                "measured",
                "estimated"
              ]
            },
            "quantization_penalty": {
              "type": "number",
              "description": "Local runtimes: taken off the model's score for the quantization (q8_0 0, q6_K 0.005, q5_K_M 0.01, q4_K_M 0.03); above 0 the score is an estimate."
            }
          },
          "required": [
            "score",
            "basis",
            "measured_on",
            "attribution",
            "kind"
          ]
        },
        "routing": {
          "description": "Provider-specific request fields the answer depends on; send them with the call. On OpenRouter with needs=zdr: { \"openrouter\": { \"provider\": { \"zdr\": true } } }, so OpenRouter routes only to zero-data-retention upstreams.",
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {}
          }
        },
        "quantization": {
          "type": "string",
          "description": "Local runtimes: the weights' quantization, e.g. \"Q4_K_M\"."
        },
        "parameters_b": {
          "type": "number",
          "description": "Local runtimes: parameters, in billions."
        },
        "requirements": {
          "type": "object",
          "properties": {
            "memory_gb": {
              "type": "number",
              "description": "Memory to run it: weights, KV cache at context_for_memory tokens and about 10% runtime overhead. GB are 10^9 bytes."
            },
            "vram_gb": {
              "type": "number",
              "description": "GPU memory for a full offload, at the same context."
            },
            "disk_gb": {
              "type": "number",
              "description": "The weights' download size."
            },
            "context_for_memory": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991,
              "description": "The context, in tokens, memory_gb is stated at: the request's min_context when larger than the stored 8,192 (WebLLM: its fixed context)."
            },
            "kv_bytes_per_token": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991,
              "description": "KV cache bytes per further token of context."
            },
            "low_resource": {
              "type": "boolean",
              "description": "WebLLM: runs on low-resource devices."
            }
          },
          "required": [
            "memory_gb",
            "context_for_memory"
          ],
          "description": "Local runtimes: what the device needs."
        },
        "license": {
          "type": "string",
          "description": "Local runtimes: the weights' license, e.g. \"apache-2.0\"."
        }
      },
      "required": [
        "id",
        "vendor",
        "provider",
        "provider_model_id",
        "status",
        "capabilities",
        "limits"
      ]
    },
    "also_on": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "provider": {
            "type": "string"
          },
          "provider_model_id": {
            "type": "string"
          },
          "typical_call": {
            "type": "string",
            "description": "A decimal number as a string; never a float."
          },
          "typical_call_average": {
            "type": "string",
            "description": "A decimal number as a string; never a float."
          },
          "note": {
            "type": "string"
          }
        },
        "required": [
          "provider",
          "provider_model_id"
        ]
      }
    },
    "alternatives": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Canonical model id, vendor/model."
          },
          "vendor": {
            "type": "string"
          },
          "origin": {
            "type": "string"
          },
          "provider": {
            "type": "string"
          },
          "provider_model_id": {
            "type": "string",
            "description": "Use this as the model name in the provider's API."
          },
          "status": {
            "type": "string",
            "enum": [
              "preview",
              "ga",
              "deprecated",
              "retired"
            ]
          },
          "released": {
            "type": "string"
          },
          "capabilities": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {
              "type": "object",
              "properties": {
                "level": {
                  "type": "string",
                  "enum": [
                    "claimed",
                    "parsed",
                    "native",
                    "probed"
                  ]
                },
                "probed_on": {
                  "type": "string"
                },
                "efforts": {
                  "description": "Reasoning effort levels the offering accepts, for reasoning.",
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              },
              "required": [
                "level"
              ]
            }
          },
          "limits": {
            "type": "object",
            "properties": {
              "context": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              "max_input": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              "max_output": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              "dimensions": {
                "description": "Embedding vector length, as a probe measured it.",
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              }
            }
          },
          "price": {
            "type": "object",
            "properties": {
              "currency": {
                "type": "string"
              },
              "per_1m": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {
                  "type": "string",
                  "description": "A decimal number as a string; never a float."
                }
              },
              "typical_call": {
                "type": "string",
                "description": "USD, after fees and your provider_terms, at the day's highest rate."
              },
              "typical_call_average": {
                "type": "string",
                "description": "With cheaper hours: typical_call averaged over the request's hours, or over a flat week without them, which is what answers rank on."
              },
              "per_1m_average": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {
                  "type": "string",
                  "description": "A decimal number as a string; never a float."
                },
                "description": "With cheaper hours: per_1m averaged over the request's hours, or over a flat week without them."
              },
              "time_windows": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "days": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "start": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "end": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "per_1m": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "type": "string",
                        "description": "A decimal number as a string; never a float."
                      }
                    }
                  },
                  "required": [
                    "per_1m"
                  ],
                  "description": "Hours a price is below per_1m, in UTC. days are lower-case English names, and none means every day. start and end are hhmm, an end of 0 means midnight, and neither means the whole day."
                }
              },
              "converted": {
                "type": "object",
                "properties": {
                  "currency": {
                    "type": "string"
                  },
                  "typical_call": {
                    "type": "string",
                    "description": "A decimal number as a string; never a float."
                  },
                  "typical_call_average": {
                    "type": "string",
                    "description": "A decimal number as a string; never a float."
                  }
                },
                "required": [
                  "currency",
                  "typical_call"
                ]
              },
              "unverified": {
                "type": "boolean"
              }
            },
            "required": [
              "currency",
              "per_1m",
              "typical_call"
            ]
          },
          "quality": {
            "type": "object",
            "properties": {
              "score": {
                "type": "number"
              },
              "basis": {
                "type": "string",
                "description": "<source>:<signal>, or curated."
              },
              "measured_on": {
                "type": "string"
              },
              "attribution": {
                "type": "string",
                "description": "Show this wherever the score is shown."
              },
              "kind": {
                "type": "string",
                "enum": [
                  "measured",
                  "estimated"
                ]
              },
              "quantization_penalty": {
                "type": "number",
                "description": "Local runtimes: taken off the model's score for the quantization (q8_0 0, q6_K 0.005, q5_K_M 0.01, q4_K_M 0.03); above 0 the score is an estimate."
              }
            },
            "required": [
              "score",
              "basis",
              "measured_on",
              "attribution",
              "kind"
            ]
          },
          "routing": {
            "description": "Provider-specific request fields the answer depends on; send them with the call. On OpenRouter with needs=zdr: { \"openrouter\": { \"provider\": { \"zdr\": true } } }, so OpenRouter routes only to zero-data-retention upstreams.",
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            }
          },
          "quantization": {
            "type": "string",
            "description": "Local runtimes: the weights' quantization, e.g. \"Q4_K_M\"."
          },
          "parameters_b": {
            "type": "number",
            "description": "Local runtimes: parameters, in billions."
          },
          "requirements": {
            "type": "object",
            "properties": {
              "memory_gb": {
                "type": "number",
                "description": "Memory to run it: weights, KV cache at context_for_memory tokens and about 10% runtime overhead. GB are 10^9 bytes."
              },
              "vram_gb": {
                "type": "number",
                "description": "GPU memory for a full offload, at the same context."
              },
              "disk_gb": {
                "type": "number",
                "description": "The weights' download size."
              },
              "context_for_memory": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991,
                "description": "The context, in tokens, memory_gb is stated at: the request's min_context when larger than the stored 8,192 (WebLLM: its fixed context)."
              },
              "kv_bytes_per_token": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991,
                "description": "KV cache bytes per further token of context."
              },
              "low_resource": {
                "type": "boolean",
                "description": "WebLLM: runs on low-resource devices."
              }
            },
            "required": [
              "memory_gb",
              "context_for_memory"
            ],
            "description": "Local runtimes: what the device needs."
          },
          "license": {
            "type": "string",
            "description": "Local runtimes: the weights' license, e.g. \"apache-2.0\"."
          }
        },
        "required": [
          "id",
          "vendor",
          "provider",
          "provider_model_id",
          "status",
          "capabilities",
          "limits"
        ]
      }
    },
    "reason": {
      "type": "string"
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          }
        },
        "required": [
          "code"
        ],
        "additionalProperties": {}
      }
    },
    "team": {
      "type": "object",
      "properties": {
        "strategy": {
          "type": "string"
        },
        "roles": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "type": "object",
            "properties": {
              "task": {
                "type": "string"
              },
              "members": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Canonical model id, vendor/model."
                    },
                    "vendor": {
                      "type": "string"
                    },
                    "origin": {
                      "type": "string"
                    },
                    "provider": {
                      "type": "string"
                    },
                    "provider_model_id": {
                      "type": "string",
                      "description": "Use this as the model name in the provider's API."
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "preview",
                        "ga",
                        "deprecated",
                        "retired"
                      ]
                    },
                    "released": {
                      "type": "string"
                    },
                    "capabilities": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "type": "object",
                        "properties": {
                          "level": {
                            "type": "string",
                            "enum": [
                              "claimed",
                              "parsed",
                              "native",
                              "probed"
                            ]
                          },
                          "probed_on": {
                            "type": "string"
                          },
                          "efforts": {
                            "description": "Reasoning effort levels the offering accepts, for reasoning.",
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          }
                        },
                        "required": [
                          "level"
                        ]
                      }
                    },
                    "limits": {
                      "type": "object",
                      "properties": {
                        "context": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "max_input": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "max_output": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "dimensions": {
                          "description": "Embedding vector length, as a probe measured it.",
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        }
                      }
                    },
                    "price": {
                      "type": "object",
                      "properties": {
                        "currency": {
                          "type": "string"
                        },
                        "per_1m": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "type": "string",
                            "description": "A decimal number as a string; never a float."
                          }
                        },
                        "typical_call": {
                          "type": "string",
                          "description": "USD, after fees and your provider_terms, at the day's highest rate."
                        },
                        "typical_call_average": {
                          "type": "string",
                          "description": "With cheaper hours: typical_call averaged over the request's hours, or over a flat week without them, which is what answers rank on."
                        },
                        "per_1m_average": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "type": "string",
                            "description": "A decimal number as a string; never a float."
                          },
                          "description": "With cheaper hours: per_1m averaged over the request's hours, or over a flat week without them."
                        },
                        "time_windows": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "days": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "start": {
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              },
                              "end": {
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              },
                              "per_1m": {
                                "type": "object",
                                "propertyNames": {
                                  "type": "string"
                                },
                                "additionalProperties": {
                                  "type": "string",
                                  "description": "A decimal number as a string; never a float."
                                }
                              }
                            },
                            "required": [
                              "per_1m"
                            ],
                            "description": "Hours a price is below per_1m, in UTC. days are lower-case English names, and none means every day. start and end are hhmm, an end of 0 means midnight, and neither means the whole day."
                          }
                        },
                        "converted": {
                          "type": "object",
                          "properties": {
                            "currency": {
                              "type": "string"
                            },
                            "typical_call": {
                              "type": "string",
                              "description": "A decimal number as a string; never a float."
                            },
                            "typical_call_average": {
                              "type": "string",
                              "description": "A decimal number as a string; never a float."
                            }
                          },
                          "required": [
                            "currency",
                            "typical_call"
                          ]
                        },
                        "unverified": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "currency",
                        "per_1m",
                        "typical_call"
                      ]
                    },
                    "quality": {
                      "type": "object",
                      "properties": {
                        "score": {
                          "type": "number"
                        },
                        "basis": {
                          "type": "string",
                          "description": "<source>:<signal>, or curated."
                        },
                        "measured_on": {
                          "type": "string"
                        },
                        "attribution": {
                          "type": "string",
                          "description": "Show this wherever the score is shown."
                        },
                        "kind": {
                          "type": "string",
                          "enum": [
                            "measured",
                            "estimated"
                          ]
                        },
                        "quantization_penalty": {
                          "type": "number",
                          "description": "Local runtimes: taken off the model's score for the quantization (q8_0 0, q6_K 0.005, q5_K_M 0.01, q4_K_M 0.03); above 0 the score is an estimate."
                        }
                      },
                      "required": [
                        "score",
                        "basis",
                        "measured_on",
                        "attribution",
                        "kind"
                      ]
                    },
                    "routing": {
                      "description": "Provider-specific request fields the answer depends on; send them with the call. On OpenRouter with needs=zdr: { \"openrouter\": { \"provider\": { \"zdr\": true } } }, so OpenRouter routes only to zero-data-retention upstreams.",
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {}
                      }
                    },
                    "quantization": {
                      "type": "string",
                      "description": "Local runtimes: the weights' quantization, e.g. \"Q4_K_M\"."
                    },
                    "parameters_b": {
                      "type": "number",
                      "description": "Local runtimes: parameters, in billions."
                    },
                    "requirements": {
                      "type": "object",
                      "properties": {
                        "memory_gb": {
                          "type": "number",
                          "description": "Memory to run it: weights, KV cache at context_for_memory tokens and about 10% runtime overhead. GB are 10^9 bytes."
                        },
                        "vram_gb": {
                          "type": "number",
                          "description": "GPU memory for a full offload, at the same context."
                        },
                        "disk_gb": {
                          "type": "number",
                          "description": "The weights' download size."
                        },
                        "context_for_memory": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991,
                          "description": "The context, in tokens, memory_gb is stated at: the request's min_context when larger than the stored 8,192 (WebLLM: its fixed context)."
                        },
                        "kv_bytes_per_token": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991,
                          "description": "KV cache bytes per further token of context."
                        },
                        "low_resource": {
                          "type": "boolean",
                          "description": "WebLLM: runs on low-resource devices."
                        }
                      },
                      "required": [
                        "memory_gb",
                        "context_for_memory"
                      ],
                      "description": "Local runtimes: what the device needs."
                    },
                    "license": {
                      "type": "string",
                      "description": "Local runtimes: the weights' license, e.g. \"apache-2.0\"."
                    }
                  },
                  "required": [
                    "id",
                    "vendor",
                    "provider",
                    "provider_model_id",
                    "status",
                    "capabilities",
                    "limits"
                  ]
                }
              }
            },
            "required": [
              "task",
              "members"
            ]
          },
          "description": "Role name → its task and members, in the roles' order."
        },
        "typical_call": {
          "type": "string",
          "description": "The whole team's typical call in USD, when every member is priced."
        }
      },
      "required": [
        "roles"
      ],
      "description": "shape=team: the members by role."
    },
    "escalation": {
      "type": "object",
      "properties": {
        "steps": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Canonical model id, vendor/model."
              },
              "vendor": {
                "type": "string"
              },
              "origin": {
                "type": "string"
              },
              "provider": {
                "type": "string"
              },
              "provider_model_id": {
                "type": "string",
                "description": "Use this as the model name in the provider's API."
              },
              "status": {
                "type": "string",
                "enum": [
                  "preview",
                  "ga",
                  "deprecated",
                  "retired"
                ]
              },
              "released": {
                "type": "string"
              },
              "capabilities": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {
                  "type": "object",
                  "properties": {
                    "level": {
                      "type": "string",
                      "enum": [
                        "claimed",
                        "parsed",
                        "native",
                        "probed"
                      ]
                    },
                    "probed_on": {
                      "type": "string"
                    },
                    "efforts": {
                      "description": "Reasoning effort levels the offering accepts, for reasoning.",
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "required": [
                    "level"
                  ]
                }
              },
              "limits": {
                "type": "object",
                "properties": {
                  "context": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  "max_input": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  "max_output": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  "dimensions": {
                    "description": "Embedding vector length, as a probe measured it.",
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  }
                }
              },
              "price": {
                "type": "object",
                "properties": {
                  "currency": {
                    "type": "string"
                  },
                  "per_1m": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "type": "string",
                      "description": "A decimal number as a string; never a float."
                    }
                  },
                  "typical_call": {
                    "type": "string",
                    "description": "USD, after fees and your provider_terms, at the day's highest rate."
                  },
                  "typical_call_average": {
                    "type": "string",
                    "description": "With cheaper hours: typical_call averaged over the request's hours, or over a flat week without them, which is what answers rank on."
                  },
                  "per_1m_average": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "type": "string",
                      "description": "A decimal number as a string; never a float."
                    },
                    "description": "With cheaper hours: per_1m averaged over the request's hours, or over a flat week without them."
                  },
                  "time_windows": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "days": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "start": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "end": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "per_1m": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "type": "string",
                            "description": "A decimal number as a string; never a float."
                          }
                        }
                      },
                      "required": [
                        "per_1m"
                      ],
                      "description": "Hours a price is below per_1m, in UTC. days are lower-case English names, and none means every day. start and end are hhmm, an end of 0 means midnight, and neither means the whole day."
                    }
                  },
                  "converted": {
                    "type": "object",
                    "properties": {
                      "currency": {
                        "type": "string"
                      },
                      "typical_call": {
                        "type": "string",
                        "description": "A decimal number as a string; never a float."
                      },
                      "typical_call_average": {
                        "type": "string",
                        "description": "A decimal number as a string; never a float."
                      }
                    },
                    "required": [
                      "currency",
                      "typical_call"
                    ]
                  },
                  "unverified": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "currency",
                  "per_1m",
                  "typical_call"
                ]
              },
              "quality": {
                "type": "object",
                "properties": {
                  "score": {
                    "type": "number"
                  },
                  "basis": {
                    "type": "string",
                    "description": "<source>:<signal>, or curated."
                  },
                  "measured_on": {
                    "type": "string"
                  },
                  "attribution": {
                    "type": "string",
                    "description": "Show this wherever the score is shown."
                  },
                  "kind": {
                    "type": "string",
                    "enum": [
                      "measured",
                      "estimated"
                    ]
                  },
                  "quantization_penalty": {
                    "type": "number",
                    "description": "Local runtimes: taken off the model's score for the quantization (q8_0 0, q6_K 0.005, q5_K_M 0.01, q4_K_M 0.03); above 0 the score is an estimate."
                  }
                },
                "required": [
                  "score",
                  "basis",
                  "measured_on",
                  "attribution",
                  "kind"
                ]
              },
              "routing": {
                "description": "Provider-specific request fields the answer depends on; send them with the call. On OpenRouter with needs=zdr: { \"openrouter\": { \"provider\": { \"zdr\": true } } }, so OpenRouter routes only to zero-data-retention upstreams.",
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {}
                }
              },
              "quantization": {
                "type": "string",
                "description": "Local runtimes: the weights' quantization, e.g. \"Q4_K_M\"."
              },
              "parameters_b": {
                "type": "number",
                "description": "Local runtimes: parameters, in billions."
              },
              "requirements": {
                "type": "object",
                "properties": {
                  "memory_gb": {
                    "type": "number",
                    "description": "Memory to run it: weights, KV cache at context_for_memory tokens and about 10% runtime overhead. GB are 10^9 bytes."
                  },
                  "vram_gb": {
                    "type": "number",
                    "description": "GPU memory for a full offload, at the same context."
                  },
                  "disk_gb": {
                    "type": "number",
                    "description": "The weights' download size."
                  },
                  "context_for_memory": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991,
                    "description": "The context, in tokens, memory_gb is stated at: the request's min_context when larger than the stored 8,192 (WebLLM: its fixed context)."
                  },
                  "kv_bytes_per_token": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991,
                    "description": "KV cache bytes per further token of context."
                  },
                  "low_resource": {
                    "type": "boolean",
                    "description": "WebLLM: runs on low-resource devices."
                  }
                },
                "required": [
                  "memory_gb",
                  "context_for_memory"
                ],
                "description": "Local runtimes: what the device needs."
              },
              "license": {
                "type": "string",
                "description": "Local runtimes: the weights' license, e.g. \"apache-2.0\"."
              }
            },
            "required": [
              "id",
              "vendor",
              "provider",
              "provider_model_id",
              "status",
              "capabilities",
              "limits"
            ]
          },
          "description": "Cheapest first; each step clears a higher quality tier."
        },
        "team": {
          "type": "object",
          "properties": {
            "strategy": {
              "type": "string"
            },
            "roles": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {
                "type": "object",
                "properties": {
                  "task": {
                    "type": "string"
                  },
                  "members": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "description": "Canonical model id, vendor/model."
                        },
                        "vendor": {
                          "type": "string"
                        },
                        "origin": {
                          "type": "string"
                        },
                        "provider": {
                          "type": "string"
                        },
                        "provider_model_id": {
                          "type": "string",
                          "description": "Use this as the model name in the provider's API."
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "preview",
                            "ga",
                            "deprecated",
                            "retired"
                          ]
                        },
                        "released": {
                          "type": "string"
                        },
                        "capabilities": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "type": "object",
                            "properties": {
                              "level": {
                                "type": "string",
                                "enum": [
                                  "claimed",
                                  "parsed",
                                  "native",
                                  "probed"
                                ]
                              },
                              "probed_on": {
                                "type": "string"
                              },
                              "efforts": {
                                "description": "Reasoning effort levels the offering accepts, for reasoning.",
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              }
                            },
                            "required": [
                              "level"
                            ]
                          }
                        },
                        "limits": {
                          "type": "object",
                          "properties": {
                            "context": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "max_input": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "max_output": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "dimensions": {
                              "description": "Embedding vector length, as a probe measured it.",
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            }
                          }
                        },
                        "price": {
                          "type": "object",
                          "properties": {
                            "currency": {
                              "type": "string"
                            },
                            "per_1m": {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "type": "string",
                                "description": "A decimal number as a string; never a float."
                              }
                            },
                            "typical_call": {
                              "type": "string",
                              "description": "USD, after fees and your provider_terms, at the day's highest rate."
                            },
                            "typical_call_average": {
                              "type": "string",
                              "description": "With cheaper hours: typical_call averaged over the request's hours, or over a flat week without them, which is what answers rank on."
                            },
                            "per_1m_average": {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "type": "string",
                                "description": "A decimal number as a string; never a float."
                              },
                              "description": "With cheaper hours: per_1m averaged over the request's hours, or over a flat week without them."
                            },
                            "time_windows": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "days": {
                                    "type": "array",
                                    "items": {
                                      "type": "string"
                                    }
                                  },
                                  "start": {
                                    "type": "integer",
                                    "minimum": -9007199254740991,
                                    "maximum": 9007199254740991
                                  },
                                  "end": {
                                    "type": "integer",
                                    "minimum": -9007199254740991,
                                    "maximum": 9007199254740991
                                  },
                                  "per_1m": {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string"
                                    },
                                    "additionalProperties": {
                                      "type": "string",
                                      "description": "A decimal number as a string; never a float."
                                    }
                                  }
                                },
                                "required": [
                                  "per_1m"
                                ],
                                "description": "Hours a price is below per_1m, in UTC. days are lower-case English names, and none means every day. start and end are hhmm, an end of 0 means midnight, and neither means the whole day."
                              }
                            },
                            "converted": {
                              "type": "object",
                              "properties": {
                                "currency": {
                                  "type": "string"
                                },
                                "typical_call": {
                                  "type": "string",
                                  "description": "A decimal number as a string; never a float."
                                },
                                "typical_call_average": {
                                  "type": "string",
                                  "description": "A decimal number as a string; never a float."
                                }
                              },
                              "required": [
                                "currency",
                                "typical_call"
                              ]
                            },
                            "unverified": {
                              "type": "boolean"
                            }
                          },
                          "required": [
                            "currency",
                            "per_1m",
                            "typical_call"
                          ]
                        },
                        "quality": {
                          "type": "object",
                          "properties": {
                            "score": {
                              "type": "number"
                            },
                            "basis": {
                              "type": "string",
                              "description": "<source>:<signal>, or curated."
                            },
                            "measured_on": {
                              "type": "string"
                            },
                            "attribution": {
                              "type": "string",
                              "description": "Show this wherever the score is shown."
                            },
                            "kind": {
                              "type": "string",
                              "enum": [
                                "measured",
                                "estimated"
                              ]
                            },
                            "quantization_penalty": {
                              "type": "number",
                              "description": "Local runtimes: taken off the model's score for the quantization (q8_0 0, q6_K 0.005, q5_K_M 0.01, q4_K_M 0.03); above 0 the score is an estimate."
                            }
                          },
                          "required": [
                            "score",
                            "basis",
                            "measured_on",
                            "attribution",
                            "kind"
                          ]
                        },
                        "routing": {
                          "description": "Provider-specific request fields the answer depends on; send them with the call. On OpenRouter with needs=zdr: { \"openrouter\": { \"provider\": { \"zdr\": true } } }, so OpenRouter routes only to zero-data-retention upstreams.",
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {}
                          }
                        },
                        "quantization": {
                          "type": "string",
                          "description": "Local runtimes: the weights' quantization, e.g. \"Q4_K_M\"."
                        },
                        "parameters_b": {
                          "type": "number",
                          "description": "Local runtimes: parameters, in billions."
                        },
                        "requirements": {
                          "type": "object",
                          "properties": {
                            "memory_gb": {
                              "type": "number",
                              "description": "Memory to run it: weights, KV cache at context_for_memory tokens and about 10% runtime overhead. GB are 10^9 bytes."
                            },
                            "vram_gb": {
                              "type": "number",
                              "description": "GPU memory for a full offload, at the same context."
                            },
                            "disk_gb": {
                              "type": "number",
                              "description": "The weights' download size."
                            },
                            "context_for_memory": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991,
                              "description": "The context, in tokens, memory_gb is stated at: the request's min_context when larger than the stored 8,192 (WebLLM: its fixed context)."
                            },
                            "kv_bytes_per_token": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991,
                              "description": "KV cache bytes per further token of context."
                            },
                            "low_resource": {
                              "type": "boolean",
                              "description": "WebLLM: runs on low-resource devices."
                            }
                          },
                          "required": [
                            "memory_gb",
                            "context_for_memory"
                          ],
                          "description": "Local runtimes: what the device needs."
                        },
                        "license": {
                          "type": "string",
                          "description": "Local runtimes: the weights' license, e.g. \"apache-2.0\"."
                        }
                      },
                      "required": [
                        "id",
                        "vendor",
                        "provider",
                        "provider_model_id",
                        "status",
                        "capabilities",
                        "limits"
                      ]
                    }
                  }
                },
                "required": [
                  "task",
                  "members"
                ]
              },
              "description": "Role name → its task and members, in the roles' order."
            },
            "typical_call": {
              "type": "string",
              "description": "The whole team's typical call in USD, when every member is priced."
            }
          },
          "required": [
            "roles"
          ],
          "description": "Check then escalate: the team to escalate to."
        }
      },
      "required": [
        "steps"
      ],
      "description": "shape=escalation: the steps, and the team to escalate to."
    },
    "sources": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string",
        "enum": [
          "fact",
          "tag",
          "decision",
          "request",
          "default"
        ]
      },
      "description": "Need field → where it came from (fact, tag, decision, request, default)."
    },
    "reading": {
      "type": "object",
      "properties": {
        "purpose": {
          "type": "string",
          "description": "The purpose preset the request reads as."
        },
        "task": {
          "type": "string"
        },
        "category": {
          "type": "string"
        },
        "difficulty": {
          "type": "number",
          "description": "1 (trivial) to 5 (expert)."
        },
        "stakes": {
          "type": "number",
          "description": "1 (casual) to 5 (critical)."
        },
        "answer_shape": {
          "type": "string"
        },
        "domain": {
          "type": "string"
        },
        "needs_reasoning": {
          "type": "boolean"
        },
        "needs_tools": {
          "type": "boolean"
        },
        "needs_web": {
          "type": "boolean"
        },
        "ensemble_helps": {
          "type": "boolean",
          "description": "Whether several models would help; with shape auto it picks a team."
        },
        "adversarial": {
          "type": "boolean"
        },
        "ambiguous": {
          "type": "boolean"
        },
        "budget": {
          "type": "string",
          "description": "Read from tags the synonym list did not know."
        },
        "origin": {
          "type": "string",
          "description": "Read from tags the synonym list did not know."
        }
      },
      "additionalProperties": {},
      "description": "The decision model's structured reading (never the prompt)."
    },
    "decision": {
      "type": "object",
      "properties": {
        "model": {
          "type": "string",
          "enum": [
            "openai",
            "local",
            "jev"
          ],
          "description": "The model that read the request (local when the prompt never left the server)."
        },
        "latency_ms": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "fallback_used": {
          "type": "boolean",
          "description": "The local classifier answered instead of the model asked."
        },
        "fallback_reason": {
          "type": "string",
          "enum": [
            "timeout",
            "error",
            "invalid",
            "unavailable",
            "budget_exhausted"
          ],
          "description": "Why the local classifier answered, when it did."
        },
        "cached": {
          "type": "boolean"
        }
      },
      "required": [
        "model",
        "latency_ms",
        "fallback_used",
        "cached"
      ]
    }
  },
  "required": [
    "shape",
    "catalog_version",
    "need",
    "model",
    "also_on",
    "alternatives",
    "reason",
    "warnings",
    "sources",
    "reading",
    "decision"
  ]
}
StackRequest
StackRequest (JSON Schema)
{
  "type": "object",
  "properties": {
    "systems": {
      "minItems": 1,
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 100,
        "pattern": "\\S"
      },
      "description": "Required. The systems the agent works with, by id, name or alias, e.g. [\"Linear\", \"github\", \"postgres\"]. Each is matched exactly (case and punctuation aside) against the curated list; one that matches nothing comes back in `unknown_systems` and the rest are answered."
    },
    "target": {
      "type": "string",
      "enum": [
        "local",
        "cloud"
      ],
      "description": "Required. Where the agent runs. local: on a person's machine, with a shell, so a system's command-line tool can be the choice. cloud: only a remote server qualifies."
    },
    "harness": {
      "type": "string",
      "maxLength": 100,
      "pattern": "\\S",
      "description": "The client the agent runs in, by id (the 400 for an unknown one lists them). It decides what is possible: a local server needs one that can start it, skills one that loads them. Left out, a client that can do all of it is assumed, and `assumptions` says so."
    },
    "tenancy": {
      "type": "string",
      "enum": [
        "single",
        "multi"
      ],
      "description": "single (default): the agent acts for one user or team. multi: it serves several tenants, so a server that takes one fixed key is warned about."
    },
    "actions": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "read",
          "write",
          "code_execution",
          "untrusted_input"
        ]
      },
      "description": "What the agent does; default [\"read\"]. untrusted_input (it reads text from outside) together with write or code_execution is warned about."
    },
    "prefer": {
      "type": "string",
      "enum": [
        "cli",
        "server"
      ],
      "description": "For a local agent and a system with a curated command-line tool: cli (default) chooses the tool, server its owner's server when there is one."
    },
    "model": {
      "type": "object",
      "properties": {
        "providers": {
          "minItems": 1,
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Provider names, in order of preference for ties."
        },
        "constraints": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "type": "string"
          },
          "description": "Any /v1/resolve query parameter except providers, as strings, and except shape, strategy, roles, length, synthesis, origin_mix, providers_distinct: a stack has one model. With neither task nor purpose, the purpose is agent-with-tools."
        }
      },
      "required": [
        "providers"
      ],
      "additionalProperties": false,
      "description": "The providers to choose the agent's model on, as /v1/resolve would. Left out, no model is chosen and the rest is still answered."
    },
    "needs": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "web_search",
          "web_reading",
          "browser"
        ]
      },
      "description": "What the agent needs beyond its systems: web_search, web_reading (fetching pages as text), browser. Each adds a part to `infrastructure`, as `code_execution` in `actions` adds a sandbox."
    },
    "infra": {
      "type": "object",
      "properties": {
        "vendors": {
          "maxItems": 12,
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 100,
            "pattern": "\\S"
          },
          "description": "The infrastructure vendors you have accounts with, by name, e.g. [\"Vercel\", \"e2b\"]. A product is chosen only among these, by price alone; with none named, products are listed and none is chosen. A vendor's name is every product of that vendor's; a product's own id, written exactly, is that product alone. A name that matches nothing comes back in `unknown_infra_vendors`."
        },
        "usage": {
          "type": "object",
          "properties": {
            "seconds": {
              "description": "How long a sandbox or a browser exists in a month, in all: seconds on the wall clock. Given with `vcpus` and `memory_gib` for an agent that runs code, it is the sandbox's: a browser's hours are then not stated, and it is priced for its reference job.",
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000000
            },
            "vcpus": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000000
            },
            "memory_gib": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000000
            },
            "busy_share": {
              "type": "number",
              "minimum": 0,
              "maximum": 1,
              "description": "The share of that time its processors compute, 0 to 1; 1 when left out."
            },
            "runs": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000000
            },
            "searches": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000000
            },
            "results_per_search": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000000
            },
            "pages": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000000
            },
            "transfer_gib": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000000
            }
          },
          "additionalProperties": false,
          "description": "A month of what the agent will use. With it, each product is priced as a month's bill on its cheapest plan; without it, for a stated reference job at listed rates, which the answer names. Nothing is assumed about your usage."
        }
      },
      "additionalProperties": false,
      "description": "Infrastructure the agent runs on. Only read when `actions` or `needs` imply some."
    }
  },
  "required": [
    "systems",
    "target"
  ],
  "additionalProperties": false
}
StackResponse
StackResponse (JSON Schema)
{
  "type": "object",
  "properties": {
    "catalog_version": {
      "type": "string",
      "description": "The model catalog answered from."
    },
    "agent_catalog_version": {
      "type": "string",
      "description": "The agent catalog (systems, servers, skills) answered from."
    },
    "model": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "shape": {
              "type": "string",
              "const": "single"
            },
            "catalog_version": {
              "type": "string"
            },
            "model": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Canonical model id, vendor/model."
                },
                "vendor": {
                  "type": "string"
                },
                "origin": {
                  "type": "string"
                },
                "provider": {
                  "type": "string"
                },
                "provider_model_id": {
                  "type": "string",
                  "description": "Use this as the model name in the provider's API."
                },
                "status": {
                  "type": "string",
                  "enum": [
                    "preview",
                    "ga",
                    "deprecated",
                    "retired"
                  ]
                },
                "released": {
                  "type": "string"
                },
                "capabilities": {
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {
                    "type": "object",
                    "properties": {
                      "level": {
                        "type": "string",
                        "enum": [
                          "claimed",
                          "parsed",
                          "native",
                          "probed"
                        ]
                      },
                      "probed_on": {
                        "type": "string"
                      },
                      "efforts": {
                        "description": "Reasoning effort levels the offering accepts, for reasoning.",
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      }
                    },
                    "required": [
                      "level"
                    ]
                  }
                },
                "limits": {
                  "type": "object",
                  "properties": {
                    "context": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "max_input": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "max_output": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "dimensions": {
                      "description": "Embedding vector length, as a probe measured it.",
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    }
                  }
                },
                "price": {
                  "type": "object",
                  "properties": {
                    "currency": {
                      "type": "string"
                    },
                    "per_1m": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "type": "string",
                        "description": "A decimal number as a string; never a float."
                      }
                    },
                    "typical_call": {
                      "type": "string",
                      "description": "USD, after fees and your provider_terms, at the day's highest rate."
                    },
                    "typical_call_average": {
                      "type": "string",
                      "description": "With cheaper hours: typical_call averaged over the request's hours, or over a flat week without them, which is what answers rank on."
                    },
                    "per_1m_average": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "type": "string",
                        "description": "A decimal number as a string; never a float."
                      },
                      "description": "With cheaper hours: per_1m averaged over the request's hours, or over a flat week without them."
                    },
                    "time_windows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "days": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "start": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "end": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "per_1m": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {
                              "type": "string",
                              "description": "A decimal number as a string; never a float."
                            }
                          }
                        },
                        "required": [
                          "per_1m"
                        ],
                        "description": "Hours a price is below per_1m, in UTC. days are lower-case English names, and none means every day. start and end are hhmm, an end of 0 means midnight, and neither means the whole day."
                      }
                    },
                    "converted": {
                      "type": "object",
                      "properties": {
                        "currency": {
                          "type": "string"
                        },
                        "typical_call": {
                          "type": "string",
                          "description": "A decimal number as a string; never a float."
                        },
                        "typical_call_average": {
                          "type": "string",
                          "description": "A decimal number as a string; never a float."
                        }
                      },
                      "required": [
                        "currency",
                        "typical_call"
                      ]
                    },
                    "unverified": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "currency",
                    "per_1m",
                    "typical_call"
                  ]
                },
                "quality": {
                  "type": "object",
                  "properties": {
                    "score": {
                      "type": "number"
                    },
                    "basis": {
                      "type": "string",
                      "description": "<source>:<signal>, or curated."
                    },
                    "measured_on": {
                      "type": "string"
                    },
                    "attribution": {
                      "type": "string",
                      "description": "Show this wherever the score is shown."
                    },
                    "kind": {
                      "type": "string",
                      "enum": [
                        "measured",
                        "estimated"
                      ]
                    },
                    "quantization_penalty": {
                      "type": "number",
                      "description": "Local runtimes: taken off the model's score for the quantization (q8_0 0, q6_K 0.005, q5_K_M 0.01, q4_K_M 0.03); above 0 the score is an estimate."
                    }
                  },
                  "required": [
                    "score",
                    "basis",
                    "measured_on",
                    "attribution",
                    "kind"
                  ]
                },
                "routing": {
                  "description": "Provider-specific request fields the answer depends on; send them with the call. On OpenRouter with needs=zdr: { \"openrouter\": { \"provider\": { \"zdr\": true } } }, so OpenRouter routes only to zero-data-retention upstreams.",
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {}
                  }
                },
                "quantization": {
                  "type": "string",
                  "description": "Local runtimes: the weights' quantization, e.g. \"Q4_K_M\"."
                },
                "parameters_b": {
                  "type": "number",
                  "description": "Local runtimes: parameters, in billions."
                },
                "requirements": {
                  "type": "object",
                  "properties": {
                    "memory_gb": {
                      "type": "number",
                      "description": "Memory to run it: weights, KV cache at context_for_memory tokens and about 10% runtime overhead. GB are 10^9 bytes."
                    },
                    "vram_gb": {
                      "type": "number",
                      "description": "GPU memory for a full offload, at the same context."
                    },
                    "disk_gb": {
                      "type": "number",
                      "description": "The weights' download size."
                    },
                    "context_for_memory": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991,
                      "description": "The context, in tokens, memory_gb is stated at: the request's min_context when larger than the stored 8,192 (WebLLM: its fixed context)."
                    },
                    "kv_bytes_per_token": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991,
                      "description": "KV cache bytes per further token of context."
                    },
                    "low_resource": {
                      "type": "boolean",
                      "description": "WebLLM: runs on low-resource devices."
                    }
                  },
                  "required": [
                    "memory_gb",
                    "context_for_memory"
                  ],
                  "description": "Local runtimes: what the device needs."
                },
                "license": {
                  "type": "string",
                  "description": "Local runtimes: the weights' license, e.g. \"apache-2.0\"."
                }
              },
              "required": [
                "id",
                "vendor",
                "provider",
                "provider_model_id",
                "status",
                "capabilities",
                "limits"
              ]
            },
            "also_on": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "provider": {
                    "type": "string"
                  },
                  "provider_model_id": {
                    "type": "string"
                  },
                  "typical_call": {
                    "type": "string",
                    "description": "A decimal number as a string; never a float."
                  },
                  "typical_call_average": {
                    "type": "string",
                    "description": "A decimal number as a string; never a float."
                  },
                  "note": {
                    "type": "string"
                  }
                },
                "required": [
                  "provider",
                  "provider_model_id"
                ]
              }
            },
            "alternatives": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Canonical model id, vendor/model."
                  },
                  "vendor": {
                    "type": "string"
                  },
                  "origin": {
                    "type": "string"
                  },
                  "provider": {
                    "type": "string"
                  },
                  "provider_model_id": {
                    "type": "string",
                    "description": "Use this as the model name in the provider's API."
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "preview",
                      "ga",
                      "deprecated",
                      "retired"
                    ]
                  },
                  "released": {
                    "type": "string"
                  },
                  "capabilities": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "type": "object",
                      "properties": {
                        "level": {
                          "type": "string",
                          "enum": [
                            "claimed",
                            "parsed",
                            "native",
                            "probed"
                          ]
                        },
                        "probed_on": {
                          "type": "string"
                        },
                        "efforts": {
                          "description": "Reasoning effort levels the offering accepts, for reasoning.",
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "level"
                      ]
                    }
                  },
                  "limits": {
                    "type": "object",
                    "properties": {
                      "context": {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      },
                      "max_input": {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      },
                      "max_output": {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      },
                      "dimensions": {
                        "description": "Embedding vector length, as a probe measured it.",
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      }
                    }
                  },
                  "price": {
                    "type": "object",
                    "properties": {
                      "currency": {
                        "type": "string"
                      },
                      "per_1m": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "type": "string",
                          "description": "A decimal number as a string; never a float."
                        }
                      },
                      "typical_call": {
                        "type": "string",
                        "description": "USD, after fees and your provider_terms, at the day's highest rate."
                      },
                      "typical_call_average": {
                        "type": "string",
                        "description": "With cheaper hours: typical_call averaged over the request's hours, or over a flat week without them, which is what answers rank on."
                      },
                      "per_1m_average": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "type": "string",
                          "description": "A decimal number as a string; never a float."
                        },
                        "description": "With cheaper hours: per_1m averaged over the request's hours, or over a flat week without them."
                      },
                      "time_windows": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "days": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            "start": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "end": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "per_1m": {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "type": "string",
                                "description": "A decimal number as a string; never a float."
                              }
                            }
                          },
                          "required": [
                            "per_1m"
                          ],
                          "description": "Hours a price is below per_1m, in UTC. days are lower-case English names, and none means every day. start and end are hhmm, an end of 0 means midnight, and neither means the whole day."
                        }
                      },
                      "converted": {
                        "type": "object",
                        "properties": {
                          "currency": {
                            "type": "string"
                          },
                          "typical_call": {
                            "type": "string",
                            "description": "A decimal number as a string; never a float."
                          },
                          "typical_call_average": {
                            "type": "string",
                            "description": "A decimal number as a string; never a float."
                          }
                        },
                        "required": [
                          "currency",
                          "typical_call"
                        ]
                      },
                      "unverified": {
                        "type": "boolean"
                      }
                    },
                    "required": [
                      "currency",
                      "per_1m",
                      "typical_call"
                    ]
                  },
                  "quality": {
                    "type": "object",
                    "properties": {
                      "score": {
                        "type": "number"
                      },
                      "basis": {
                        "type": "string",
                        "description": "<source>:<signal>, or curated."
                      },
                      "measured_on": {
                        "type": "string"
                      },
                      "attribution": {
                        "type": "string",
                        "description": "Show this wherever the score is shown."
                      },
                      "kind": {
                        "type": "string",
                        "enum": [
                          "measured",
                          "estimated"
                        ]
                      },
                      "quantization_penalty": {
                        "type": "number",
                        "description": "Local runtimes: taken off the model's score for the quantization (q8_0 0, q6_K 0.005, q5_K_M 0.01, q4_K_M 0.03); above 0 the score is an estimate."
                      }
                    },
                    "required": [
                      "score",
                      "basis",
                      "measured_on",
                      "attribution",
                      "kind"
                    ]
                  },
                  "routing": {
                    "description": "Provider-specific request fields the answer depends on; send them with the call. On OpenRouter with needs=zdr: { \"openrouter\": { \"provider\": { \"zdr\": true } } }, so OpenRouter routes only to zero-data-retention upstreams.",
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {}
                    }
                  },
                  "quantization": {
                    "type": "string",
                    "description": "Local runtimes: the weights' quantization, e.g. \"Q4_K_M\"."
                  },
                  "parameters_b": {
                    "type": "number",
                    "description": "Local runtimes: parameters, in billions."
                  },
                  "requirements": {
                    "type": "object",
                    "properties": {
                      "memory_gb": {
                        "type": "number",
                        "description": "Memory to run it: weights, KV cache at context_for_memory tokens and about 10% runtime overhead. GB are 10^9 bytes."
                      },
                      "vram_gb": {
                        "type": "number",
                        "description": "GPU memory for a full offload, at the same context."
                      },
                      "disk_gb": {
                        "type": "number",
                        "description": "The weights' download size."
                      },
                      "context_for_memory": {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991,
                        "description": "The context, in tokens, memory_gb is stated at: the request's min_context when larger than the stored 8,192 (WebLLM: its fixed context)."
                      },
                      "kv_bytes_per_token": {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991,
                        "description": "KV cache bytes per further token of context."
                      },
                      "low_resource": {
                        "type": "boolean",
                        "description": "WebLLM: runs on low-resource devices."
                      }
                    },
                    "required": [
                      "memory_gb",
                      "context_for_memory"
                    ],
                    "description": "Local runtimes: what the device needs."
                  },
                  "license": {
                    "type": "string",
                    "description": "Local runtimes: the weights' license, e.g. \"apache-2.0\"."
                  }
                },
                "required": [
                  "id",
                  "vendor",
                  "provider",
                  "provider_model_id",
                  "status",
                  "capabilities",
                  "limits"
                ]
              }
            },
            "reason": {
              "type": "string"
            },
            "warnings": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  }
                },
                "required": [
                  "code"
                ],
                "additionalProperties": {}
              }
            }
          },
          "required": [
            "shape",
            "catalog_version",
            "model",
            "also_on",
            "alternatives",
            "reason",
            "warnings"
          ]
        },
        {
          "type": "object",
          "properties": {
            "none": {
              "type": "object",
              "properties": {
                "reason": {
                  "type": "string",
                  "enum": [
                    "not_asked",
                    "no_candidate"
                  ],
                  "description": "not_asked: the request gave no `model`. no_candidate: nothing on the providers fits; `detail` says what removed the candidates."
                },
                "message": {
                  "type": "string"
                },
                "detail": {
                  "type": "object",
                  "properties": {
                    "eliminated": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "constraint": {
                            "type": "string"
                          },
                          "before": {
                            "type": "number"
                          },
                          "after": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "constraint",
                          "before",
                          "after"
                        ]
                      }
                    },
                    "nearest_miss": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "provider": {
                          "type": "string"
                        },
                        "provider_model_id": {
                          "type": "string"
                        },
                        "failed": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "id",
                        "provider",
                        "provider_model_id",
                        "failed"
                      ]
                    },
                    "role": {
                      "type": "string",
                      "description": "For a team: the role no candidate was left for."
                    }
                  },
                  "required": [
                    "eliminated"
                  ]
                }
              },
              "required": [
                "reason",
                "message"
              ]
            }
          },
          "required": [
            "none"
          ]
        }
      ],
      "description": "The model for the agent, as /v1/resolve answers it, or `none` with the reason. The rest of the stack is returned either way."
    },
    "systems": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "page": {
            "type": "string",
            "description": "The system's page in the directory, with every server and skill for it."
          },
          "choice": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "server"
                  },
                  "name": {
                    "type": "string",
                    "description": "The MCP Registry's name for the server."
                  },
                  "via": {
                    "anyOf": [
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "remote"
                          },
                          "transport": {
                            "type": "string",
                            "const": "streamable-http"
                          },
                          "url": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "kind",
                          "transport",
                          "url"
                        ]
                      },
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "package"
                          },
                          "registry": {
                            "type": "string",
                            "enum": [
                              "npm",
                              "pypi",
                              "oci"
                            ]
                          },
                          "identifier": {
                            "type": "string",
                            "description": "The package's name, never a version."
                          },
                          "version": {
                            "type": "string",
                            "description": "The version or digest the config pins it to."
                          }
                        },
                        "required": [
                          "kind",
                          "registry",
                          "identifier",
                          "version"
                        ]
                      }
                    ],
                    "description": "How it is reached: a remote address, or a pinned package."
                  },
                  "auth": {
                    "type": "object",
                    "properties": {
                      "headers": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "description": "Names of the headers its record says a user supplies."
                      },
                      "env": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "description": "Names of the variables its record says a user supplies."
                      },
                      "observed": {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string"
                          },
                          "read_on": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "kind",
                          "read_on"
                        ],
                        "description": "What its remote answered a client with no credential, and the day it was asked."
                      }
                    },
                    "required": [
                      "headers",
                      "env"
                    ]
                  },
                  "tools": {
                    "type": "object",
                    "properties": {
                      "count": {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      },
                      "schema_tokens": {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991,
                        "description": "What its tool definitions weigh in a context."
                      },
                      "tokenizer": {
                        "type": "string"
                      },
                      "read_on": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "count",
                      "schema_tokens",
                      "tokenizer",
                      "read_on"
                    ],
                    "description": "Its tool list as last read with no credential; absent when it was never read."
                  },
                  "trust": {
                    "type": "string",
                    "const": "first_party",
                    "description": "Its publisher is the system's owner, by the curated list. Not a review."
                  },
                  "config_key": {
                    "type": "string",
                    "description": "The label its entry has in `config.mcp_json`."
                  }
                },
                "required": [
                  "kind",
                  "name",
                  "via",
                  "auth",
                  "trust",
                  "config_key"
                ]
              },
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "cli"
                  },
                  "command": {
                    "type": "string"
                  },
                  "url": {
                    "type": "string",
                    "description": "The vendor's page for the tool."
                  }
                },
                "required": [
                  "kind",
                  "command",
                  "url"
                ]
              },
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "none"
                  },
                  "why": {
                    "type": "string",
                    "enum": [
                      "no_official_server",
                      "none_active",
                      "no_remote",
                      "no_usable_server",
                      "harness_cannot_run"
                    ]
                  },
                  "other_servers": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991,
                    "description": "Servers for the system by other publishers the directory lists. None is recommended here."
                  }
                },
                "required": [
                  "kind",
                  "why",
                  "other_servers"
                ]
              }
            ],
            "description": "server: its owner's own MCP server. cli: its own command-line tool. none: no first-party option, with why."
          },
          "rule": {
            "type": "string",
            "enum": [
              "cloud_remote",
              "local_cli",
              "local_cli_fallback",
              "local_remote",
              "local_package"
            ],
            "description": "The rule that made the choice; absent when there is none."
          },
          "reason": {
            "type": "string",
            "description": "That rule, or why there is no choice, in words."
          },
          "alternative": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "server"
                  },
                  "name": {
                    "type": "string"
                  },
                  "note": {
                    "type": "string"
                  }
                },
                "required": [
                  "kind",
                  "name",
                  "note"
                ]
              },
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "cli"
                  },
                  "command": {
                    "type": "string"
                  },
                  "url": {
                    "type": "string"
                  },
                  "note": {
                    "type": "string"
                  }
                },
                "required": [
                  "kind",
                  "command",
                  "url",
                  "note"
                ]
              }
            ],
            "description": "The first-party option not chosen, where there is one."
          }
        },
        "required": [
          "id",
          "name",
          "page",
          "choice",
          "reason"
        ]
      },
      "description": "One per recognised system, in the order asked, each once."
    },
    "skills": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "owner": {
            "type": "string"
          },
          "system": {
            "type": "string"
          },
          "source": {
            "type": "string",
            "description": "Where its SKILL.md folder is."
          },
          "page": {
            "type": "string",
            "description": "The directory page that lists it."
          },
          "tokens": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "tokenizer": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "owner",
          "system",
          "source",
          "page"
        ]
      },
      "description": "The owners' own skills for the systems given a choice: at most three a system and six in all, most recently changed first. Not read or reviewed."
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "enum": [
              "untrusted_input_with_write",
              "no_first_party",
              "known_vulnerability",
              "pattern_flag",
              "not_answering",
              "tools_not_read",
              "context_share",
              "local_code",
              "shared_credential",
              "harness_unchecked",
              "infra_unconfirmed",
              "infra_not_priced",
              "sandbox_missing"
            ]
          },
          "message": {
            "type": "string"
          },
          "about": {
            "type": "object",
            "properties": {
              "system": {
                "type": "string"
              },
              "server": {
                "type": "string"
              },
              "product": {
                "type": "string"
              }
            }
          },
          "facts": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "number"
                },
                {
                  "type": "boolean"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ]
            },
            "description": "What the rule fired on."
          }
        },
        "required": [
          "id",
          "message",
          "facts"
        ]
      },
      "description": "Fixed rules that fired, each with the facts it fired on. No warning does not mean safe: it means none of these rules fired."
    },
    "config": {
      "type": "object",
      "properties": {
        "mcp_json": {
          "type": "object",
          "properties": {
            "mcpServers": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "type": {
                        "type": "string",
                        "const": "http"
                      },
                      "url": {
                        "type": "string"
                      },
                      "headers": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "type": "string"
                        }
                      }
                    },
                    "required": [
                      "type",
                      "url"
                    ]
                  },
                  {
                    "type": "object",
                    "properties": {
                      "command": {
                        "type": "string"
                      },
                      "args": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "env": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "type": "string"
                        }
                      }
                    },
                    "required": [
                      "command",
                      "args"
                    ]
                  }
                ]
              }
            }
          },
          "required": [
            "mcpServers"
          ],
          "description": "Ready to write to `.mcp.json`, the file Claude Code reads, whatever `harness` was named: another client keeps the same entries in its own file, and `notes` says so. Every value a person supplies is the placeholder `<your value>`."
        },
        "install": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "cli"
                  },
                  "system": {
                    "type": "string"
                  },
                  "command": {
                    "type": "string"
                  },
                  "url": {
                    "type": "string"
                  }
                },
                "required": [
                  "kind",
                  "system",
                  "command",
                  "url"
                ]
              },
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "skill"
                  },
                  "id": {
                    "type": "string"
                  },
                  "source": {
                    "type": "string"
                  }
                },
                "required": [
                  "kind",
                  "id",
                  "source"
                ]
              }
            ]
          },
          "description": "The command-line tools and skills to install by hand."
        },
        "notes": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "What a person fills in or does before the config works."
        }
      },
      "required": [
        "mcp_json",
        "install",
        "notes"
      ]
    },
    "unknown_systems": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Names in the request that match no curated system."
    },
    "assumptions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "What was assumed because the request did not say."
    },
    "infrastructure": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "category": {
            "type": "string",
            "enum": [
              "runtime",
              "sandbox",
              "search",
              "browser",
              "broker"
            ]
          },
          "because": {
            "type": "string",
            "enum": [
              "runs_code",
              "web_search",
              "web_reading",
              "browser"
            ],
            "description": "The part of the request that implies it."
          },
          "basis": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "stated_usage"
                  },
                  "period": {
                    "type": "string",
                    "const": "month"
                  }
                },
                "required": [
                  "kind",
                  "period"
                ]
              },
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "reference_job"
                  },
                  "period": {
                    "type": "string",
                    "const": "job"
                  },
                  "job": {
                    "type": "string"
                  },
                  "says": {
                    "type": "string",
                    "description": "The job, as a sentence."
                  }
                },
                "required": [
                  "kind",
                  "period",
                  "job",
                  "says"
                ]
              }
            ],
            "description": "What was priced: the usage the request stated, as a month's bill, or a stated reference job at listed rates. A reference job is not your usage."
          },
          "choice": {
            "type": "object",
            "properties": {
              "product": {
                "type": "string",
                "description": "The product's id in the directory."
              },
              "name": {
                "type": "string"
              },
              "vendor": {
                "type": "string"
              },
              "usd": {
                "type": "string",
                "description": "What the part's `basis` comes to on it: a month's bill, or a reference job at listed rates."
              },
              "plan": {
                "type": "string",
                "description": "The plan the figure is for, when the rates or the bill are a plan's own."
              },
              "sum": {
                "type": "string",
                "description": "The line of arithmetic behind `usd`, every factor named. Show it with the figure."
              },
              "confirmed_on": {
                "type": "string",
                "description": "The day its vendor's pricing page last printed every price used. Absent until it has been checked."
              },
              "page": {
                "type": "string",
                "description": "Its page in the directory."
              },
              "named": {
                "type": "boolean",
                "description": "Whether the request named it."
              },
              "rule": {
                "type": "string",
                "enum": [
                  "cheapest_of_named",
                  "only_named"
                ]
              }
            },
            "required": [
              "product",
              "name",
              "vendor",
              "usd",
              "sum",
              "page",
              "named",
              "rule"
            ],
            "description": "Present only when the request named a vendor priced for this: the least of those named, by price alone. Never a view of which product is better."
          },
          "options": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "product": {
                  "type": "string",
                  "description": "The product's id in the directory."
                },
                "name": {
                  "type": "string"
                },
                "vendor": {
                  "type": "string"
                },
                "usd": {
                  "type": "string",
                  "description": "What the part's `basis` comes to on it: a month's bill, or a reference job at listed rates."
                },
                "plan": {
                  "type": "string",
                  "description": "The plan the figure is for, when the rates or the bill are a plan's own."
                },
                "sum": {
                  "type": "string",
                  "description": "The line of arithmetic behind `usd`, every factor named. Show it with the figure."
                },
                "confirmed_on": {
                  "type": "string",
                  "description": "The day its vendor's pricing page last printed every price used. Absent until it has been checked."
                },
                "page": {
                  "type": "string",
                  "description": "Its page in the directory."
                },
                "named": {
                  "type": "boolean",
                  "description": "Whether the request named it."
                }
              },
              "required": [
                "product",
                "name",
                "vendor",
                "usd",
                "sum",
                "page",
                "named"
              ]
            },
            "description": "Every product priced for the basis, least first. An order by price, not a ranking; a listing is not an endorsement."
          },
          "not_priced": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Products of the kind with no figure for the basis: prices not read, set aside, or not selling it."
          },
          "page": {
            "type": "string",
            "description": "The category's page in the directory."
          }
        },
        "required": [
          "category",
          "because",
          "basis",
          "options",
          "not_priced",
          "page"
        ]
      },
      "description": "What the agent runs on: a part for each kind of infrastructure the request implies (a sandbox when it runs code; search, reading or a browser from `needs`). Absent when it implies none. Prices are each vendor's own, checked against its pricing page; a model's cost is never added to these."
    },
    "unknown_infra_vendors": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Names in `infra.vendors` that match no listed product."
    },
    "watch_url": {
      "description": "The website's form with this need filled in and its watch panel asked for. Left out when no system was recognised, and when the request sets `prefer` or a `tenancy` of `multi`, which the form does not have. A person who opens it and presses Watch is emailed on a day the stack changes: a different choice, a new version in the config, or a change recorded about a server or skill in it, and, with `infra.vendors` named, a different least of them or a moved price (as a reference job comes to: `infra.usage` is not kept). Opening the address saves nothing, and there is no call that sets a watch: pass the address on, never claim one was set.",
      "type": "string"
    }
  },
  "required": [
    "catalog_version",
    "agent_catalog_version",
    "model",
    "systems",
    "skills",
    "warnings",
    "config",
    "unknown_systems",
    "assumptions"
  ]
}
ModelsList
ModelsList (JSON Schema)
{
  "type": "object",
  "properties": {
    "catalog_version": {
      "type": "string"
    },
    "total": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "models": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "vendor": {
            "type": "string"
          },
          "origin": {
            "type": "string"
          },
          "display_name": {
            "type": "string"
          },
          "tasks": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "released": {
            "type": "string"
          },
          "offerings": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "provider": {
                  "type": "string"
                },
                "provider_model_id": {
                  "type": "string"
                },
                "status": {
                  "type": "string",
                  "enum": [
                    "preview",
                    "ga",
                    "deprecated",
                    "retired"
                  ]
                },
                "hidden": {
                  "description": "Why an offering is never recommended: unreviewed_vendor, router, stealth or leaving.",
                  "type": "string"
                },
                "billing_status": {
                  "description": "How the offering is charged: metered, free, trial, included, variable or unknown.",
                  "type": "string"
                },
                "billing_units": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "free_since": {
                  "type": "string"
                },
                "deprecated_on": {
                  "type": "string"
                },
                "retires_on": {
                  "type": "string"
                },
                "end_claimed_on": {
                  "description": "The end a catalog claims, which the provider hasn't confirmed.",
                  "type": "string"
                },
                "retires_not_before": {
                  "description": "The provider's floor: no end is set before this day.",
                  "type": "string"
                },
                "next_price": {
                  "description": "The next price change the provider has announced.",
                  "type": "object",
                  "properties": {
                    "effective_from": {
                      "type": "string"
                    },
                    "per_1m": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "type": "string"
                      }
                    },
                    "service_tiers": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "required": [
                    "effective_from",
                    "per_1m"
                  ]
                },
                "redirect": {
                  "description": "The provider answers this id with another model and bills it as that model. Without `on`, it already does. `via` marks a route whose upstream redirects, which the router itself hasn't announced.",
                  "type": "object",
                  "properties": {
                    "on": {
                      "type": "string"
                    },
                    "to": {
                      "type": "string"
                    },
                    "via": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "to"
                  ]
                },
                "closed_to_new_on": {
                  "description": "From this day the provider serves the model only to accounts that used it before. A resolve leaves it out unless the request sends allow_closed=true.",
                  "type": "string"
                },
                "capabilities": {
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {
                    "type": "object",
                    "properties": {
                      "level": {
                        "type": "string",
                        "enum": [
                          "claimed",
                          "parsed",
                          "native",
                          "probed"
                        ]
                      },
                      "probed_on": {
                        "type": "string"
                      },
                      "efforts": {
                        "description": "Reasoning effort levels the offering accepts, for reasoning.",
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      }
                    },
                    "required": [
                      "level"
                    ]
                  }
                },
                "limits": {
                  "type": "object",
                  "properties": {
                    "context": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "max_input": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "max_output": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "dimensions": {
                      "description": "Embedding vector length, as a probe measured it.",
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    }
                  }
                },
                "price": {
                  "type": "object",
                  "properties": {
                    "currency": {
                      "type": "string"
                    },
                    "per_1m": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "type": "string",
                        "description": "A decimal number as a string; never a float."
                      }
                    },
                    "per_1m_average": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "type": "string",
                        "description": "A decimal number as a string; never a float."
                      }
                    },
                    "time_windows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "days": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "start": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "end": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "per_1m": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {
                              "type": "string",
                              "description": "A decimal number as a string; never a float."
                            }
                          }
                        },
                        "required": [
                          "per_1m"
                        ],
                        "description": "Hours a price is below per_1m, in UTC. days are lower-case English names, and none means every day. start and end are hhmm, an end of 0 means midnight, and neither means the whole day."
                      }
                    },
                    "service_tiers": {
                      "description": "Rates by service tier. An id served only at one tier has an empty per_1m.",
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "type": "string",
                          "description": "A decimal number as a string; never a float."
                        }
                      }
                    },
                    "effective_from": {
                      "type": "string"
                    },
                    "unverified": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "currency",
                    "per_1m",
                    "effective_from"
                  ]
                },
                "quantization": {
                  "type": "string",
                  "description": "Local runtimes: the weights' quantization, e.g. \"Q4_K_M\"."
                },
                "parameters_b": {
                  "type": "number",
                  "description": "Local runtimes: parameters, in billions."
                },
                "requirements": {
                  "type": "object",
                  "properties": {
                    "memory_gb": {
                      "type": "number",
                      "description": "Memory to run it: weights, KV cache at context_for_memory tokens and about 10% runtime overhead. GB are 10^9 bytes."
                    },
                    "vram_gb": {
                      "type": "number",
                      "description": "GPU memory for a full offload, at the same context."
                    },
                    "disk_gb": {
                      "type": "number",
                      "description": "The weights' download size."
                    },
                    "context_for_memory": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991,
                      "description": "The context, in tokens, memory_gb is stated at: the request's min_context when larger than the stored 8,192 (WebLLM: its fixed context)."
                    },
                    "kv_bytes_per_token": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991,
                      "description": "KV cache bytes per further token of context."
                    },
                    "low_resource": {
                      "type": "boolean",
                      "description": "WebLLM: runs on low-resource devices."
                    }
                  },
                  "required": [
                    "memory_gb",
                    "context_for_memory"
                  ],
                  "description": "Local runtimes: what the device needs, at context_for_memory tokens."
                },
                "license": {
                  "type": "string",
                  "description": "Local runtimes: the weights' license, e.g. \"apache-2.0\"."
                }
              },
              "required": [
                "provider",
                "provider_model_id",
                "status",
                "capabilities",
                "limits"
              ]
            }
          },
          "quality": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "score": {
                  "type": "number"
                },
                "basis": {
                  "type": "string",
                  "description": "<source>:<signal>, or curated."
                },
                "measured_on": {
                  "type": "string"
                },
                "attribution": {
                  "type": "string",
                  "description": "Show this wherever the score is shown."
                },
                "kind": {
                  "type": "string",
                  "enum": [
                    "measured",
                    "estimated"
                  ]
                }
              },
              "required": [
                "score",
                "basis",
                "measured_on",
                "attribution",
                "kind"
              ]
            }
          }
        },
        "required": [
          "id",
          "vendor",
          "display_name",
          "tasks",
          "offerings",
          "quality"
        ]
      }
    }
  },
  "required": [
    "catalog_version",
    "total",
    "models"
  ]
}
ModelDetail
ModelDetail (JSON Schema)
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "vendor": {
      "type": "string"
    },
    "origin": {
      "type": "string"
    },
    "display_name": {
      "type": "string"
    },
    "tasks": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "released": {
      "type": "string"
    },
    "offerings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "provider": {
            "type": "string"
          },
          "provider_model_id": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "preview",
              "ga",
              "deprecated",
              "retired"
            ]
          },
          "hidden": {
            "description": "Why an offering is never recommended: unreviewed_vendor, router, stealth or leaving.",
            "type": "string"
          },
          "billing_status": {
            "description": "How the offering is charged: metered, free, trial, included, variable or unknown.",
            "type": "string"
          },
          "billing_units": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "free_since": {
            "type": "string"
          },
          "deprecated_on": {
            "type": "string"
          },
          "retires_on": {
            "type": "string"
          },
          "end_claimed_on": {
            "description": "The end a catalog claims, which the provider hasn't confirmed.",
            "type": "string"
          },
          "retires_not_before": {
            "description": "The provider's floor: no end is set before this day.",
            "type": "string"
          },
          "next_price": {
            "description": "The next price change the provider has announced.",
            "type": "object",
            "properties": {
              "effective_from": {
                "type": "string"
              },
              "per_1m": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {
                  "type": "string"
                }
              },
              "service_tiers": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {
                    "type": "string"
                  }
                }
              }
            },
            "required": [
              "effective_from",
              "per_1m"
            ]
          },
          "redirect": {
            "description": "The provider answers this id with another model and bills it as that model. Without `on`, it already does. `via` marks a route whose upstream redirects, which the router itself hasn't announced.",
            "type": "object",
            "properties": {
              "on": {
                "type": "string"
              },
              "to": {
                "type": "string"
              },
              "via": {
                "type": "string"
              }
            },
            "required": [
              "to"
            ]
          },
          "closed_to_new_on": {
            "description": "From this day the provider serves the model only to accounts that used it before. A resolve leaves it out unless the request sends allow_closed=true.",
            "type": "string"
          },
          "capabilities": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {
              "type": "object",
              "properties": {
                "level": {
                  "type": "string",
                  "enum": [
                    "claimed",
                    "parsed",
                    "native",
                    "probed"
                  ]
                },
                "probed_on": {
                  "type": "string"
                },
                "efforts": {
                  "description": "Reasoning effort levels the offering accepts, for reasoning.",
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              },
              "required": [
                "level"
              ]
            }
          },
          "limits": {
            "type": "object",
            "properties": {
              "context": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              "max_input": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              "max_output": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              "dimensions": {
                "description": "Embedding vector length, as a probe measured it.",
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              }
            }
          },
          "price": {
            "type": "object",
            "properties": {
              "currency": {
                "type": "string"
              },
              "per_1m": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {
                  "type": "string",
                  "description": "A decimal number as a string; never a float."
                }
              },
              "per_1m_average": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {
                  "type": "string",
                  "description": "A decimal number as a string; never a float."
                }
              },
              "time_windows": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "days": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "start": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "end": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "per_1m": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "type": "string",
                        "description": "A decimal number as a string; never a float."
                      }
                    }
                  },
                  "required": [
                    "per_1m"
                  ],
                  "description": "Hours a price is below per_1m, in UTC. days are lower-case English names, and none means every day. start and end are hhmm, an end of 0 means midnight, and neither means the whole day."
                }
              },
              "service_tiers": {
                "description": "Rates by service tier. An id served only at one tier has an empty per_1m.",
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {
                    "type": "string",
                    "description": "A decimal number as a string; never a float."
                  }
                }
              },
              "effective_from": {
                "type": "string"
              },
              "unverified": {
                "type": "boolean"
              }
            },
            "required": [
              "currency",
              "per_1m",
              "effective_from"
            ]
          },
          "quantization": {
            "type": "string",
            "description": "Local runtimes: the weights' quantization, e.g. \"Q4_K_M\"."
          },
          "parameters_b": {
            "type": "number",
            "description": "Local runtimes: parameters, in billions."
          },
          "requirements": {
            "type": "object",
            "properties": {
              "memory_gb": {
                "type": "number",
                "description": "Memory to run it: weights, KV cache at context_for_memory tokens and about 10% runtime overhead. GB are 10^9 bytes."
              },
              "vram_gb": {
                "type": "number",
                "description": "GPU memory for a full offload, at the same context."
              },
              "disk_gb": {
                "type": "number",
                "description": "The weights' download size."
              },
              "context_for_memory": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991,
                "description": "The context, in tokens, memory_gb is stated at: the request's min_context when larger than the stored 8,192 (WebLLM: its fixed context)."
              },
              "kv_bytes_per_token": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991,
                "description": "KV cache bytes per further token of context."
              },
              "low_resource": {
                "type": "boolean",
                "description": "WebLLM: runs on low-resource devices."
              }
            },
            "required": [
              "memory_gb",
              "context_for_memory"
            ],
            "description": "Local runtimes: what the device needs, at context_for_memory tokens."
          },
          "license": {
            "type": "string",
            "description": "Local runtimes: the weights' license, e.g. \"apache-2.0\"."
          },
          "prices": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "currency": {
                  "type": "string"
                },
                "per_1m": {
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {
                    "type": "string",
                    "description": "A decimal number as a string; never a float."
                  }
                },
                "time_windows": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "days": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "start": {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      },
                      "end": {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      },
                      "per_1m": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "type": "string",
                          "description": "A decimal number as a string; never a float."
                        }
                      }
                    },
                    "required": [
                      "per_1m"
                    ],
                    "description": "Hours a price is below per_1m, in UTC. days are lower-case English names, and none means every day. start and end are hhmm, an end of 0 means midnight, and neither means the whole day."
                  }
                },
                "effective_from": {
                  "type": "string"
                },
                "source": {
                  "type": "string"
                },
                "unverified": {
                  "type": "boolean"
                }
              },
              "required": [
                "currency",
                "per_1m",
                "effective_from",
                "source"
              ]
            }
          }
        },
        "required": [
          "provider",
          "provider_model_id",
          "status",
          "capabilities",
          "limits",
          "prices"
        ]
      }
    },
    "quality": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "score": {
            "type": "number"
          },
          "basis": {
            "type": "string",
            "description": "<source>:<signal>, or curated."
          },
          "measured_on": {
            "type": "string"
          },
          "attribution": {
            "type": "string",
            "description": "Show this wherever the score is shown."
          },
          "kind": {
            "type": "string",
            "enum": [
              "measured",
              "estimated"
            ]
          }
        },
        "required": [
          "score",
          "basis",
          "measured_on",
          "attribution",
          "kind"
        ]
      }
    },
    "catalog_version": {
      "type": "string"
    },
    "aliases": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "id",
    "vendor",
    "display_name",
    "tasks",
    "offerings",
    "quality",
    "catalog_version",
    "aliases"
  ]
}
PurposesList
PurposesList (JSON Schema)
{
  "type": "object",
  "properties": {
    "catalog_version": {
      "type": "string"
    },
    "purposes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "task": {
            "type": "string"
          },
          "needs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "quality": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "usage": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {
              "type": [
                "number",
                "string"
              ]
            }
          },
          "aliases": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "shape": {
            "type": "string",
            "enum": [
              "single",
              "team",
              "escalation"
            ],
            "description": "The shape the purpose resolves to when the request does not say."
          }
        },
        "required": [
          "id",
          "description",
          "task",
          "needs",
          "quality",
          "usage",
          "aliases"
        ]
      }
    }
  },
  "required": [
    "catalog_version",
    "purposes"
  ]
}
Vocabulary
Vocabulary (JSON Schema)
{
  "type": "object",
  "properties": {
    "tasks": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "capabilities": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "levels": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "providers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "display_name": {
            "type": "string"
          },
          "local": {
            "type": "boolean",
            "description": "A runtime on the user's device (ollama, lmstudio, llama.cpp, mlx, webllm) rather than a cloud provider; send the device's limits with it."
          }
        },
        "required": [
          "name",
          "display_name"
        ]
      }
    },
    "origin_groups": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "array",
        "items": {
          "type": "string"
        }
      }
    },
    "budgets": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "optimize": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "service_tiers": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "strategies": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Team strategy presets for strategy=."
    }
  },
  "required": [
    "tasks",
    "capabilities",
    "levels",
    "providers",
    "origin_groups",
    "budgets",
    "optimize",
    "service_tiers",
    "strategies"
  ]
}
Licenses
Licenses (JSON Schema)
{
  "type": "object",
  "properties": {
    "catalog_version": {
      "type": "string"
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "source": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "license": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "notice": {
            "type": "string"
          }
        },
        "required": [
          "source",
          "name",
          "license",
          "url",
          "notice"
        ]
      }
    }
  },
  "required": [
    "catalog_version",
    "sources"
  ]
}
Health
Health (JSON Schema)
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "ok",
        "degraded"
      ],
      "description": "ok, or degraded when the catalog is older than 48 hours (the API still answers from it)"
    },
    "catalog_version": {
      "description": "The catalog live keys are answered from",
      "type": "string"
    },
    "agent_catalog_version": {
      "description": "The agent catalog (systems, MCP servers, skills) the API has loaded; absent when there is none, which does not degrade the status",
      "type": "string"
    },
    "catalog_age_hours": {
      "description": "Hours since that catalog was generated, to one decimal",
      "type": "number"
    },
    "agent_catalog_age_hours": {
      "description": "Hours since the agent catalog was generated, to one decimal. It is published only when its entries change, so days are ordinary; it does not degrade the status",
      "type": "number"
    }
  },
  "required": [
    "status"
  ]
}
KeyInfo
KeyInfo (JSON Schema)
{
  "type": "object",
  "properties": {
    "key": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The key's id"
        },
        "kind": {
          "type": "string",
          "enum": [
            "live",
            "test"
          ],
          "description": "live or test"
        },
        "project_id": {
          "description": "The project the key belongs to; null for none",
          "type": [
            "string",
            "null"
          ]
        },
        "scopes": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "What the key may call: resolve, plan, models, usage:read"
        },
        "monthly_cap": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ],
          "description": "The key's own monthly call cap; null for none"
        }
      },
      "required": [
        "id",
        "kind",
        "project_id",
        "scopes",
        "monthly_cap"
      ]
    },
    "rate_per_minute": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Requests allowed a minute"
    },
    "quota": {
      "type": "object",
      "properties": {
        "limit": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ],
          "description": "Counted calls allowed this period; null for unlimited"
        },
        "used": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991,
          "description": "Counted calls made this period"
        },
        "period_start": {
          "type": "string",
          "description": "The period's first day, e.g. 2026-11-01 (a day for test keys)"
        },
        "resets_at": {
          "type": "string",
          "description": "When the period resets, ISO 8601"
        }
      },
      "required": [
        "limit",
        "used",
        "period_start",
        "resets_at"
      ],
      "description": "The account's quota this period (test keys: the day's test calls)"
    },
    "key_usage": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "used": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "limit": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "used",
            "limit"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "Calls against the key's monthly cap; null when it has none"
    }
  },
  "required": [
    "key",
    "rate_per_minute",
    "quota",
    "key_usage"
  ]
}
Error
Error (JSON Schema)
{
  "type": "object",
  "properties": {
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "field": {
          "type": "string"
        },
        "allowed": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": {}
    }
  },
  "required": [
    "error"
  ]
}
NoCandidate
NoCandidate (JSON Schema)
{
  "type": "object",
  "properties": {
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "const": "no_candidate"
        },
        "message": {
          "type": "string"
        },
        "catalog_version": {
          "type": "string"
        },
        "eliminated": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "constraint": {
                "type": "string"
              },
              "before": {
                "type": "number"
              },
              "after": {
                "type": "number"
              }
            },
            "required": [
              "constraint",
              "before",
              "after"
            ]
          }
        },
        "nearest_miss": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "provider": {
              "type": "string"
            },
            "provider_model_id": {
              "type": "string"
            },
            "failed": {
              "type": "string"
            }
          },
          "required": [
            "id",
            "provider",
            "provider_model_id",
            "failed"
          ]
        },
        "role": {
          "type": "string",
          "description": "For a team: the role no candidate was left for."
        }
      },
      "required": [
        "code",
        "message",
        "catalog_version",
        "eliminated"
      ]
    }
  },
  "required": [
    "error"
  ]
}