sky-to-porch-webmcp.vercel.app

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "place",
    "hazard",
    "time"
  ],
  "properties": {
    "place": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200,
      "description": "Initial call: pass the named place as stated, even if ambiguous; do not qualify it first. Strip context: 'near my Houston home' becomes 'Houston'. After a choice, keep this original query."
    },
    "place_choice_id": {
      "type": [
        "string",
        "null"
      ],
      "pattern": "^place-[A-Za-z0-9._-]{3,120}$",
      "description": "Initial call: use null. Only after needs_place_choice: copy the selected choice_id exactly. Never derive it from a place, label, demo, or coordinates; never invent or edit it."
    },
    "hazard": {
      "type": "string",
      "enum": [
        "fire_smoke",
        "flood_storm",
        "wind_storm",
        "extreme_heat",
        "drought_land",
        "air_quality",
        "earth_volcanoes"
      ],
      "description": "Choose a named/implied hazard; never infer from season/place/concern/generic conditions. Smoke + air uses fire_smoke/related_context. Volcano + air/heat uses earth_volcanoes/related_context. If none, ask and wait."
    },
    "analysis_scope": {
      "type": "string",
      "enum": [
        "single_hazard_only",
        "related_context"
      ],
      "description": "For generic storm/severe weather, use related_context so separate wind and water chains run at any radius. Use single_hazard_only only for explicit wind/gust or rain/flood/gage asks; Wind without question widens."
    },
    "concern": {
      "type": "string",
      "enum": [
        "general",
        "home",
        "health",
        "pets",
        "travel",
        "power_internet",
        "community"
      ],
      "description": "Use pets for dog/cat/animal; health for person/family; home whenever home/roof/property/insurer appears; travel for travel. Never map pet symptoms to health. Otherwise general."
    },
    "radius_km": {
      "type": "number",
      "minimum": 1,
      "maximum": 250,
      "default": 25,
      "description": "Analysis radius in kilometres; defaults to 25."
    },
    "time": {
      "type": "string",
      "pattern": "^(latest_completed|\\d{4}-\\d{2}-\\d{2}(?:/\\d{4}-\\d{2}-\\d{2})?)$",
      "description": "After needs_place_choice, copy retry_with_original_arguments.time exactly. Otherwise use latest_completed unless the person stated dates; never invent a date or use today."
    },
    "question": {
      "type": "string",
      "maxLength": 500,
      "description": "Optional, except MUST copy the person's wording for unqualified storm/thunderstorm/severe weather so deterministic routing can include separate wind and water chains. Shorten only to 500 characters."
    }
  }
}