changedOutput schema / (root)
Previous value: -nullNew value: +{
+ "additionalProperties": {},
+ "description": "DCPI rank for ONE market: BUILD/CAUTION/AVOID verdict, component scores, time-to-power, and analyst narrative — alongside the DC Hub envelope keys.",
+ "properties": {
+ "_entity": {
+ "description": "Payload class (facility|market|iso_grid|queue_results|deal|report|response); branch on it.",
+ "type": "string"
+ },
+ "_front_door": {
+ "additionalProperties": {},
+ "description": "First-tool hint: plan_query(intent) returns the ordered plan.",
+ "properties": {},
+ "type": "object"
+ },
+ "_return_loop": {
+ "additionalProperties": {},
+ "description": "Next-session delta call (get_changes).",
+ "properties": {},
+ "type": "object"
+ },
+ "avg_kwh_cents": {
+ "anyOf": [
+ {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Average retail power price, cents/kWh (may arrive as a string)"
+ },
+ "citation": {
+ "anyOf": [
+ {
+ "additionalProperties": {},
+ "properties": {},
+ "type": "object"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "How to attribute DC Hub: {source, url, license, cite_as, retrieved_at}, or the attribution line as a string."
+ },
+ "composite_score": {
+ "anyOf": [
+ {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "0-100 verdict-aware composite score"
+ },
+ "computed_at": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "When the score row was computed"
+ },
+ "constraint_score": {
+ "anyOf": [
+ {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "0-100 constraint component"
+ },
+ "curtailment_pct": {
+ "anyOf": [
+ {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Curtailment, %"
+ },
+ "data_basis": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "What the scores were computed from"
+ },
+ "data_basis_source": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Source of the data basis"
+ },
+ "excess_power_score": {
+ "anyOf": [
+ {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "0-100 excess-power component"
+ },
+ "forecast": {
+ "anyOf": [
+ {
+ "additionalProperties": {},
+ "properties": {},
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Forecast availability block: {available, note, reason, samples_in_30d} — see predict_market_trajectory"
+ },
+ "iso": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "ISO/RTO serving the market"
+ },
+ "latitude": {
+ "anyOf": [
+ {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Market anchor latitude"
+ },
+ "longitude": {
+ "anyOf": [
+ {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Market anchor longitude"
+ },
+ "market_name": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Market display name"
+ },
+ "market_slug": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Market slug"
+ },
+ "narrative": {
+ "description": "~100-word CBRE/JLL-style analyst read on the market — quote directly with attribution to DC Hub (CC-BY-4.0)"
+ },
+ "provenance": {
+ "additionalProperties": {},
+ "description": "Source, method, as_of, verification_counts, license, cite_as; quote it when citing.",
+ "properties": {},
+ "type": "object"
+ },
+ "published": {
+ "anyOf": [
+ {
+ "type": "boolean"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Whether the score is published"
+ },
+ "quality_score": {
+ "anyOf": [
+ {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "0-100 data-quality score for this market"
+ },
+ "queue_wait_months": {
+ "anyOf": [
+ {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "ISO queue wait, months"
+ },
+ "quota": {
+ "additionalProperties": {},
+ "description": "Caller quota state (remaining calls, tier).",
+ "properties": {},
+ "type": "object"
+ },
+ "reserve_margin_pct": {
+ "anyOf": [
+ {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Grid reserve margin, %"
+ },
+ "site_evaluation_handoff": {
+ "anyOf": [
+ {
+ "items": {
+ "additionalProperties": {},
+ "properties": {},
+ "type": "object"
+ },
+ "type": "array"
+ },
+ {
+ "additionalProperties": {},
+ "properties": {},
+ "type": "object"
+ }
+ ],
+ "description": "Follow-up calls [{tool, parameters, why}] when the payload carries coordinates."
+ },
+ "state": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "US state / region code"
+ },
+ "tier_required": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Tier required for the full row"
+ },
+ "time_to_power_months": {
+ "anyOf": [
+ {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Estimated months to power for a new interconnection"
+ },
+ "top_opportunities_json": {
+ "description": "Top opportunity bullets for the market"
+ },
+ "top_risks_json": {
+ "description": "Top risk bullets for the market"
+ },
+ "trend_30d": {
+ "description": "30-day trend read when enough snapshots exist"
+ },
+ "verdict": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "DCPI verdict: BUILD | CAUTION | AVOID"
+ }
+ },
+ "type": "object"
+}
