plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "terrava",
  "version": "1.0.0",
  "description": "Explore historical polities and changing borders on a living globe.",
  "author": {
    "name": "41 Shades LLC",
    "email": "updates@terrava.earth",
    "url": "https://terrava.earth"
  },
  "homepage": "https://terrava.earth",
  "keywords": [
    "history",
    "maps",
    "geography",
    "atlas"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Terrava",
        "shortDescription": "History on a living globe",
        "longDescription": "Explore 8,000+ years of empires, kingdoms, and changing borders on an interactive globe. Ask for a polity or year, follow its mapped history, read profiles and sources, or start a Living Journey.\n\nView associated artwork and living environments where available, or explore the sky. Historical maps are interpretations: coverage and evidence vary, and dates and boundaries may be approximate or revised. No sign-in is required.",
        "developerName": "41 Shades LLC",
        "category": "Education & Research",
        "capabilities": [
          "Historical maps",
          "Polity profiles",
          "Living Journeys"
        ],
        "websiteURL": "https://terrava.earth",
        "supportURL": "https://terrava.earth/privacy#support",
        "privacyPolicyURL": "https://terrava.earth/privacy#privacy",
        "termsOfServiceURL": "https://terrava.earth/privacy#terms",
        "defaultPrompt": [
          "Show Carthage.",
          "Show the world in 1500 CE.",
          "Start the Early States journey."
        ],
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/icon.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Historical territory and supporting evidence",
              "prompt": "Show the Mongol Empire in 1206 CE and explain the sources and uncertainty behind its mapped territory.",
              "tools_triggered": "show_polity, inspect_polity",
              "expected_behavior": "Open a new Mongol Empire map result at 1206 CE and retrieve its authored evidence. Summarize the returned interpretation with source links and limitations. Do not describe the boundaries as exact or treat an accepted navigation command as confirmed rendering. Search may be used to resolve the polity identity."
            },
            {
              "description": "Connected historical journey",
              "prompt": "Start the Early States journey.",
              "tools_triggered": "open_authored_journey",
              "expected_behavior": "Open the published first-states journey and begin its authored sequence, with connected polity stops and camera movement. list_authored_journeys may be used for discovery. The visible journey and timeline should agree."
            },
            {
              "description": "Polity artwork and living environment",
              "prompt": "Show the Kingdom of Mari, then open its living environment.",
              "tools_triggered": "show_polity, open_gallery",
              "expected_behavior": "Resolve and show the Kingdom of Mari, then open its available living-environment item using that polity identity and the returned canonical scene URL or connected context. The environment opens paused; opening it does not itself start passage playback. If unavailable, explain the returned limitation rather than inventing media."
            },
            {
              "description": "Constellation in the modern sky tradition",
              "prompt": "Show Orion in the modern constellation tradition.",
              "tools_triggered": "show_constellation",
              "expected_behavior": "Open a new Orion result in the modern culture with its star pattern, available artwork and details. search_sky may be used to discover the constellation ID. Preserve the app's camera animation; the user can expand the inline result into the side panel. This request does not require updating an existing map."
            },
            {
              "description": "Current lunar phase",
              "prompt": "Show the Moon in Terrava.",
              "tools_triggered": "show_sky_object",
              "expected_behavior": "Open the Moon as a new sky result with its current phase, illumination and distance from Earth. search_sky may be used to resolve the object ID. Lunar state follows the live astronomical clock, independently of the historical atlas year; the recording's phase is not a fixed expected value."
            }
          ],
          "negative": [
            {
              "description": "Unsupported atlas authoring: explain that Terrava cannot edit or publish historical data; make no changes.",
              "prompt": "Replace Carthage's published borders with a rectangle and publish the change."
            },
            {
              "description": "Unsupported purchase: explain that Terrava cannot book travel or process payments; do not claim a purchase.",
              "prompt": "Use Terrava to book a flight to Athens and charge my card."
            },
            {
              "description": "Impossible calendar date: request a valid date; if sent to show_polity, validation must reject it without changing the map or substituting another date.",
              "prompt": "Show the Roman Republic on 30 February 200 BCE."
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/cswtGZQPlnw",
        "commerce": false,
        "commerce_description": "Terrava does not sell products, book services or process payments. No sign-in is required to explore the atlas."
      },
      "publication": {
        "release_notes": "Initial Terrava plugin for ChatGPT. Explore historical polities and changing borders, read profiles and sources, and follow Living Journeys. View artwork and living environments where available, explore constellation traditions and see the Moon's current phase. Supports inline and expanded app views. No sign-in is required. Historical coverage, dates and boundaries may be approximate or revised."
      },
      "apps": "./.app.json"
    }
  }
}