run_analysis

{
  "type": "object",
  "properties": {
    "map_id": {
      "type": "string",
      "minLength": 1
    },
    "analysis": {
      "type": "string",
      "enum": [
        "hotspot",
        "zonal",
        "enrich",
        "join",
        "merge",
        "near",
        "dissolve"
      ],
      "description": "Which analysis to run. 'hotspot' = Getis-Ord Gi* with FDR-corrected significance classes. 'zonal' = aggregate a point layer into polygon zones (count/sum/mean/min/max choropleth). 'enrich' = join a US Census indicator onto each feature by containment (tract/county/state). 'join' = spatial join (attribute transfer): each POINT in layerId takes the listed properties from the polygon in joinLayerId that contains it — the aggregate direction (points INTO polygons) is 'zonal'. 'merge' = append layerId + mergeLayerId (same geometry class) into ONE dataset, each row stamped with its source layer. 'near' = each POINT in layerId gains the great-circle distance to (and identity of) its nearest feature in nearLayerId. 'dissolve' = union POLYGONS sharing a dissolveField value into single features (omit the field to dissolve all into one)."
    },
    "layerId": {
      "type": "string",
      "minLength": 1,
      "description": "The workspace layer to analyze (geojson-backed; the point source for zonal; the point TARGET for join; the styling donor for merge)."
    },
    "valueField": {
      "description": "Numeric property to analyze. hotspot: omit on point layers for incident-DENSITY mode (hex-binned counts). zonal: omit for count-only aggregation.",
      "type": "string",
      "minLength": 1
    },
    "k": {
      "description": "hotspot only: nearest neighbors per feature (default 8).",
      "type": "integer",
      "minimum": 3,
      "maximum": 24
    },
    "hexMeters": {
      "description": "hotspot density mode only: hex cell spacing in meters (default auto from the data extent).",
      "type": "number",
      "minimum": 100,
      "maximum": 50000
    },
    "zoneLayerId": {
      "description": "zonal only: an existing polygon layer to aggregate into. Provide EXACTLY ONE of zoneLayerId or zones.",
      "type": "string",
      "minLength": 1
    },
    "zones": {
      "description": "zonal only: generate an h3 hex fishnet over the source extent instead of using a zone layer (resolution 3-10, default auto). Provide EXACTLY ONE of zoneLayerId or zones.",
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "const": "h3"
        },
        "resolution": {
          "type": "integer",
          "minimum": 3,
          "maximum": 10
        }
      },
      "required": [
        "kind"
      ],
      "additionalProperties": false
    },
    "stats": {
      "description": "zonal only: which statistics to attach per zone (default: count, plus sum/mean/min/max when valueField is set).",
      "minItems": 1,
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "count",
          "sum",
          "mean",
          "min",
          "max"
        ]
      }
    },
    "indicator": {
      "description": "enrich only (required there): a US Census ACS preset id (e.g. 'median_household_income', 'median_home_value', 'median_rent') or a raw ACS variable code (e.g. 'B19013_001E').",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "geoLevel": {
      "description": "enrich only: containment geography (default tract). Tract/county fetch only the states the data touches, capped at 3 — filter first or use state for wider layers.",
      "type": "string",
      "enum": [
        "state",
        "county",
        "tract"
      ]
    },
    "joinLayerId": {
      "description": "join only (required there): the POLYGON layer providing the attributes.",
      "type": "string",
      "minLength": 1
    },
    "fields": {
      "description": "join only: which join-layer properties to transfer (default: auto-select up to 12 non-internal properties, overflow reported).",
      "minItems": 1,
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 80
      }
    },
    "prefix": {
      "description": "join only: prefix for a joined field whose name collides with an existing target property (default \"join_\").",
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    },
    "mergeLayerId": {
      "description": "merge only (required there): the second layer — same geometry class (point/line/polygon) as layerId.",
      "type": "string",
      "minLength": 1
    },
    "sourceField": {
      "description": "merge only: name of the per-row provenance column naming each row's source layer (default \"merge_source\"; renamed on collision, reported).",
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    },
    "nearLayerId": {
      "description": "near only (required there): the POINT layer to search for each target point's nearest neighbor.",
      "type": "string",
      "minLength": 1
    },
    "nearField": {
      "description": "near only: property of the nearest feature to copy as its identity (default: first name-like property).",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "maxDistanceM": {
      "description": "near only: search radius in meters — a point whose nearest neighbor is farther carries NO near fields (reported).",
      "type": "number",
      "minimum": 1,
      "maximum": 20000000
    },
    "dissolveField": {
      "description": "dissolve only: group-by property (omit = dissolve ALL into one footprint); missing values form their own \"(no value)\" group.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "sumFields": {
      "description": "dissolve only: numeric properties to SUM per group — skipped values reported, a group with none present carries NO sum.",
      "minItems": 1,
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 80
      }
    },
    "annotate": {
      "description": "Opt-in: place ONE callout annotation at the headline feature (hottest cluster / top zone / highest value). Label text comes only from computed values.",
      "type": "boolean"
    },
    "story": {
      "description": "Opt-in: persist the shared map with a 2-step story rail (grounded overview + analysis memo isolating the result layer) — the /m/ link opens with it.",
      "type": "boolean"
    },
    "rationale": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "description": "Short audit-log label (≤300 chars) stating the user-facing goal this call serves, e.g. \"add wildfire layer for the user's California query\". Required on every call. Stored in the operations log so map edits stay traceable — we never see your chat history."
    }
  },
  "required": [
    "map_id",
    "analysis",
    "layerId",
    "rationale"
  ]
}