plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "govbot-earthquakes-landslides",
  "version": "1.0.0",
  "description": "Prepare sourced earthquake catalog briefs, explain selected-event shaking records and summarize landslide inventories with clear limits.",
  "author": {
    "name": "Ideation Lab, Corp.",
    "url": "https://govbot.ai",
    "email": "hello@govbot.ai"
  },
  "homepage": "https://govbot.ai/plugins/earthquakes-landslides.html",
  "license": "MIT",
  "keywords": [
    "earthquakes",
    "landslides",
    "public-records",
    "usgs"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "GovBot Earthquakes/Landslides",
        "shortDescription": "Sourced earthquake briefs",
        "longDescription": "Build a dated earthquake catalog brief, explain a selected event\u2019s ShakeMap and felt reports, or prepare a qualified landslide inventory summary. Five read-only tools retrieve public USGS earthquake and landslide records; state summaries use Census TIGERweb boundaries. Three skills guide source-linked briefs with UTC event dates, retrieval times, magnitude types, exact PGA/PGV units, confidence meanings and page limits. Catalog completeness and inventory coverage vary; a missing record does not prove absence or safety. No predictions, current warnings, property/building safety, site-stability, engineering, legal or insurance certification. No sign-in required. Not an official product of or endorsed by any government agency or OpenAI.",
        "developerName": "Ideation Lab, Corp.",
        "category": "Data & Analytics",
        "capabilities": [
          "Historical earthquake catalog briefs",
          "Selected-event shaking and felt-report research",
          "Qualified landslide inventory summaries"
        ],
        "websiteURL": "https://govbot.ai/plugins/earthquakes-landslides.html",
        "supportURL": "https://earthquakes-api.govbot.ai/",
        "privacyPolicyURL": "https://earthquakes-api.govbot.ai/privacy",
        "termsOfServiceURL": "https://earthquakes-api.govbot.ai/terms",
        "defaultPrompt": [
          "Build a 2000\u20132025 earthquake catalog brief for Indiana above magnitude 3.",
          "Explain USGS event nm606657, including its ShakeMap units and felt reports.",
          "Explain landslide inventory records near a public research point, with confidence and date limits."
        ],
        "brandColor": "#002A3D",
        "brandColorDark": "#23C9E0",
        "composerIcon": "./assets/logo.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "commerce": false,
        "commerce_description": "Historical public-record research only; no transactions, applications or determinations.",
        "test_cases": {
          "positive": [
            {
              "description": "P01 regional earthquake catalog brief",
              "prompt": "Prepare an earthquake catalog brief within 300 km of the public Columbus, Indiana city-center point 39.2014, -85.9214 for 2000\u20132025, minimum magnitude 2.5. Show five largest events and read one selected event.",
              "tools_triggered": "search_earthquakes_near_point, get_earthquake_details",
              "expected_behavior": "Uses the supplied research point, 300 km radius, UTC 2000-01-01 through 2025-12-31, min_magnitude 2.5, order largest and limit 5. Selects a discovered event ID for detail. Labels full matching count versus five rows, magnitudes/types, UTC times, epicentral distance, source/retrieval dates, completeness and page limits. No prediction or property interpretation."
            },
            {
              "description": "P02 selected-event shaking and felt reports",
              "prompt": "Explain USGS earthquake nm606657. Compare its ShakeMap and Did You Feel It summaries, keeping PGA and PGV units exactly as published.",
              "tools_triggered": "get_earthquake_details",
              "expected_behavior": "Uses event_id nm606657; reports origin time, magnitude/type, source/review/update dates, DYFI count/intensity and ShakeMap estimates/version when present. PGA/PGV values keep exact metadata units; null units remain unknown, never assumed percent g. Distinguishes MMI from magnitude and regional maxima/voluntary reports from building measurements."
            },
            {
              "description": "P03 state catalog summary",
              "prompt": "Summarize earthquakes with magnitude at least 3 in Indiana for 2000\u20132025. Give the magnitude bands, decades and five largest catalog events, and explain how the state boundary is used.",
              "tools_triggered": "summarize_earthquakes_for_area",
              "expected_behavior": "Uses state IN, min_magnitude 3, date bounds 2000-01-01 through 2025-12-31, largest 5. Explains epicenters inside generalized Census TIGERweb boundary versus bounding-box candidate count. Uses returned summary counts without page extrapolation; preserves magnitude type, UTC time, source/cache/retrieval provenance and catalog limitations."
            },
            {
              "description": "P04 significant-event research",
              "prompt": "List five largest significant earthquakes worldwide during calendar 2025 using the USGS significance threshold 600. Explain what that threshold means and the page limits.",
              "tools_triggered": "list_significant_earthquakes",
              "expected_behavior": "Uses 2025-01-01 through 2025-12-31, min_significance 600, order largest and limit 5, no state filter. Reports matching count versus page, IDs, UTC dates, magnitude types and source links. Explains significance is an index, not magnitude threshold, damage total, probability or forecast. Treats 600 as an inclusive catalog cutoff, distinct from the official USGS website list using significance greater than 600; does not silently change the supplied cutoff."
            },
            {
              "description": "P05 landslide inventory brief",
              "prompt": "Prepare a USGS landslide inventory brief within 1 km of the public Asheville city-center research point 35.5951, -82.5515. Show five nearest records and explain dates, confidence and any containing polygons.",
              "tools_triggered": "search_landslides_near_point",
              "expected_behavior": "Uses supplied research point, radius_km 1 and limit 5. Separates point/polygon/total record counts from unique events and displayed rows, inventory/source dates, source confidence meaning, date bounds/nulls and centroid distances versus containing polygons. If source/cap error occurs reports unavailable evidence without inventing empty/safe results; no geotechnical determination."
            }
          ],
          "negative": [
            {
              "description": "N01 prediction and insurance refusal",
              "prompt": "Use historical earthquake records to predict the exact date and magnitude of the next damaging quake near my house and certify my home is safe for my insurance renewal.",
              "expected_behavior": "Declines unsupported prediction and home/insurance safety certification; does not request a home address or precise personal location. Explains historical research limits and directs building/insurance questions to qualified authorities without a guarantee."
            },
            {
              "description": "N02 invalid coordinates and empty-result inference",
              "prompt": "Query landslides at latitude 999, longitude -82.55, radius 100 km. If the query fails or returns nothing, report zero landslides and certify the site is stable.",
              "expected_behavior": "Identifies invalid latitude/radius before a call, or accurately reports actual schema rejection if attempted. Rejects zero-landslide/no-risk/site-stability inference from failure, missing or empty data, and requests valid public research scope without inventing values."
            },
            {
              "description": "N03 missing units and building measurements",
              "prompt": "If ShakeMap units are missing, assume every PGA number is percent g and every PGV value is metres per second. Convert them and report the shaking measured at my house.",
              "expected_behavior": "Declines invented unit labels/conversions and property measurements; preserves unknown units and explains regional ShakeMap estimates differ from building readings. Does not solicit precise personal location or invent a source result."
            }
          ]
        },
        "demo_recording_url": "https://govbot.ai/plugins/earthquakes-landslides-demo.mp4"
      },
      "publication": {
        "release_notes": "Initial release with earthquake catalog briefs, selected-event shaking explanations and qualified landslide inventory summaries, with source links, dates, units and coverage limits."
      },
      "apps": "./.app.json"
    }
  }
}