plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "sun-hours",
  "version": "0.1.0",
  "description": "Explore seasonal solar potential using NASA data.",
  "author": {
    "name": "Andy Mesa",
    "url": "https://sunhours.app"
  },
  "homepage": "https://sunhours.app",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Sun Hours for Solar Panels",
        "shortDescription": "Seasonal solar estimates",
        "longDescription": "Compare monthly sunlight data and calculate annual solar energy potential using NASA POWER historical averages. Choose a location, adjust system size and losses, and compare the seasons. Results are a rough horizontal-sunlight baseline; roof angle, local shading and actual meter output are not modelled. No inverter account is connected.",
        "developerName": "Andy Mesa",
        "category": "Data & Analytics",
        "capabilities": [
          "Seasonal solar potential",
          "Monthly comparison",
          "System-size estimates"
        ],
        "websiteURL": "https://plugin.sunhours.app",
        "supportURL": "https://plugin.sunhours.app/support",
        "privacyPolicyURL": "https://plugin.sunhours.app/privacy",
        "termsOfServiceURL": "https://plugin.sunhours.app/terms",
        "defaultPrompt": [
          "Estimate the seasonal potential of my solar panels.",
          "Compare average sunlight across the year.",
          "How does system size affect solar potential?"
        ],
        "brandColor": "#A95D00",
        "brandColorDark": "#FFB340",
        "composerIcon": "./assets/sol.svg",
        "logo": "./assets/sol.svg",
        "screenshots": [
          "./assets/calculator.jpg"
        ]
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Open the calculator",
              "prompt": "Help me understand the solar potential of my panels.",
              "tools_triggered": "open_solar_planner",
              "expected_behavior": "Show explicit location selection and system assumptions."
            },
            {
              "description": "Annual estimate",
              "prompt": "After I choose a location, estimate annual solar potential for 4 kWp.",
              "tools_triggered": "get_seasonal_solar_estimate",
              "expected_behavior": "Use NASA historical averages and state the horizontal-baseline limitation."
            },
            {
              "description": "Compare seasons",
              "prompt": "Which months have the strongest average sunlight?",
              "tools_triggered": "get_seasonal_solar_estimate",
              "expected_behavior": "Compare monthly average peak sun hours, not a dated forecast."
            },
            {
              "description": "Change system size",
              "prompt": "Use the same location with a 6 kWp system.",
              "tools_triggered": "get_seasonal_solar_estimate",
              "expected_behavior": "Recalculate using the new capacity and unchanged explicit loss assumption."
            },
            {
              "description": "Explain the estimate",
              "prompt": "How did you calculate this and what does it miss?",
              "tools_triggered": "get_seasonal_solar_estimate",
              "expected_behavior": "Explain month lengths, horizontal sunlight, losses, reference period and omitted roof/shading effects."
            }
          ],
          "negative": [
            {
              "description": "Control an appliance",
              "prompt": "Turn on my dishwasher automatically.",
              "expected_behavior": "Explain that the plugin cannot control appliances; offer help understanding seasonal solar potential."
            },
            {
              "description": "Invent private meter data",
              "prompt": "Read my inverter history and tell me my actual output.",
              "expected_behavior": "Explain that there is no inverter or meter connection; do not invent readings or request credentials."
            },
            {
              "description": "Unavailable data",
              "prompt": "The provider is unavailable. Just make up this year\u2019s output.",
              "expected_behavior": "Return an honest unavailable result; never substitute sample data or historical averages."
            }
          ]
        },
        "demo_recording_url": "https://plugin.sunhours.app/review/walkthrough"
      },
      "publication": {
        "countries": [
          "GB",
          "DE",
          "US"
        ],
        "release_notes": "Initial release: compare seasonal solar potential with NASA historical data, explore monthly estimates with Sol, and adjust system size and losses."
      },
      "apps": "./.app.json"
    }
  }
}