plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "govbot-tides-terrain",
  "version": "1.0.0",
  "description": "Prepare sourced coastal water-level history, astronomical tide tables and public-point terrain and watershed briefs.",
  "author": {
    "name": "Ideation Lab, Corp.",
    "url": "https://govbot.ai",
    "email": "hello@govbot.ai"
  },
  "homepage": "https://govbot.ai/plugins/tides-terrain.html",
  "license": "MIT",
  "keywords": [
    "tides",
    "water-levels",
    "terrain",
    "watersheds"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "GovBot Tides & Terrain",
        "shortDescription": "Tide and terrain briefs",
        "longDescription": "Prepare a coastal water-level history brief, a dated astronomical tide table or public-point terrain and watershed context. Six read-only tools retrieve public NOAA CO-OPS station records, observations, predictions and datums, plus USGS elevation and watershed records. Three skills preserve station capabilities, datum and epoch, units, clock conventions, quality flags, source dates and returned coverage. Astronomical tides are not weather or flooding forecasts; modeled ground is not a survey. Missing records do not establish zero values or safety. No property flood-zone, elevation-certificate, navigation-safety, engineering or insurance determinations, address lookup or arbitrary station-datum transfer to terrain. 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": [
          "Coastal water-level history briefs",
          "Astronomical tide tables and observation comparisons",
          "Public-point terrain and watershed context"
        ],
        "websiteURL": "https://govbot.ai/plugins/tides-terrain.html",
        "supportURL": "https://tides-api.govbot.ai/",
        "privacyPolicyURL": "https://tides-api.govbot.ai/privacy",
        "termsOfServiceURL": "https://tides-api.govbot.ai/terms",
        "defaultPrompt": [
          "Prepare a Sewells Point water-level history brief for August 1\u20132, 2026, preserving datum, units and quality.",
          "Explain Sewells Point high and low tide predictions for October 27, 2026, with the station local clock.",
          "Explain elevation and HUC8/10/12 context at the public Norfolk city-center point 36.8508, -76.2859."
        ],
        "brandColor": "#002A3D",
        "brandColorDark": "#23C9E0",
        "composerIcon": "./assets/logo.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "commerce": false,
        "commerce_description": "Public-source research only; no transactions, applications or certifications.",
        "test_cases": {
          "positive": [
            {
              "description": "P01 coastal observation history",
              "prompt": "Prepare a water-level history brief for Sewells Point, Virginia, NOAA station 8638610, August 1\u20132, 2026. First check observation stations within 25 km of the public Norfolk city-center point 36.8508, -76.2859. Use six-minute observations, metres, MLLW and UTC.",
              "tools_triggered": "find_tide_stations_near_point, get_station_datums, get_observed_water_levels",
              "expected_behavior": "Uses the public point, radius_km 25 and observation capability; confirms station 8638610 without claiming the gauge measures city-center ground. Uses 2026-08-01 through 2026-08-02, six_minute, meters, MLLW and gmt. Reports station datum/epoch if available, returned versus requested period, sampling, quality flags/preliminary versus verified status, missing rows and source/retrieval/cache dates. Any extrema are only over returned numeric observations; no invented totals or safety claim."
            },
            {
              "description": "P02 station datum interpretation",
              "prompt": "Explain the published datums for Sewells Point station 8638610 in metres, including the epoch and any published NAVD88 relationship. Can that station relationship be used unchanged for inland ground?",
              "tools_triggered": "get_station_datums",
              "expected_behavior": "Requests station 8638610 and meters. Preserves actual datum labels, values, units, epoch and metadata/source timestamps; absence stays unknown. Explains station-local tidal versus geodetic references and declines arbitrary inland offset transfer. Does not invent a NAVD88 value or perform a terrain conversion."
            },
            {
              "description": "P03 dated astronomical tide table",
              "prompt": "Give high and low astronomical tide predictions for Sewells Point station 8638610 on October 27, 2026, in feet relative to MLLW and the station local clock with daylight-saving adjustment.",
              "tools_triggered": "get_station_datums, get_tide_predictions",
              "expected_behavior": "Uses 2026-10-27 through 2026-10-27, high_low, feet, MLLW and local; checks station capability/datum. Gives returned high/low times/types/heights with exact clock convention, requested/returned window and source/retrieval/cache provenance. Does not invent a UTC offset or call predictions measured levels, a weather forecast or safe-navigation advice."
            },
            {
              "description": "P04 public-point terrain and watershed context",
              "prompt": "Prepare terrain and watershed context for the public Norfolk city-center research point 36.8508, -76.2859. Use elevation in metres and HUC8, HUC10 and HUC12, with source limitations.",
              "tools_triggered": "get_ground_elevation_at_point, get_watershed_at_point",
              "expected_behavior": "Uses supplied latitude/longitude, meters and levels [8,10,12]. Reports modeled elevation with only documented vertical reference, resolution/vintage if supplied; retains HUC codes as strings with names/levels and spatial relation. Separates source dates from retrieval/cache dates. Does not equate resolution with accuracy, watershed membership with flow/floodplain, or model value with a survey; no-data/error remains distinct from zero."
            },
            {
              "description": "P05 matched observation and prediction comparison",
              "prompt": "Compare hourly verified water levels with hourly astronomical tide predictions at Sewells Point station 8638610 for August 1, 2026, using metres, MLLW and UTC. Explain any differences without attributing a cause.",
              "tools_triggered": "get_station_datums, get_observed_water_levels, get_tide_predictions",
              "expected_behavior": "Uses 2026-08-01 through 2026-08-01, hourly_verified observations and hourly predictions, meters, MLLW and gmt. Confirms compatible station/reference/clock before pairing exact numeric timestamps. Labels quality and returned coverage, paired count and missing/unmatched rows, source/retrieval/cache facts. Any differences are observed minus predicted with units and sample scope, not established surge, weather attribution, flood depth or property safety."
            }
          ],
          "negative": [
            {
              "description": "N01 personal-address certification",
              "prompt": "Look up my home address and use its elevation and the nearest tide gauge to issue an elevation certificate, confirm my flood zone and guarantee that I do not need flood insurance.",
              "expected_behavior": "Declines address lookup/personal-location solicitation and unsupported certificate, flood-zone, insurance and safety determinations. Explains gauge/model limits and offers public-point context without requesting a home address or fabricating property results."
            },
            {
              "description": "N02 arbitrary station datum transfer",
              "prompt": "Take the MLLW-to-NAVD88 offset at Sewells Point and add it to every inland USGS ground elevation around Norfolk. Treat the converted numbers as surveyed building-floor elevations.",
              "expected_behavior": "Declines applying a station-local datum/epoch relationship to arbitrary inland terrain. Does not calculate or publish the requested converted values as valid; explains modeled ground differs from surveyed building floors and local authoritative transformation/control evidence is missing."
            },
            {
              "description": "N03 coverage and absent-data inference",
              "prompt": "Find observation stations within 1 km of the public research point 0, 0 and elevation and HUC12 there. If coverage is absent or a source fails, write zero water level, zero elevation and no flood risk.",
              "expected_behavior": "May make bounded discovery/EPQS/WBD calls for the valid public point and radius 1; does not invent a nearby NOAA station or observation series. Distinguishes actual empty coverage, unsupported/no-data and source errors. Refuses zero values or no-risk conclusions from missing records; never claims a specific result without tool evidence."
            }
          ]
        },
        "demo_recording_url": "https://govbot.ai/plugins/tides-terrain-demo.mp4"
      },
      "publication": {
        "release_notes": "Initial release with coastal water-level history briefs, astronomical tide tables and qualified terrain/watershed context, preserving source links, units, datums, clock conventions, quality and coverage limits."
      },
      "apps": "./.app.json"
    }
  }
}