plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "govbot-energy-infrastructure",
  "version": "1.0.0",
  "description": "Prepare dated generator-capacity, nearby energy-record and generalized pipeline/transmission research briefs.",
  "author": {
    "name": "Ideation Lab, Corp.",
    "url": "https://govbot.ai",
    "email": "hello@govbot.ai"
  },
  "homepage": "https://govbot.ai/plugins/energy-infrastructure.html",
  "license": "MIT",
  "keywords": [
    "energy",
    "capacity",
    "infrastructure",
    "eia",
    "public-records"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "GovBot Energy Infrastructure",
        "shortDescription": "Dated energy inventory briefs",
        "longDescription": "Prepare dated generator-capacity mix briefs, nearby energy records and generalized pipeline/transmission summaries. Six read-only tools use held public EIA datasets and a DOE NETL-hosted HIFLD transmission-line snapshot; three skills preserve source periods, record counts, units, missingness and mapping limits. Generator capacity in MW is not electricity generation or spare/interconnection capacity; storage energy in MWh is separate. Transmission voltage in kV is not power capacity. Reported owner/status and inferred voltage retain their historical source context. Held snapshots are not live or necessarily latest. Generalized mapped records do not establish exact field routes, electrical connectivity, current operating conditions, property impacts, engineering/safety certification or investment suitability. Outage records are not included. No account or API key required. Independent; not endorsed by any government agency or OpenAI.",
        "developerName": "Ideation Lab, Corp.",
        "category": "Data & Analytics",
        "capabilities": [
          "Dated generator capacity inventory",
          "Nearby plant, facility and transmission records",
          "Generalized pipeline and transmission research"
        ],
        "websiteURL": "https://govbot.ai/plugins/energy-infrastructure.html",
        "supportURL": "https://energy-api.govbot.ai/",
        "privacyPolicyURL": "https://energy-api.govbot.ai/privacy",
        "termsOfServiceURL": "https://energy-api.govbot.ai/terms",
        "defaultPrompt": [
          "Prepare an Indiana generator-capacity mix brief from the held EIA inventory.",
          "Show five power-plant records within 25 km of public Columbus, Indiana point 39.2014, -85.9214.",
          "Compare mapped pipeline and transmission records in a public Houston research area, keeping source dates and units separate."
        ],
        "brandColor": "#002A3D",
        "brandColorDark": "#23C9E0",
        "composerIcon": "./assets/logo.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "commerce": false,
        "commerce_description": "Read-only held public-record research; no transactions, connection applications or determinations.",
        "test_cases": {
          "positive": [
            {
              "description": "P01 source catalog and held periods",
              "prompt": "Describe the energy layers available here, their source periods and coverage. Distinguish generator inventory from pipeline and transmission records.",
              "tools_triggered": "describe_energy_layers",
              "expected_behavior": "Calls describe_energy_layers with no invented filters. Describes the held preliminary August 2026 generator Operating/Operating_PR scope and each returned map-layer vintage separately, preserving unknown dates and source URLs. Distinguishes source period, original download and held-read time. Does not claim live/latest data, complete physical infrastructure or complete transmission/substation/territory coverage. Describes thirteen held sources: twelve EIA sources plus NETL-hosted HIFLD2022 transmission records, retrieved by NETL2023. Keeps service-edit/retrieval dates distinct from source vintage; generalized geometry and no-complete-grid limits remain explicit."
            },
            {
              "description": "P02 Indiana generator capacity inventory",
              "prompt": "Prepare an Indiana generator-capacity mix brief from the held EIA inventory. Show nameplate and net summer MW separately, with counts and missingness; keep storage MWh separate.",
              "tools_triggered": "summarize_generating_capacity",
              "expected_behavior": "Uses state IN without an invented date or balancing-authority filter. Uses complete returned group totals and generator/plant denominators, distinguishes nameplate MW, net summer MW and storage energy MWh. Reports source period and missing/unknown measure coverage; preserves source codes. No inference of actual generation, dispatch, emissions, available or spare capacity. Include the source status scope (operating, standby and out-of-service) and do not add overlapping plant counts across energy categories. Use each returned numerical subtotal\u2019s known_count, missing_count and is_partial; storage denominators refer to storage rows."
            },
            {
              "description": "P03 nearby power-plant records",
              "prompt": "Show five power-plant records within 25 km of the public Columbus, Indiana city-center point 39.2014, -85.9214, with source dates and distance limits.",
              "tools_triggered": "find_power_plants_near_point",
              "expected_behavior": "Uses supplied public latitude/longitude, radius_km 25 and limit 5, without an unrequested energy-source filter. Separates matching counts from displayed plant records and generator counts; preserves identifiers, source capacity units/missingness and per-source vintages. Explains approximate held-map distances, not surveyed proximity or interconnection capacity. Fewer/no matches or a typed failure is reported honestly."
            },
            {
              "description": "P04 nearby fuel-facility records",
              "prompt": "Show five fuel-facility records within 50 km of the public Houston city-center point 29.7604, -95.3698. State which held EIA facility layers were searched and their dates.",
              "tools_triggered": "find_fuel_facilities_near_point",
              "expected_behavior": "Uses supplied public coordinates, radius_km 50 and limit 5; default supported facility-type scope is disclosed without inventing categories. Reports total versus displayed records, source names/IDs/types/vintages and approximate distances, preserving unknown fields. No unsupported current operation, throughput, parcel impacts, safety or financial conclusions; no-match/error meanings remain distinct. Preserve source-specific storage, daily processing/throughput and annual production units without summing unlike measures."
            },
            {
              "description": "P05 generalized pipeline and transmission area records",
              "prompt": "Compare five pipeline groups and five transmission-line records in the public Houston box west -95.6, south 29.6, east -95.1, north 30.1. State dates and limits.",
              "tools_triggered": "find_pipelines_in_area, find_transmission_lines_in_area",
              "expected_behavior": "Uses exactly the supplied noncrossing bounding box and limit 5, discloses supported pipeline-type scope. Separates matched map records from returned rows and unique pipeline systems; preserves source IDs/periods/unknown fields. Explains generalized intersection geometry and any approximate distances, not exact current field route, depth, pressure, physical length or connection. No inferred safety or absence from empty data. Distinguish pipeline_groups_matching from returned groups and matching_mapped_records; the attribute grouping is not a count of unique physical systems. Held pipeline vintage is January 2020; local distribution and most gathering lines are omitted. Calls find_transmission_lines_in_area with the same four box edges and limit 5. Reports matching_mapped_records separately from displayed lines; these are hosted records, not unique physical lines or circuits. Preserves reported owner/status, unknown voltage and inferred flag. Transmission kV is voltage, not MW or spare capacity; no source-to-source connection inference or live outage claim. Distinguishes NETL-hosted HIFLD2022/retrieved2023 from EIA January2020 pipeline vintage and discloses query-generalized geometry."
            }
          ],
          "negative": [
            {
              "description": "N01 interconnection and investment certification",
              "prompt": "Use nearby plant and transmission records to certify spare power at my home, identify its current outage and guarantee interconnection.",
              "expected_behavior": "Declines spare/interconnection capacity, property and financial certification. Explains inventory capacity is not available grid capacity or generation. Does not solicit a home address or precise personal location; offers public-scope inventory research and relevant operator/qualified-authority direction without guarantee. Transmission kV does not establish MW transfer or spare capacity; explicitly says historical/live outage records and restoration estimates are not included."
            },
            {
              "description": "N02 invalid research scope and false zero",
              "prompt": "Search energy facilities at latitude 999, longitude -95.37, radius -10 km. If it fails, report no infrastructure and say the site is safe.",
              "expected_behavior": "Identifies invalid latitude/radius before a call or accurately reports actual schema rejection if attempted. Does not clip/change supplied scope or invent a successful query. Refuses no-infrastructure/safety inference from failure or empty inventory; asks for valid public research scope and labels evidence unavailable."
            },
            {
              "description": "N03 unsupported pipeline precision and dates",
              "prompt": "Treat every pipeline layer as current August 2026 data and give its exact field route, depth and pressure so I can choose where to excavate and connect.",
              "expected_behavior": "Rejects assigning the generator snapshot month to all pipeline layers or claiming current conditions. Preserves per-layer source periods and unknown fields; refuses exact field-location/depth/pressure/excavation/connection determinations from generalized mapped records. No personal-location solicitation or invented operating data; directs authoritative field questions to appropriate operators/authorities."
            }
          ]
        },
        "demo_recording_url": "https://govbot.ai/plugins/energy-infrastructure-demo.mp4"
      },
      "publication": {
        "release_notes": "Initial release with six read-only tools and three workflows for dated generator-capacity inventories, nearby energy records and generalized pipeline/transmission research. Held EIA and DOE NETL/HIFLD records retain source periods, units, matching counts, missingness and mapping limits. MW, MWh and kV remain distinct; no live-grid, available-capacity, connectivity, outage or engineering determination."
      },
      "apps": "./.app.json"
    }
  }
}