Previous value: -"Station IDs to select; every supplied ID is forwarded. Alternatively select station:, network:, or quoted market: in query. A selector is required; obtain values from gdelt_list_tv_stations."New value: +"Station IDs to select (e.g. [\"CNN\", \"FOXNEWS\"]) — the stationId values gdelt_list_tv_stations returns, not display labels such as \"FOX News\"; every supplied ID is forwarded. Alternatively select station:, network:, or quoted market: in query. A selector is required; obtain network and market values from gdelt_list_tv_stations."

Previous value: -"Relative time window, such as 1m or 6m. Ignored when both explicit datetimes are supplied. Check per-station archive coverage before selecting a window."New value: +"Relative window counting back from now (a number and unit such as d, m, or y). Now is past the end of most stations' monitoring, so for archived periods set startDatetime/endDatetime inside a station's range from gdelt_list_tv_stations. Ignored when startDatetime/endDatetime are set."

Previous value: -"Machine-readable failure mode. Declared by this tool: `invalid_date_range`: Only one explicit datetime was supplied, a datetime is not a real UTC timestamp, or startDatetime is not earlier than endDatetime. `offset_out_of_range`: The requested row offset is at or beyond the end of a non-empty ranking. `invalid_query`: GDELT rejected the query or the TV timespan is malformed. `gdelt_rate_limited`: GDELT rejected its request-spacing limit, or the request queue could not start this call in time. `gdelt_unavailable`: GDELT TV API is unreachable or temporarily returned no usable data. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `invalid_date_range`: Only one explicit datetime was supplied, a datetime is not a real UTC timestamp, or startDatetime is not earlier than endDatetime. `offset_out_of_range`: The requested row offset is at or beyond the end of a non-empty ranking. `invalid_query`: A stations entry is not a station ID, GDELT rejected the query, or the TV timespan is malformed. `gdelt_rate_limited`: GDELT rejected its request-spacing limit, or the request queue could not start this call in time. `gdelt_unavailable`: GDELT TV API is unreachable or temporarily returned no usable data. Other values are possible when a failure originates below the handler."

Previous value: -"Empty-result guidance, show percentage and selector limitations, or station catalog resolution limitations."New value: +"When no rows matched: the resolved timespan window; for each selected station whose monitoring range the window misses, that range and how to search inside it; and how to check station monitoring ranges. On show rankings, that values are percentages of matching clips and ellipsized labels may not work as show: selectors. On station rankings whose page has rows without a station ID, why: the station catalog did not load, or has no entry for the named labels. Absent on a non-empty station ranking whose rows on the page all carry station IDs."

Added value: +{
+  "additionalProperties": false,
+  "description": "Present only when the refetch of this exact request was refused, failed, or came back empty, and the response is GDELT's stored answer from fetchedAt instead. It holds nothing published after fetchedAt; a relative timespan covers the window ending at fetchedAt, not now. Absent on a live answer.",
+  "properties": {
+    "ageSeconds": {
+      "description": "Age of the stored answer when served, in whole seconds.",
+      "type": "number"
+    },
+    "fetchedAt": {
+      "description": "ISO 8601 time GDELT returned the stored answer.",
+      "type": "string"
+    },
+    "reason": {
+      "description": "Why the refetch was not used: GDELT rate-limited it, did not answer with data, or answered empty — which GDELT also does under load.",
+      "enum": [
+        "gdelt_rate_limited",
+        "gdelt_unavailable",
+        "gdelt_empty"
+      ],
+      "type": "string"
+    }
+  },
+  "required": [
+    "fetchedAt",
+    "ageSeconds",
+    "reason"
+  ],
+  "type": "object"
+}