Skip to main content
Glama

Energy supply shock scenario

compute_energy_shock
Read-onlyIdempotent

Compute the oil/gas supply-sensitivity scenario for a country and supported chokepoint. Set disruption_pct (10..100, default 100) and fuel_mode (oil/gas/both, default oil). Results carry dataAvailable, coverage flags, coverageLevel, limitations, degraded, chokepointConfidence and gasSensitivity.modelBasis. Oil headline figures use preCrisisBaseline, the Gulf share over the 12 months before the 2026 Hormuz crisis (basis comtrade_annual is the annual fallback); currentFlows covers the latest 3 monthly filings and is absent when unavailable. Shares include the chokepoint route factor. For Hormuz, crudeLossKbd is after bypass rerouting (Saudi East-West, UAE ADCOP, Iraqi Kirkuk-Ceyhan); preCrisisBaseline.crudeLossKbd is before it. An unavailable source is not a zero deficit; assumed LNG routing is not a measured live-flow shock. Units: products kb/d, gas TJ, storage TWh, cover days. Non-IEA cover uses reportedStocks (JODI month-end stocks, not IEA data). Results may be cached; no user scenario is saved.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "country": "<country>",
      "chokepoint_id": "<chokepoint_id>"
    },
    "name": "compute_energy_shock"
  }
}

Input Schema

