plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "nightsky",
  "version": "1.0.46",
  "description": "Plan observing sessions from named places with source-linked astronomy and weather evidence.",
  "keywords": [
    "astronomy",
    "stargazing",
    "planning"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "NightSky.earth",
        "developerName": "MALISETTI TANDAV KRISHNA",
        "category": "Education & Research",
        "shortDescription": "Plan your observing night",
        "longDescription": "Plan stargazing, sky-event and photography sessions from named destinations. Compare source-linked evidence, times and data gaps. Plans do not verify site access or safety.",
        "websiteURL": "https://nightsky.earth/get-started/",
        "supportURL": "https://nightsky.earth/contact/",
        "privacyPolicyURL": "https://nightsky.earth/privacy/",
        "termsOfServiceURL": "https://nightsky.earth/terms/",
        "capabilities": [],
        "composerIcon": "./assets/composer.png",
        "logo": "./assets/logo.png",
        "defaultPrompt": [
          "Plan a beginner stargazing night from a named destination.",
          "Help me prepare for a meteor shower.",
          "Compare two nights for telescope observing."
        ]
      },
      "review": {
        "demo_recording_url": "https://youtu.be/Li6HToAcLpM",
        "prompts": [
          "Plan a beginner stargazing night in Cape Town and explain the weather evidence and its gaps.",
          "Help me prepare for the next Perseids night from Cape Town without promising clear skies.",
          "Compare two evenings for observing a planet from Cape Town."
        ],
        "test_cases": {
          "positive": [
            {
              "description": "Casual named-destination session",
              "prompt": "Plan a beginner stargazing night in Cape Town tomorrow, 8\u201311 pm local time. Show darkness, Moon conditions and weather samples with their exact times and sources. Find possible observing places nearby, and tell me what you cannot verify about access or visibility.",
              "tools_triggered": "resolve_place, search_observing_locations, plan_observing_session",
              "expected_behavior": "Show local darkness and Moon, source-labeled forecast valid times and coverage gaps. Candidate coverage may be unavailable; never guarantee access, safety or darkness."
            },
            {
              "description": "Meteor shower with source gaps",
              "prompt": "Help me plan for the next Perseid meteor shower from Cape Town. State the year and the event evidence. If the date is beyond the forecast range, say so instead of predicting clear skies.",
              "tools_triggered": "resolve_place, search_sky_events, plan_observing_session",
              "expected_behavior": "Resolve the intended year, then show supported event evidence, darkness, Moon and radiant evidence where available. If the next season lacks a dated peak or forecast, label that gap rather than inventing one."
            },
            {
              "description": "Beginner visible targets and preparation",
              "prompt": "For that Cape Town session, what beginner-friendly objects could I look for? Give a direction and altitude at 10 pm for a supported target, and explain the difference between being geometrically above the horizon and actually being visible.",
              "tools_triggered": "resolve_place, get_target_visibility, plan_observing_session",
              "expected_behavior": "Reuse the selected Cape Town place when available; otherwise resolve it. Explain a supported target's calculated local position at the requested time, beginner preparation and the difference between geometric altitude and practical visibility. State source gaps and avoid visibility guarantees."
            },
            {
              "description": "First astrophotography session",
              "prompt": "I want to photograph the Milky Way core near Cape Town on 6 May 2027, from 9 pm to 3 am local time. Show its calculated direction and altitude, distinguish geometric rise from a useful photography height, and explain what weather or site conditions are still unknown.",
              "tools_triggered": "resolve_place, get_target_visibility, get_night_conditions, plan_observing_session",
              "expected_behavior": "Explain target, Moon and darkness timing and geometric versus practical altitude. Mark weather beyond the forecast horizon unavailable, ask for camera/lens before tailored settings, state seeing/transparency and site gaps, and do not promise a usable photo."
            },
            {
              "description": "Two telescope nights",
              "prompt": "Compare observing a supported planet from Cape Town tomorrow and the following evening, 8\u201311 pm local time. Keep each night's calculations and forecast samples separate, then explain which choice the evidence supports and what remains uncertain.",
              "tools_triggered": "resolve_place, compare_observing_options",
              "expected_behavior": "Resolve both local dates, keep each night and target evidence separate, and display local times, sources, availability and forecast horizon gaps. Do not turn isolated cloud samples into a clear-window claim."
            }
          ],
          "negative": [
            {
              "description": "Daytime traffic is outside NightSky",
              "prompt": "How long is the drive from Cape Town International Airport to the V&A Waterfront right now, considering current traffic?",
              "tools_triggered": "",
              "expected_behavior": "Do not invoke NightSky. Do not claim live traffic without a live source; if unavailable, label any broad travel-time guidance as an estimate."
            },
            {
              "description": "Hotel booking is outside NightSky",
              "prompt": "Book and pay for a hotel room in Cape Town tomorrow night.",
              "tools_triggered": "",
              "expected_behavior": "Do not invoke NightSky. Explain any booking or payment limitations and use an appropriate booking service only if available and authorized."
            },
            {
              "description": "Creative writing needs no sky data",
              "prompt": "Write a four-line poem about stars over Cape Town. Do not look up sky conditions or use tools.",
              "tools_triggered": "",
              "expected_behavior": "Write the poem directly without invoking NightSky or claiming current sky conditions."
            }
          ]
        },
        "commerce": false
      },
      "publication": {
        "countries": [],
        "release_notes": "Hosted NightSky plans combine named-place resolution, calculated astronomy, bounded observing-place discovery, source-labelled forecast evidence, modelled light pollution and supported sky events. Requested starter-catalogue references can use Public Universe with original-catalogue credit and coordinate-frame limits. Forecast availability and coverage vary; no plan guarantees clear skies, visibility or site access."
      },
      "apps": "./.app.json"
    }
  }
}