pgmaps.ahmadjalil.com

{
  "name": "list_map_experiences",
  "kind": "answer",
  "impl": "imperative",
  "description": "Discover PGMaps workspaces beyond the project catalog, including food safety, air quality, census, index building, boundaries, Indigenous research, outdoors planning, and infrastructure.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "maxLength": 160,
        "description": "Optional topic, place, dataset, or activity."
      }
    },
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "open_map_experience",
  "kind": "act",
  "impl": "imperative",
  "description": "Open a PGMaps workspace by the exact ID returned by list_map_experiences so the person and agent share its visible map state.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string",
        "enum": [
          "flatten-pg",
          "flatten-sf",
          "projects",
          "food-safety",
          "air-quality",
          "explorer",
          "census",
          "index-lab",
          "density-lab",
          "correlation-lab",
          "parks-and-trails",
          "boundary-explorer",
          "land-acknowledgement",
          "outdoors-planner",
          "wastewater",
          "health-services"
        ]
      }
    },
    "required": [
      "id"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "get_food_safety_context",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read the active food-safety map filters, historical inspection totals, selected establishment, and highest-risk matching establishments. Treat records as historical public-health context, not real-time safety advice.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "maxResults": {
        "type": "integer",
        "minimum": 1,
        "maximum": 20,
        "default": 8
      }
    },
    "additionalProperties": false
  },
  "page": "/foodmap"
}

{
  "name": "filter_food_safety_map",
  "kind": "act",
  "impl": "imperative",
  "description": "Update the visible food-safety map by name or address, hazard rating, facility type, violation count, and inspection period. Omitted fields stay unchanged; empty arrays intentionally show no matches.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "maxLength": 160
      },
      "visualizationMode": {
        "type": "string",
        "enum": [
          "violations",
          "hazard"
        ]
      },
      "hazardRatings": {
        "type": "array",
        "uniqueItems": true,
        "items": {
          "type": "string",
          "enum": [
            "Low",
            "Moderate",
            "Unknown"
          ]
        }
      },
      "facilityTypes": {
        "type": "array",
        "uniqueItems": true,
        "items": {
          "type": "string",
          "enum": [
            "Restaurant",
            "Food Truck",
            "Camp",
            "Catering",
            "Concession",
            "Stand",
            "Bakery",
            "Coffee Shop",
            "Bar/Pub",
            "Brewery/Winery",
            "Deli",
            "Community Kitchen",
            "Social Services",
            "Gas Station",
            "Hotel",
            "Recreation",
            "Farm",
            "Institutional Kitchen",
            "Store",
            "Other",
            "Unknown"
          ]
        }
      },
      "violationBuckets": {
        "type": "array",
        "uniqueItems": true,
        "description": "'zero' means inspected in the active period with no violations; 'uninspected' holds establishments with no inspection in that period.",
        "items": {
          "type": "string",
          "enum": [
            "zero",
            "low",
            "medium",
            "high",
            "uninspected"
          ]
        }
      },
      "timelineMonths": {
        "type": "integer",
        "enum": [
          0,
          3,
          6,
          12,
          24
        ]
      },
      "timelineMode": {
        "type": "string",
        "enum": [
          "period",
          "cumulative"
        ]
      }
    },
    "additionalProperties": false
  },
  "page": "/foodmap"
}

{
  "name": "rank_food_options",
  "kind": "act",
  "impl": "imperative",
  "description": "Find the best currently filtered food establishments for a user who wants both fewer inspection violations and fewer nearby mapped property-crime incidents. Returns a transparent, balanced ranking; call select_food_establishment to open the chosen result.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "radiusMeters": {
        "type": "integer",
        "enum": [
          250,
          500,
          1000,
          2000
        ],
        "default": 500,
        "description": "Radius around each establishment used to count mapped incidents."
      },
      "crimeLookbackMonths": {
        "type": "integer",
        "enum": [
          12,
          24,
          36,
          60
        ],
        "default": 36,
        "description": "Historical window used for nearby property-crime incidents."
      },
      "crimeWeight": {
        "type": "integer",
        "minimum": 0,
        "maximum": 100,
        "default": 50,
        "description": "Percent of the ranking assigned to nearby crime; the remainder is inspection violations."
      },
      "requireInspections": {
        "type": "boolean",
        "default": true,
        "description": "Exclude establishments with no inspections in the active food-map period."
      },
      "maxResults": {
        "type": "integer",
        "minimum": 1,
        "maximum": 10,
        "default": 5
      }
    },
    "additionalProperties": false
  },
  "page": "/foodmap"
}

{
  "name": "select_food_establishment",
  "kind": "act",
  "impl": "imperative",
  "description": "Select one establishment from the currently filtered food-safety results and open it on the shared map. Optionally open its inspection-history panel.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "establishment": {
        "type": "string",
        "minLength": 1,
        "maxLength": 160
      },
      "address": {
        "type": "string",
        "maxLength": 200,
        "description": "Optional address fragment when a name is ambiguous."
      },
      "openInspections": {
        "type": "boolean",
        "default": false
      }
    },
    "required": [
      "establishment"
    ],
    "additionalProperties": false
  },
  "page": "/foodmap"
}

{
  "name": "find_map_projects",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search the PGMaps project catalog by topic and optional project type. Returns project slugs and summaries so a relevant project can be opened.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "maxLength": 160,
        "description": "Plain-language topic, place, or keyword."
      },
      "kind": {
        "type": "string",
        "enum": [
          "map-story",
          "raster-story",
          "index-preset",
          "research-pack"
        ],
        "description": "Optional project type filter."
      }
    },
    "additionalProperties": false
  },
  "page": "/projects"
}

{
  "name": "open_map_project",
  "kind": "act",
  "impl": "imperative",
  "description": "Open one PGMaps project by its catalog slug. The human and agent will see the project workspace on the current page.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "slug": {
        "type": "string",
        "maxLength": 160,
        "description": "Exact slug returned by find_map_projects."
      }
    },
    "required": [
      "slug"
    ],
    "additionalProperties": false
  },
  "page": "/projects"
}