NameRequiredDescriptionDefault
countryYesPass an ISO 3166-1 alpha-2 code (e.g. "IQ"), an alpha-3 code ("IRQ"), or a country name in any supported dashboard locale (e.g. English "Iraq", Arabic "العراق", German "Deutschland", Chinese "中国").
jmespathNoOptional JMESPath projection applied to the response. See initialize.instructions for grammar and examples.
fuel_modeNoWhich fuel sensitivity to compute: oil (default), gas or both.oil
chokepoint_idYesRegistry id of the disrupted chokepoint; only chokepoints with a supported shock model are listed.
disruption_pctNoShare of the chokepoint flow disrupted, 10-100 percent (default 100, a full closure).

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / country / description
      Previous value: -"Pass an ISO 3166-1 alpha-2 code (e.g. \"IQ\"), an alpha-3 code (\"IRQ\"), or an English country name (\"Iraq\")."New value: +"Pass an ISO 3166-1 alpha-2 code (e.g. \"IQ\"), an alpha-3 code (\"IRQ\"), or a country name in any supported dashboard locale (e.g. English \"Iraq\", Arabic \"العراق\", German \"Deutschland\", Chinese \"中国\")."
  2. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "assessment": {
      -        "type": "string"
      -      },
      -      "chokepointConfidence": {
      -        "type": "string"
      -      },
      -      "chokepointId": {
      -        "type": "string"
      -      },
      -      "comtradeCoverage": {
      -        "type": "boolean"
      -      },
      -      "countryCode": {
      -        "type": "string"
      -      },
      -      "coverageLevel": {
      -        "type": "string"
      -      },
      -      "crudeLossKbd": {
      -        "type": "number"
      -      },
      -      "currentFlows": {
      -        "properties": {
      -          "basis": {
      -            "enum": [
      -              "comtrade_monthly",
      -              "comtrade_annual"
      -            ],
      -            "type": "string"
      -          },
      -          "crudeLossAfterBypassKbd": {
      -            "type": "number"
      -          },
      -          "crudeLossKbd": {
      -            "type": "number"
      -          },
      -          "fromMonth": {
      -            "type": "string"
      -          },
      -          "gulfCrudeShare": {
      -            "type": "number"
      -          },
      -          "monthsCovered": {
      -            "type": "number"
      -          },
      -          "toMonth": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "dataAvailable": {
      -        "type": "boolean"
      -      },
      -      "degraded": {
      -        "type": "boolean"
      -      },
      -      "disruptionPct": {
      -        "type": "number"
      -      },
      -      "effectiveCoverDays": {
      -        "type": "number"
      -      },
      -      "gasSensitivity": {
      -        "properties": {
      -          "assessment": {
      -            "type": "string"
      -          },
      -          "dataAvailable": {
      -            "type": "boolean"
      -          },
      -          "dataMonth": {
      -            "type": "string"
      -          },
      -          "dataSource": {
      -            "type": "string"
      -          },
      -          "deficitPct": {
      -            "type": "number"
      -          },
      -          "lngDisruptionTj": {
      -            "type": "number"
      -          },
      -          "lngImportsTj": {
      -            "type": "number"
      -          },
      -          "lngShareOfImports": {
      -            "type": "number"
      -          },
      -          "modelBasis": {
      -            "type": "string"
      -          },
      -          "storage": {
      -            "properties": {
      -              "date": {
      -                "type": "string"
      -              },
      -              "fillPct": {
      -                "type": "number"
      -              },
      -              "gasTwh": {
      -                "type": "number"
      -              },
      -              "scope": {
      -                "type": "string"
      -              },
      -              "trend": {
      -                "type": "string"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "totalDemandTj": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "gulfCrudeShare": {
      -        "type": "number"
      -      },
      -      "ieaStocksCoverage": {
      -        "type": "boolean"
      -      },
      -      "jodiOilCoverage": {
      -        "type": "boolean"
      -      },
      -      "limitations": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "liveFlowRatio": {
      -        "type": "number"
      -      },
      -      "portwatchCoverage": {
      -        "type": "boolean"
      -      },
      -      "preCrisisBaseline": {
      -        "properties": {
      -          "basis": {
      -            "enum": [
      -              "comtrade_monthly",
      -              "comtrade_annual"
      -            ],
      -            "type": "string"
      -          },
      -          "crudeLossAfterBypassKbd": {
      -            "type": "number"
      -          },
      -          "crudeLossKbd": {
      -            "type": "number"
      -          },
      -          "fromMonth": {
      -            "type": "string"
      -          },
      -          "gulfCrudeShare": {
      -            "type": "number"
      -          },
      -          "monthsCovered": {
      -            "type": "number"
      -          },
      -          "toMonth": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "products": {
      -        "items": {
      -          "properties": {
      -            "deficitPct": {
      -              "type": "number"
      -            },
      -            "demandKbd": {
      -              "type": "number"
      -            },
      -            "outputLossKbd": {
      -              "type": "number"
      -            },
      -            "product": {
      -              "type": "string"
      -            }
      -          },
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "reportedStocks": {
      -        "properties": {
      -          "crudeMb": {
      -            "type": "number"
      -          },
      -          "month": {
      -            "type": "string"
      -          },
      -          "productsMb": {
      -            "type": "number"
      -          },
      -          "source": {
      -            "enum": [
      -              "jodi"
      -            ],
      -            "type": "string"
      -          },
      -          "stockDays": {
      -            "type": "number"
      -          },
      -          "totalMb": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "required": [
      -      "projection"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "data",
      -      "_attribution"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "_budget_exceeded"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "_jmespath_error"
      -    ]
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "assessment": {
      +        "type": "string"
      +      },
      +      "chokepointConfidence": {
      +        "type": "string"
      +      },
      +      "chokepointId": {
      +        "type": "string"
      +      },
      +      "comtradeCoverage": {
      +        "type": "boolean"
      +      },
      +      "countryCode": {
      +        "type": "string"
      +      },
      +      "coverageLevel": {
      +        "type": "string"
      +      },
      +      "crudeLossKbd": {
      +        "type": "number"
      +      },
      +      "currentFlows": {
      +        "properties": {
      +          "basis": {
      +            "enum": [
      +              "comtrade_monthly",
      +              "national_monthly",
      +              "comtrade_annual"
      +            ],
      +            "type": "string"
      +          },
      +          "crudeLossAfterBypassKbd": {
      +            "type": "number"
      +          },
      +          "crudeLossKbd": {
      +            "type": "number"
      +          },
      +          "fromMonth": {
      +            "type": "string"
      +          },
      +          "gulfCrudeShare": {
      +            "type": "number"
      +          },
      +          "monthsCovered": {
      +            "type": "number"
      +          },
      +          "toMonth": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "dataAvailable": {
      +        "type": "boolean"
      +      },
      +      "degraded": {
      +        "type": "boolean"
      +      },
      +      "disruptionPct": {
      +        "type": "number"
      +      },
      +      "effectiveCoverDays": {
      +        "type": "number"
      +      },
      +      "gasSensitivity": {
      +        "properties": {
      +          "assessment": {
      +            "type": "string"
      +          },
      +          "dataAvailable": {
      +            "type": "boolean"
      +          },
      +          "dataMonth": {
      +            "type": "string"
      +          },
      +          "dataSource": {
      +            "type": "string"
      +          },
      +          "deficitPct": {
      +            "type": "number"
      +          },
      +          "lngDisruptionTj": {
      +            "type": "number"
      +          },
      +          "lngImportsTj": {
      +            "type": "number"
      +          },
      +          "lngShareOfImports": {
      +            "type": "number"
      +          },
      +          "modelBasis": {
      +            "type": "string"
      +          },
      +          "storage": {
      +            "properties": {
      +              "date": {
      +                "type": "string"
      +              },
      +              "fillPct": {
      +                "type": "number"
      +              },
      +              "gasTwh": {
      +                "type": "number"
      +              },
      +              "scope": {
      +                "type": "string"
      +              },
      +              "trend": {
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "totalDemandTj": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "gulfCrudeShare": {
      +        "type": "number"
      +      },
      +      "ieaStocksCoverage": {
      +        "type": "boolean"
      +      },
      +      "jodiOilCoverage": {
      +        "type": "boolean"
      +      },
      +      "limitations": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "liveFlowRatio": {
      +        "type": "number"
      +      },
      +      "portwatchCoverage": {
      +        "type": "boolean"
      +      },
      +      "preCrisisBaseline": {
      +        "properties": {
      +          "basis": {
      +            "enum": [
      +              "comtrade_monthly",
      +              "national_monthly",
      +              "comtrade_annual"
      +            ],
      +            "type": "string"
      +          },
      +          "crudeLossAfterBypassKbd": {
      +            "type": "number"
      +          },
      +          "crudeLossKbd": {
      +            "type": "number"
      +          },
      +          "fromMonth": {
      +            "type": "string"
      +          },
      +          "gulfCrudeShare": {
      +            "type": "number"
      +          },
      +          "monthsCovered": {
      +            "type": "number"
      +          },
      +          "toMonth": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "products": {
      +        "items": {
      +          "properties": {
      +            "deficitPct": {
      +              "type": "number"
      +            },
      +            "demandKbd": {
      +              "type": "number"
      +            },
      +            "outputLossKbd": {
      +              "type": "number"
      +            },
      +            "product": {
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "reportedStocks": {
      +        "properties": {
      +          "crudeMb": {
      +            "type": "number"
      +          },
      +          "month": {
      +            "type": "string"
      +          },
      +          "productsMb": {
      +            "type": "number"
      +          },
      +          "source": {
      +            "enum": [
      +              "jodi"
      +            ],
      +            "type": "string"
      +          },
      +          "stockDays": {
      +            "type": "number"
      +          },
      +          "totalMb": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "required": [
      +      "projection"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "data",
      +      "_attribution"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "_budget_exceeded"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "_jmespath_error"
      +    ]
      +  }
      +]
  3. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "assessment": {
      -        "type": "string"
      -      },
      -      "chokepointConfidence": {
      -        "type": "string"
      -      },
      -      "chokepointId": {
      -        "type": "string"
      -      },
      -      "comtradeCoverage": {
      -        "type": "boolean"
      -      },
      -      "countryCode": {
      -        "type": "string"
      -      },
      -      "coverageLevel": {
      -        "type": "string"
      -      },
      -      "crudeLossKbd": {
      -        "type": "number"
      -      },
      -      "currentFlows": {
      -        "properties": {
      -          "basis": {
      -            "enum": [
      -              "comtrade_monthly",
      -              "comtrade_annual"
      -            ],
      -            "type": "string"
      -          },
      -          "crudeLossAfterBypassKbd": {
      -            "type": "number"
      -          },
      -          "crudeLossKbd": {
      -            "type": "number"
      -          },
      -          "fromMonth": {
      -            "type": "string"
      -          },
      -          "gulfCrudeShare": {
      -            "type": "number"
      -          },
      -          "monthsCovered": {
      -            "type": "number"
      -          },
      -          "toMonth": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "dataAvailable": {
      -        "type": "boolean"
      -      },
      -      "degraded": {
      -        "type": "boolean"
      -      },
      -      "disruptionPct": {
      -        "type": "number"
      -      },
      -      "effectiveCoverDays": {
      -        "type": "number"
      -      },
      -      "gasSensitivity": {
      -        "properties": {
      -          "assessment": {
      -            "type": "string"
      -          },
      -          "dataAvailable": {
      -            "type": "boolean"
      -          },
      -          "dataMonth": {
      -            "type": "string"
      -          },
      -          "dataSource": {
      -            "type": "string"
      -          },
      -          "deficitPct": {
      -            "type": "number"
      -          },
      -          "lngDisruptionTj": {
      -            "type": "number"
      -          },
      -          "lngImportsTj": {
      -            "type": "number"
      -          },
      -          "lngShareOfImports": {
      -            "type": "number"
      -          },
      -          "modelBasis": {
      -            "type": "string"
      -          },
      -          "storage": {
      -            "properties": {
      -              "date": {
      -                "type": "string"
      -              },
      -              "fillPct": {
      -                "type": "number"
      -              },
      -              "gasTwh": {
      -                "type": "number"
      -              },
      -              "scope": {
      -                "type": "string"
      -              },
      -              "trend": {
      -                "type": "string"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "totalDemandTj": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "gulfCrudeShare": {
      -        "type": "number"
      -      },
      -      "ieaStocksCoverage": {
      -        "type": "boolean"
      -      },
      -      "jodiOilCoverage": {
      -        "type": "boolean"
      -      },
      -      "limitations": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "liveFlowRatio": {
      -        "type": "number"
      -      },
      -      "portwatchCoverage": {
      -        "type": "boolean"
      -      },
      -      "preCrisisBaseline": {
      -        "properties": {
      -          "basis": {
      -            "enum": [
      -              "comtrade_monthly",
      -              "comtrade_annual"
      -            ],
      -            "type": "string"
      -          },
      -          "crudeLossAfterBypassKbd": {
      -            "type": "number"
      -          },
      -          "crudeLossKbd": {
      -            "type": "number"
      -          },
      -          "fromMonth": {
      -            "type": "string"
      -          },
      -          "gulfCrudeShare": {
      -            "type": "number"
      -          },
      -          "monthsCovered": {
      -            "type": "number"
      -          },
      -          "toMonth": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "products": {
      -        "items": {
      -          "properties": {
      -            "deficitPct": {
      -              "type": "number"
      -            },
      -            "demandKbd": {
      -              "type": "number"
      -            },
      -            "outputLossKbd": {
      -              "type": "number"
      -            },
      -            "product": {
      -              "type": "string"
      -            }
      -          },
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "reserveEstimate": {
      -        "properties": {
      -          "asOf": {
      -            "type": "string"
      -          },
      -          "centralMb": {
      -            "type": "number"
      -          },
      -          "coverDaysHigh": {
      -            "type": "number"
      -          },
      -          "coverDaysLow": {
      -            "type": "number"
      -          },
      -          "credibility": {
      -            "enum": [
      -              "high",
      -              "low"
      -            ],
      -            "type": "string"
      -          },
      -          "highMb": {
      -            "type": "number"
      -          },
      -          "lowMb": {
      -            "type": "number"
      -          },
      -          "scope": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "required": [
      -      "projection"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "data",
      -      "_attribution"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "_budget_exceeded"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "_jmespath_error"
      -    ]
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "assessment": {
      +        "type": "string"
      +      },
      +      "chokepointConfidence": {
      +        "type": "string"
      +      },
      +      "chokepointId": {
      +        "type": "string"
      +      },
      +      "comtradeCoverage": {
      +        "type": "boolean"
      +      },
      +      "countryCode": {
      +        "type": "string"
      +      },
      +      "coverageLevel": {
      +        "type": "string"
      +      },
      +      "crudeLossKbd": {
      +        "type": "number"
      +      },
      +      "currentFlows": {
      +        "properties": {
      +          "basis": {
      +            "enum": [
      +              "comtrade_monthly",
      +              "comtrade_annual"
      +            ],
      +            "type": "string"
      +          },
      +          "crudeLossAfterBypassKbd": {
      +            "type": "number"
      +          },
      +          "crudeLossKbd": {
      +            "type": "number"
      +          },
      +          "fromMonth": {
      +            "type": "string"
      +          },
      +          "gulfCrudeShare": {
      +            "type": "number"
      +          },
      +          "monthsCovered": {
      +            "type": "number"
      +          },
      +          "toMonth": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "dataAvailable": {
      +        "type": "boolean"
      +      },
      +      "degraded": {
      +        "type": "boolean"
      +      },
      +      "disruptionPct": {
      +        "type": "number"
      +      },
      +      "effectiveCoverDays": {
      +        "type": "number"
      +      },
      +      "gasSensitivity": {
      +        "properties": {
      +          "assessment": {
      +            "type": "string"
      +          },
      +          "dataAvailable": {
      +            "type": "boolean"
      +          },
      +          "dataMonth": {
      +            "type": "string"
      +          },
      +          "dataSource": {
      +            "type": "string"
      +          },
      +          "deficitPct": {
      +            "type": "number"
      +          },
      +          "lngDisruptionTj": {
      +            "type": "number"
      +          },
      +          "lngImportsTj": {
      +            "type": "number"
      +          },
      +          "lngShareOfImports": {
      +            "type": "number"
      +          },
      +          "modelBasis": {
      +            "type": "string"
      +          },
      +          "storage": {
      +            "properties": {
      +              "date": {
      +                "type": "string"
      +              },
      +              "fillPct": {
      +                "type": "number"
      +              },
      +              "gasTwh": {
      +                "type": "number"
      +              },
      +              "scope": {
      +                "type": "string"
      +              },
      +              "trend": {
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "totalDemandTj": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "gulfCrudeShare": {
      +        "type": "number"
      +      },
      +      "ieaStocksCoverage": {
      +        "type": "boolean"
      +      },
      +      "jodiOilCoverage": {
      +        "type": "boolean"
      +      },
      +      "limitations": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "liveFlowRatio": {
      +        "type": "number"
      +      },
      +      "portwatchCoverage": {
      +        "type": "boolean"
      +      },
      +      "preCrisisBaseline": {
      +        "properties": {
      +          "basis": {
      +            "enum": [
      +              "comtrade_monthly",
      +              "comtrade_annual"
      +            ],
      +            "type": "string"
      +          },
      +          "crudeLossAfterBypassKbd": {
      +            "type": "number"
      +          },
      +          "crudeLossKbd": {
      +            "type": "number"
      +          },
      +          "fromMonth": {
      +            "type": "string"
      +          },
      +          "gulfCrudeShare": {
      +            "type": "number"
      +          },
      +          "monthsCovered": {
      +            "type": "number"
      +          },
      +          "toMonth": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "products": {
      +        "items": {
      +          "properties": {
      +            "deficitPct": {
      +              "type": "number"
      +            },
      +            "demandKbd": {
      +              "type": "number"
      +            },
      +            "outputLossKbd": {
      +              "type": "number"
      +            },
      +            "product": {
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "reportedStocks": {
      +        "properties": {
      +          "crudeMb": {
      +            "type": "number"
      +          },
      +          "month": {
      +            "type": "string"
      +          },
      +          "productsMb": {
      +            "type": "number"
      +          },
      +          "source": {
      +            "enum": [
      +              "jodi"
      +            ],
      +            "type": "string"
      +          },
      +          "stockDays": {
      +            "type": "number"
      +          },
      +          "totalMb": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "required": [
      +      "projection"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "data",
      +      "_attribution"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "_budget_exceeded"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "_jmespath_error"
      +    ]
      +  }
      +]
  4. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "assessment": {
      -        "type": "string"
      -      },
      -      "chokepointConfidence": {
      -        "type": "string"
      -      },
      -      "chokepointId": {
      -        "type": "string"
      -      },
      -      "comtradeCoverage": {
      -        "type": "boolean"
      -      },
      -      "countryCode": {
      -        "type": "string"
      -      },
      -      "coverageLevel": {
      -        "type": "string"
      -      },
      -      "crudeLossKbd": {
      -        "type": "number"
      -      },
      -      "currentFlows": {
      -        "properties": {
      -          "basis": {
      -            "enum": [
      -              "comtrade_monthly",
      -              "comtrade_annual"
      -            ],
      -            "type": "string"
      -          },
      -          "crudeLossAfterBypassKbd": {
      -            "type": "number"
      -          },
      -          "crudeLossKbd": {
      -            "type": "number"
      -          },
      -          "fromMonth": {
      -            "type": "string"
      -          },
      -          "gulfCrudeShare": {
      -            "type": "number"
      -          },
      -          "monthsCovered": {
      -            "type": "number"
      -          },
      -          "toMonth": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "dataAvailable": {
      -        "type": "boolean"
      -      },
      -      "degraded": {
      -        "type": "boolean"
      -      },
      -      "disruptionPct": {
      -        "type": "number"
      -      },
      -      "effectiveCoverDays": {
      -        "type": "number"
      -      },
      -      "gasSensitivity": {
      -        "properties": {
      -          "assessment": {
      -            "type": "string"
      -          },
      -          "dataAvailable": {
      -            "type": "boolean"
      -          },
      -          "dataMonth": {
      -            "type": "string"
      -          },
      -          "dataSource": {
      -            "type": "string"
      -          },
      -          "deficitPct": {
      -            "type": "number"
      -          },
      -          "lngDisruptionTj": {
      -            "type": "number"
      -          },
      -          "lngImportsTj": {
      -            "type": "number"
      -          },
      -          "lngShareOfImports": {
      -            "type": "number"
      -          },
      -          "modelBasis": {
      -            "type": "string"
      -          },
      -          "storage": {
      -            "properties": {
      -              "date": {
      -                "type": "string"
      -              },
      -              "fillPct": {
      -                "type": "number"
      -              },
      -              "gasTwh": {
      -                "type": "number"
      -              },
      -              "scope": {
      -                "type": "string"
      -              },
      -              "trend": {
      -                "type": "string"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "totalDemandTj": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "gulfCrudeShare": {
      -        "type": "number"
      -      },
      -      "ieaStocksCoverage": {
      -        "type": "boolean"
      -      },
      -      "jodiOilCoverage": {
      -        "type": "boolean"
      -      },
      -      "limitations": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "liveFlowRatio": {
      -        "type": "number"
      -      },
      -      "portwatchCoverage": {
      -        "type": "boolean"
      -      },
      -      "preCrisisBaseline": {
      -        "properties": {
      -          "basis": {
      -            "enum": [
      -              "comtrade_monthly",
      -              "comtrade_annual"
      -            ],
      -            "type": "string"
      -          },
      -          "crudeLossAfterBypassKbd": {
      -            "type": "number"
      -          },
      -          "crudeLossKbd": {
      -            "type": "number"
      -          },
      -          "fromMonth": {
      -            "type": "string"
      -          },
      -          "gulfCrudeShare": {
      -            "type": "number"
      -          },
      -          "monthsCovered": {
      -            "type": "number"
      -          },
      -          "toMonth": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "products": {
      -        "items": {
      -          "properties": {
      -            "deficitPct": {
      -              "type": "number"
      -            },
      -            "demandKbd": {
      -              "type": "number"
      -            },
      -            "outputLossKbd": {
      -              "type": "number"
      -            },
      -            "product": {
      -              "type": "string"
      -            }
      -          },
      -          "type": "object"
      -        },
      -        "type": "array"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "required": [
      -      "projection"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "data",
      -      "_attribution"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "_budget_exceeded"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "_jmespath_error"
      -    ]
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "assessment": {
      +        "type": "string"
      +      },
      +      "chokepointConfidence": {
      +        "type": "string"
      +      },
      +      "chokepointId": {
      +        "type": "string"
      +      },
      +      "comtradeCoverage": {
      +        "type": "boolean"
      +      },
      +      "countryCode": {
      +        "type": "string"
      +      },
      +      "coverageLevel": {
      +        "type": "string"
      +      },
      +      "crudeLossKbd": {
      +        "type": "number"
      +      },
      +      "currentFlows": {
      +        "properties": {
      +          "basis": {
      +            "enum": [
      +              "comtrade_monthly",
      +              "comtrade_annual"
      +            ],
      +            "type": "string"
      +          },
      +          "crudeLossAfterBypassKbd": {
      +            "type": "number"
      +          },
      +          "crudeLossKbd": {
      +            "type": "number"
      +          },
      +          "fromMonth": {
      +            "type": "string"
      +          },
      +          "gulfCrudeShare": {
      +            "type": "number"
      +          },
      +          "monthsCovered": {
      +            "type": "number"
      +          },
      +          "toMonth": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "dataAvailable": {
      +        "type": "boolean"
      +      },
      +      "degraded": {
      +        "type": "boolean"
      +      },
      +      "disruptionPct": {
      +        "type": "number"
      +      },
      +      "effectiveCoverDays": {
      +        "type": "number"
      +      },
      +      "gasSensitivity": {
      +        "properties": {
      +          "assessment": {
      +            "type": "string"
      +          },
      +          "dataAvailable": {
      +            "type": "boolean"
      +          },
      +          "dataMonth": {
      +            "type": "string"
      +          },
      +          "dataSource": {
      +            "type": "string"
      +          },
      +          "deficitPct": {
      +            "type": "number"
      +          },
      +          "lngDisruptionTj": {
      +            "type": "number"
      +          },
      +          "lngImportsTj": {
      +            "type": "number"
      +          },
      +          "lngShareOfImports": {
      +            "type": "number"
      +          },
      +          "modelBasis": {
      +            "type": "string"
      +          },
      +          "storage": {
      +            "properties": {
      +              "date": {
      +                "type": "string"
      +              },
      +              "fillPct": {
      +                "type": "number"
      +              },
      +              "gasTwh": {
      +                "type": "number"
      +              },
      +              "scope": {
      +                "type": "string"
      +              },
      +              "trend": {
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "totalDemandTj": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "gulfCrudeShare": {
      +        "type": "number"
      +      },
      +      "ieaStocksCoverage": {
      +        "type": "boolean"
      +      },
      +      "jodiOilCoverage": {
      +        "type": "boolean"
      +      },
      +      "limitations": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "liveFlowRatio": {
      +        "type": "number"
      +      },
      +      "portwatchCoverage": {
      +        "type": "boolean"
      +      },
      +      "preCrisisBaseline": {
      +        "properties": {
      +          "basis": {
      +            "enum": [
      +              "comtrade_monthly",
      +              "comtrade_annual"
      +            ],
      +            "type": "string"
      +          },
      +          "crudeLossAfterBypassKbd": {
      +            "type": "number"
      +          },
      +          "crudeLossKbd": {
      +            "type": "number"
      +          },
      +          "fromMonth": {
      +            "type": "string"
      +          },
      +          "gulfCrudeShare": {
      +            "type": "number"
      +          },
      +          "monthsCovered": {
      +            "type": "number"
      +          },
      +          "toMonth": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "products": {
      +        "items": {
      +          "properties": {
      +            "deficitPct": {
      +              "type": "number"
      +            },
      +            "demandKbd": {
      +              "type": "number"
      +            },
      +            "outputLossKbd": {
      +              "type": "number"
      +            },
      +            "product": {
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "reserveEstimate": {
      +        "properties": {
      +          "asOf": {
      +            "type": "string"
      +          },
      +          "centralMb": {
      +            "type": "number"
      +          },
      +          "coverDaysHigh": {
      +            "type": "number"
      +          },
      +          "coverDaysLow": {
      +            "type": "number"
      +          },
      +          "credibility": {
      +            "enum": [
      +              "high",
      +              "low"
      +            ],
      +            "type": "string"
      +          },
      +          "highMb": {
      +            "type": "number"
      +          },
      +          "lowMb": {
      +            "type": "number"
      +          },
      +          "scope": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "required": [
      +      "projection"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "data",
      +      "_attribution"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "_budget_exceeded"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "_jmespath_error"
      +    ]
      +  }
      +]
  5. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "assessment": {
      -        "type": "string"
      -      },
      -      "chokepointConfidence": {
      -        "type": "string"
      -      },
      -      "chokepointId": {
      -        "type": "string"
      -      },
      -      "comtradeCoverage": {
      -        "type": "boolean"
      -      },
      -      "countryCode": {
      -        "type": "string"
      -      },
      -      "coverageLevel": {
      -        "type": "string"
      -      },
      -      "crudeLossKbd": {
      -        "type": "number"
      -      },
      -      "currentFlows": {
      -        "properties": {
      -          "basis": {
      -            "enum": [
      -              "comtrade_monthly",
      -              "comtrade_annual"
      -            ],
      -            "type": "string"
      -          },
      -          "crudeLossKbd": {
      -            "type": "number"
      -          },
      -          "fromMonth": {
      -            "type": "string"
      -          },
      -          "gulfCrudeShare": {
      -            "type": "number"
      -          },
      -          "monthsCovered": {
      -            "type": "number"
      -          },
      -          "toMonth": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "dataAvailable": {
      -        "type": "boolean"
      -      },
      -      "degraded": {
      -        "type": "boolean"
      -      },
      -      "disruptionPct": {
      -        "type": "number"
      -      },
      -      "effectiveCoverDays": {
      -        "type": "number"
      -      },
      -      "gasSensitivity": {
      -        "properties": {
      -          "assessment": {
      -            "type": "string"
      -          },
      -          "dataAvailable": {
      -            "type": "boolean"
      -          },
      -          "dataMonth": {
      -            "type": "string"
      -          },
      -          "dataSource": {
      -            "type": "string"
      -          },
      -          "deficitPct": {
      -            "type": "number"
      -          },
      -          "lngDisruptionTj": {
      -            "type": "number"
      -          },
      -          "lngImportsTj": {
      -            "type": "number"
      -          },
      -          "lngShareOfImports": {
      -            "type": "number"
      -          },
      -          "modelBasis": {
      -            "type": "string"
      -          },
      -          "storage": {
      -            "properties": {
      -              "date": {
      -                "type": "string"
      -              },
      -              "fillPct": {
      -                "type": "number"
      -              },
      -              "gasTwh": {
      -                "type": "number"
      -              },
      -              "scope": {
      -                "type": "string"
      -              },
      -              "trend": {
      -                "type": "string"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "totalDemandTj": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "gulfCrudeShare": {
      -        "type": "number"
      -      },
      -      "ieaStocksCoverage": {
      -        "type": "boolean"
      -      },
      -      "jodiOilCoverage": {
      -        "type": "boolean"
      -      },
      -      "limitations": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "liveFlowRatio": {
      -        "type": "number"
      -      },
      -      "portwatchCoverage": {
      -        "type": "boolean"
      -      },
      -      "preCrisisBaseline": {
      -        "properties": {
      -          "basis": {
      -            "enum": [
      -              "comtrade_monthly",
      -              "comtrade_annual"
      -            ],
      -            "type": "string"
      -          },
      -          "crudeLossKbd": {
      -            "type": "number"
      -          },
      -          "fromMonth": {
      -            "type": "string"
      -          },
      -          "gulfCrudeShare": {
      -            "type": "number"
      -          },
      -          "monthsCovered": {
      -            "type": "number"
      -          },
      -          "toMonth": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "products": {
      -        "items": {
      -          "properties": {
      -            "deficitPct": {
      -              "type": "number"
      -            },
      -            "demandKbd": {
      -              "type": "number"
      -            },
      -            "outputLossKbd": {
      -              "type": "number"
      -            },
      -            "product": {
      -              "type": "string"
      -            }
      -          },
      -          "type": "object"
      -        },
      -        "type": "array"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "required": [
      -      "projection"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "data",
      -      "_attribution"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "_budget_exceeded"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "_jmespath_error"
      -    ]
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "assessment": {
      +        "type": "string"
      +      },
      +      "chokepointConfidence": {
      +        "type": "string"
      +      },
      +      "chokepointId": {
      +        "type": "string"
      +      },
      +      "comtradeCoverage": {
      +        "type": "boolean"
      +      },
      +      "countryCode": {
      +        "type": "string"
      +      },
      +      "coverageLevel": {
      +        "type": "string"
      +      },
      +      "crudeLossKbd": {
      +        "type": "number"
      +      },
      +      "currentFlows": {
      +        "properties": {
      +          "basis": {
      +            "enum": [
      +              "comtrade_monthly",
      +              "comtrade_annual"
      +            ],
      +            "type": "string"
      +          },
      +          "crudeLossAfterBypassKbd": {
      +            "type": "number"
      +          },
      +          "crudeLossKbd": {
      +            "type": "number"
      +          },
      +          "fromMonth": {
      +            "type": "string"
      +          },
      +          "gulfCrudeShare": {
      +            "type": "number"
      +          },
      +          "monthsCovered": {
      +            "type": "number"
      +          },
      +          "toMonth": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "dataAvailable": {
      +        "type": "boolean"
      +      },
      +      "degraded": {
      +        "type": "boolean"
      +      },
      +      "disruptionPct": {
      +        "type": "number"
      +      },
      +      "effectiveCoverDays": {
      +        "type": "number"
      +      },
      +      "gasSensitivity": {
      +        "properties": {
      +          "assessment": {
      +            "type": "string"
      +          },
      +          "dataAvailable": {
      +            "type": "boolean"
      +          },
      +          "dataMonth": {
      +            "type": "string"
      +          },
      +          "dataSource": {
      +            "type": "string"
      +          },
      +          "deficitPct": {
      +            "type": "number"
      +          },
      +          "lngDisruptionTj": {
      +            "type": "number"
      +          },
      +          "lngImportsTj": {
      +            "type": "number"
      +          },
      +          "lngShareOfImports": {
      +            "type": "number"
      +          },
      +          "modelBasis": {
      +            "type": "string"
      +          },
      +          "storage": {
      +            "properties": {
      +              "date": {
      +                "type": "string"
      +              },
      +              "fillPct": {
      +                "type": "number"
      +              },
      +              "gasTwh": {
      +                "type": "number"
      +              },
      +              "scope": {
      +                "type": "string"
      +              },
      +              "trend": {
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "totalDemandTj": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "gulfCrudeShare": {
      +        "type": "number"
      +      },
      +      "ieaStocksCoverage": {
      +        "type": "boolean"
      +      },
      +      "jodiOilCoverage": {
      +        "type": "boolean"
      +      },
      +      "limitations": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "liveFlowRatio": {
      +        "type": "number"
      +      },
      +      "portwatchCoverage": {
      +        "type": "boolean"
      +      },
      +      "preCrisisBaseline": {
      +        "properties": {
      +          "basis": {
      +            "enum": [
      +              "comtrade_monthly",
      +              "comtrade_annual"
      +            ],
      +            "type": "string"
      +          },
      +          "crudeLossAfterBypassKbd": {
      +            "type": "number"
      +          },
      +          "crudeLossKbd": {
      +            "type": "number"
      +          },
      +          "fromMonth": {
      +            "type": "string"
      +          },
      +          "gulfCrudeShare": {
      +            "type": "number"
      +          },
      +          "monthsCovered": {
      +            "type": "number"
      +          },
      +          "toMonth": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "products": {
      +        "items": {
      +          "properties": {
      +            "deficitPct": {
      +              "type": "number"
      +            },
      +            "demandKbd": {
      +              "type": "number"
      +            },
      +            "outputLossKbd": {
      +              "type": "number"
      +            },
      +            "product": {
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "required": [
      +      "projection"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "data",
      +      "_attribution"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "_budget_exceeded"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "_jmespath_error"
      +    ]
      +  }
      +]
  6. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "assessment": {
      -        "type": "string"
      -      },
      -      "chokepointConfidence": {
      -        "type": "string"
      -      },
      -      "chokepointId": {
      -        "type": "string"
      -      },
      -      "comtradeCoverage": {
      -        "type": "boolean"
      -      },
      -      "countryCode": {
      -        "type": "string"
      -      },
      -      "coverageLevel": {
      -        "type": "string"
      -      },
      -      "crudeLossKbd": {
      -        "type": "number"
      -      },
      -      "dataAvailable": {
      -        "type": "boolean"
      -      },
      -      "degraded": {
      -        "type": "boolean"
      -      },
      -      "disruptionPct": {
      -        "type": "number"
      -      },
      -      "effectiveCoverDays": {
      -        "type": "number"
      -      },
      -      "gasSensitivity": {
      -        "properties": {
      -          "assessment": {
      -            "type": "string"
      -          },
      -          "dataAvailable": {
      -            "type": "boolean"
      -          },
      -          "dataMonth": {
      -            "type": "string"
      -          },
      -          "dataSource": {
      -            "type": "string"
      -          },
      -          "deficitPct": {
      -            "type": "number"
      -          },
      -          "lngDisruptionTj": {
      -            "type": "number"
      -          },
      -          "lngImportsTj": {
      -            "type": "number"
      -          },
      -          "lngShareOfImports": {
      -            "type": "number"
      -          },
      -          "modelBasis": {
      -            "type": "string"
      -          },
      -          "storage": {
      -            "properties": {
      -              "date": {
      -                "type": "string"
      -              },
      -              "fillPct": {
      -                "type": "number"
      -              },
      -              "gasTwh": {
      -                "type": "number"
      -              },
      -              "scope": {
      -                "type": "string"
      -              },
      -              "trend": {
      -                "type": "string"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "totalDemandTj": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "gulfCrudeShare": {
      -        "type": "number"
      -      },
      -      "ieaStocksCoverage": {
      -        "type": "boolean"
      -      },
      -      "jodiOilCoverage": {
      -        "type": "boolean"
      -      },
      -      "limitations": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "liveFlowRatio": {
      -        "type": "number"
      -      },
      -      "portwatchCoverage": {
      -        "type": "boolean"
      -      },
      -      "products": {
      -        "items": {
      -          "properties": {
      -            "deficitPct": {
      -              "type": "number"
      -            },
      -            "demandKbd": {
      -              "type": "number"
      -            },
      -            "outputLossKbd": {
      -              "type": "number"
      -            },
      -            "product": {
      -              "type": "string"
      -            }
      -          },
      -          "type": "object"
      -        },
      -        "type": "array"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "required": [
      -      "projection"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "data",
      -      "_attribution"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "_budget_exceeded"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "_jmespath_error"
      -    ]
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "assessment": {
      +        "type": "string"
      +      },
      +      "chokepointConfidence": {
      +        "type": "string"
      +      },
      +      "chokepointId": {
      +        "type": "string"
      +      },
      +      "comtradeCoverage": {
      +        "type": "boolean"
      +      },
      +      "countryCode": {
      +        "type": "string"
      +      },
      +      "coverageLevel": {
      +        "type": "string"
      +      },
      +      "crudeLossKbd": {
      +        "type": "number"
      +      },
      +      "currentFlows": {
      +        "properties": {
      +          "basis": {
      +            "enum": [
      +              "comtrade_monthly",
      +              "comtrade_annual"
      +            ],
      +            "type": "string"
      +          },
      +          "crudeLossKbd": {
      +            "type": "number"
      +          },
      +          "fromMonth": {
      +            "type": "string"
      +          },
      +          "gulfCrudeShare": {
      +            "type": "number"
      +          },
      +          "monthsCovered": {
      +            "type": "number"
      +          },
      +          "toMonth": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "dataAvailable": {
      +        "type": "boolean"
      +      },
      +      "degraded": {
      +        "type": "boolean"
      +      },
      +      "disruptionPct": {
      +        "type": "number"
      +      },
      +      "effectiveCoverDays": {
      +        "type": "number"
      +      },
      +      "gasSensitivity": {
      +        "properties": {
      +          "assessment": {
      +            "type": "string"
      +          },
      +          "dataAvailable": {
      +            "type": "boolean"
      +          },
      +          "dataMonth": {
      +            "type": "string"
      +          },
      +          "dataSource": {
      +            "type": "string"
      +          },
      +          "deficitPct": {
      +            "type": "number"
      +          },
      +          "lngDisruptionTj": {
      +            "type": "number"
      +          },
      +          "lngImportsTj": {
      +            "type": "number"
      +          },
      +          "lngShareOfImports": {
      +            "type": "number"
      +          },
      +          "modelBasis": {
      +            "type": "string"
      +          },
      +          "storage": {
      +            "properties": {
      +              "date": {
      +                "type": "string"
      +              },
      +              "fillPct": {
      +                "type": "number"
      +              },
      +              "gasTwh": {
      +                "type": "number"
      +              },
      +              "scope": {
      +                "type": "string"
      +              },
      +              "trend": {
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "totalDemandTj": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "gulfCrudeShare": {
      +        "type": "number"
      +      },
      +      "ieaStocksCoverage": {
      +        "type": "boolean"
      +      },
      +      "jodiOilCoverage": {
      +        "type": "boolean"
      +      },
      +      "limitations": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "liveFlowRatio": {
      +        "type": "number"
      +      },
      +      "portwatchCoverage": {
      +        "type": "boolean"
      +      },
      +      "preCrisisBaseline": {
      +        "properties": {
      +          "basis": {
      +            "enum": [
      +              "comtrade_monthly",
      +              "comtrade_annual"
      +            ],
      +            "type": "string"
      +          },
      +          "crudeLossKbd": {
      +            "type": "number"
      +          },
      +          "fromMonth": {
      +            "type": "string"
      +          },
      +          "gulfCrudeShare": {
      +            "type": "number"
      +          },
      +          "monthsCovered": {
      +            "type": "number"
      +          },
      +          "toMonth": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "products": {
      +        "items": {
      +          "properties": {
      +            "deficitPct": {
      +              "type": "number"
      +            },
      +            "demandKbd": {
      +              "type": "number"
      +            },
      +            "outputLossKbd": {
      +              "type": "number"
      +            },
      +            "product": {
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "required": [
      +      "projection"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "data",
      +      "_attribution"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "_budget_exceeded"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "_jmespath_error"
      +    ]
      +  }
      +]
  7. Changed3 schema fields changed
    • addedInput schema / properties / chokepoint_id / description
      Added value: +"Registry id of the disrupted chokepoint; only chokepoints with a supported shock model are listed."
    • addedInput schema / properties / disruption_pct / description
      Added value: +"Share of the chokepoint flow disrupted, 10-100 percent (default 100, a full closure)."
    • addedInput schema / properties / fuel_mode / description
      Added value: +"Which fuel sensitivity to compute: oil (default), gas or both."
  8. Added

TDQS

A3.8/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With annotations already covering read-only, idempotent and non-destructive behavior, the description goes well beyond them: it discloses caching ('Results may be cached; no user scenario is saved'), degradation flags (degraded, limitations, chokepointConfidence), the comtrade_annual fallback, and the bypass-rerouting adjustment for Hormuz crudeLossKbd. It also warns against two specific misreadings ('an unavailable source is not a zero deficit', 'assumed LNG routing is not a measured live-flow shock'). That is unusually rich behavioral context for a read-only analytical tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

It is front-loaded correctly, purpose first, then input settings, then output semantics. But the middle and end are a dense run-on that enumerates output field names (dataAvailable, coverageLevel, gasSensitivity.modelBasis) which an output schema already exists to carry. Those clauses dilute the high-value caveats that follow.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a scenario model with an output schema and full annotation coverage, the description supplies what an agent actually needs: input range/defaults, caching behavior, stability caveats, and units (products kb/d, gas TJ, storage TWh, cover days). It is slightly over-complete on return-value enumeration and silent on error behavior, but nothing essential is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the five parameters are already documented and the description largely restates disruption_pct's 10-100 range and fuel_mode's default rather than adding meaning. It says nothing extra about country, chokepoint_id, or jmespath (which is deferred to initialize.instructions). Baseline 3 applies when the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening sentence gives a specific verb and resource: compute an oil/gas supply-sensitivity scenario for a country plus a supported chokepoint. That is clearly distinct from sibling reads such as get_chokepoint_status or get_supply_chain_cost_shock. It stops short of naming any sibling or stating the boundary between this scenario tool and adjacent shock/vulnerability tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied rather than stated: the description tells you which inputs to set and their defaults, but never says when to reach for this versus get_supply_vulnerabilities, get_supply_chain_cost_shock, or simulate_infrastructure_cascade. There are no explicit when-not conditions, though the 'assumed vs measured' caveats hint at appropriate interpretation.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.