plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "trulyair",
  "version": "1.0.0",
  "description": "Current US EPA Air Quality Index (AQI) and daily AQI forecasts for any place, from official monitors where available and clearly labeled model estimates elsewhere.",
  "author": {
    "name": "Yuvraj Barsara",
    "email": "support@trulyair.com",
    "url": "https://trulyair.com"
  },
  "homepage": "https://trulyair.com",
  "keywords": [
    "air quality",
    "aqi",
    "epa",
    "airnow",
    "pollution",
    "wildfire smoke",
    "forecast"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "TrulyAir",
        "shortDescription": "EPA AQI, measured or modeled",
        "longDescription": "TrulyAir computes the US EPA Air Quality Index (AQI) the way the EPA specifies: the 2024 breakpoints, NowCast averaging for current values, and the EPA's truncation and rounding rules. Where an official U.S. EPA AirNow monitor is close to the place you ask about, it uses the NowCast AQI that AirNow publishes, unchanged; elsewhere it computes the AQI from the Copernicus Atmosphere Monitoring Service (CAMS) model. Every value is labeled as measured or as a model estimate.\n\nAsk about current conditions for any place you name, or for your approximate area, and TrulyAir gives the AQI with its category, the main pollutant, the value for each pollutant, EPA health guidance, and the sensitive groups when the AQI is above 100. In ChatGPT it also shows them on a card in the EPA color for the AQI. Ask about the coming days and it gives a daily AQI forecast for up to 4 days.\n\nEvery answer says where its numbers come from. Measured values come from the nearest official monitors reported by U.S. EPA AirNow (United States, Canada, Mexico and U.S. embassies). Model values are never presented as measurements, and forecasts are model estimates. Current readings include the observation time, and every answer includes the attribution each data source requires.\n\nIt is for anyone planning time outdoors, including people in sensitive groups, during wildfire smoke, or when traveling. Place names in other languages are understood when your assistant shares your language.\n\nLimitations: outdoor air only. TrulyAir does not cover indoor air, pollen, historical data, or weather such as temperature, rain or wind. Model estimates describe an area of roughly 10 to 45 km and can differ from local conditions. Monitor data is preliminary. Only the US EPA scale is reported. Health guidance is general EPA public information, not medical advice. No account or sign-in is needed. TrulyAir is independent and is not affiliated with or endorsed by OpenAI, the U.S. EPA or AirNow.",
        "developerName": "Yuvraj Barsara",
        "category": "Data & Analytics",
        "websiteURL": "https://trulyair.com",
        "supportURL": "https://trulyair.com/support",
        "privacyPolicyURL": "https://trulyair.com/privacy",
        "termsOfServiceURL": "https://trulyair.com/terms",
        "defaultPrompt": [
          "What's the air quality in Los Angeles right now?",
          "Is it safe to go for a run in New Delhi today?",
          "Will the air be better tomorrow in Delhi?"
        ],
        "brandColor": "#0B7A3E",
        "brandColorDark": "#43C47C",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/icon.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Current AQI for a US city with nearby official monitors",
              "prompt": "What's the air quality in Los Angeles right now?",
              "tools_triggered": "get_air_quality",
              "expected_behavior": "Gives the current US EPA AQI for Los Angeles and its category. The reply or the TrulyAir card shows the main pollutant, says the values are measured by monitors (U.S. EPA AirNow), and shows the observation time and the AirNow attribution."
            },
            {
              "description": "Outdoor exercise question answered with the current AQI and EPA guidance",
              "prompt": "Is it safe to go for a run in New Delhi today?",
              "tools_triggered": "get_air_quality",
              "expected_behavior": "Uses the current AQI for New Delhi and says whether it comes from a monitor or a model estimate. Gives or paraphrases the EPA guidance for that AQI category about being active outdoors, and names the sensitive groups when the AQI is above 100. Gives no medical diagnosis."
            },
            {
              "description": "Place with no nearby monitor: a clearly labeled model estimate",
              "prompt": "How's the air in London?",
              "tools_triggered": "get_air_quality",
              "expected_behavior": "Gives the AQI for London on the US EPA scale and clearly labels it a model estimate (CAMS), not a measurement. The reply or the TrulyAir card shows the observation time and the Copernicus attribution."
            },
            {
              "description": "Comparison of today and tomorrow from the forecast",
              "prompt": "Will the air be better tomorrow in Delhi?",
              "tools_triggered": "get_air_quality_forecast",
              "expected_behavior": "Gives the forecast AQI for today and tomorrow, labeled a model forecast, and says whether tomorrow is better or worse (in ChatGPT, the TrulyAir card is shown too). Names the sensitive groups for any day with an AQI above 100."
            },
            {
              "description": "Daily forecast for the coming days",
              "prompt": "What will the air quality be in Phoenix, Arizona over the next few days?",
              "tools_triggered": "get_air_quality_forecast",
              "expected_behavior": "Gives a daily US EPA AQI forecast for Phoenix for the coming days (up to 4 days including today) with each day's category. The reply or the TrulyAir card shows each day's main pollutant, says it is a CAMS model forecast, not measurements, and shows the attribution."
            }
          ],
          "negative": [
            {
              "description": "Weather forecast request. TrulyAir covers air quality only, not temperature, rain or wind.",
              "prompt": "What's the weather in Paris tomorrow?",
              "expected_behavior": "TrulyAir tools are not called. The assistant answers with its own weather information. If the user explicitly selects TrulyAir for this message, the assistant may call the forecast tool, but the reply says TrulyAir covers air quality, not weather, and presents no AQI data as weather."
            },
            {
              "description": "Appliance maintenance question, not about outdoor air quality at a place.",
              "prompt": "How do I clean my air purifier filter?",
              "expected_behavior": "TrulyAir tools are not called. The assistant gives general filter care advice on its own or points to the purifier's manual, and presents no TrulyAir air quality data."
            },
            {
              "description": "Indoor air question. TrulyAir reports outdoor air and has no indoor or CO2 data.",
              "prompt": "My indoor monitor shows CO2 at 1,400 ppm in my office. Is that bad?",
              "expected_behavior": "TrulyAir tools are not called. The assistant answers about indoor CO2 and ventilation from its own knowledge or says it cannot assess the reading, and presents no outdoor AQI data as indoor air data."
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/o7yIqjluQ8k",
        "commerce": false
      },
      "publication": {
        "countries": [],
        "release_notes": "First public version: current US EPA AQI for any place or your approximate area, and a daily AQI forecast for up to 4 days, with measured and model values clearly labeled."
      },
      "apps": "./.app.json"
    }
  }
}