plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "gjirafa-travel",
  "version": "1.8.1",
  "description": "Find intercity buses across the Balkans (Kosovo, Albania, North Macedonia, Montenegro) and between the Balkans and the rest of Europe: departure times, direct routes and routes with a change, operators and prices, which days buses run, and route facts such as stations, travel time and travellers' ratings. Ask how paying, tickets, Travel Flex and refunds work. Signed in with a Gjirafa account, see and manage your own trips: cancel with the refund shown before you confirm, see until when you can cancel, fix a passenger's name, get your ticket again or add it to Apple Wallet, rate a finished trip and choose which emails you get. Tickets are bought on travel.gjirafa.com.",
  "author": {
    "name": "Gjirafa",
    "url": "https://travel.gjirafa.com"
  },
  "homepage": "https://travel.gjirafa.com",
  "keywords": [
    "bus",
    "bus tickets",
    "bus schedule",
    "bus timetable",
    "coach",
    "intercity bus",
    "travel",
    "balkans",
    "kosovo",
    "albania",
    "north macedonia",
    "montenegro",
    "prishtina",
    "tirana",
    "skopje",
    "germany",
    "switzerland",
    "austria",
    "autobus",
    "linja autobusi"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Gjirafa Travel",
        "shortDescription": "Bus routes across the Balkans",
        "longDescription": "Find intercity bus routes across the Balkans (Kosovo, Albania, North Macedonia and Montenegro) and between the Balkans and the rest of Europe, such as Austria, Germany and Switzerland.\n\nAsk in your own words, for example \"bus from Prishtina to Tirana tomorrow\". Gjirafa Travel shows departure and arrival times, travel time, direct routes and routes with a change, operators and prices, like its website does. Open the full view to see the day's buses and filter them by direct routes, time of day, price or travel time. When there is no bus on a day, it tells you when the next ones run.\n\nAsk about a route in general: \"how long is the bus from Prishtina to Munich?\", \"which companies go to Skopje?\" or \"which days is there a bus to Zurich?\". You get the buses per day, the first and last departure, usual prices and travel time, the stations with a map link and what other travellers say. If a line shown on Gjirafa Travel is wrong, you can report it to the team.\n\nAsk how Gjirafa Travel works, for example \"can I pay on the bus?\" or \"what does Premium Flex cover?\": the answers come from Gjirafa Travel's own FAQ, with the current Travel Flex hours.\n\nConnect your Gjirafa account to see and manage your own bookings: \"show my upcoming trips\", \"when does my bus to Tirana leave?\", \"until when can I cancel?\" or \"fix the spelling of my name on the ticket\". You see each trip as a boarding pass and its route as a timeline with connections and the operator's notices, with your ticket and Add to Apple Wallet. If an operator no longer runs a bus you booked, the trip is marked unavailable and you're told what to do. You can cancel with the refund shown before you confirm, correct a passenger's name, get your ticket by email again, rate a finished trip, find a bus back and choose which emails you get. A cancellation or a name change is shown first and only happens after you confirm.\n\nSearch results link to Gjirafa Travel, where you can see all routes for the day and buy your ticket. Search works in English, Albanian, German, French, Spanish and Italian.",
        "developerName": "Gjirafa",
        "category": "Travel",
        "capabilities": [
          "Search bus routes between cities and stations",
          "Compare departure times, direct routes and routes with a change, operators and prices, and filter the day's buses",
          "See which days buses run and when the next bus is",
          "Route facts: buses a day, first and last bus, usual price and travel time, stations, reviews",
          "Answer how paying, tickets, Travel Flex, refunds and open returns work, from Gjirafa Travel's FAQ",
          "Show your upcoming and past bookings as boarding passes (Gjirafa account)",
          "Show a booking's route, connections, passengers, ticket and operator notices",
          "Show until when a booking can be cancelled or changed under its Travel Flex",
          "Mark a booked bus the operator no longer runs, and say what to do",
          "Add your ticket to Apple Wallet",
          "Cancel a booking with the refund shown before you confirm",
          "Correct a passenger's name within the booking's Flex terms",
          "Send your ticket email again and rate finished trips",
          "Find buses for the way back",
          "Show your Travel Credits balance, tier and history",
          "Choose which emails Gjirafa Travel sends you, and turn off SMS",
          "Report a wrong bus line to the Gjirafa Travel team",
          "Open the bus search and your next trips in the sidebar"
        ],
        "websiteURL": "https://travel.gjirafa.com",
        "supportURL": "https://travel.gjirafa.com/en/contact",
        "privacyPolicyURL": "https://travel.gjirafa.com/en/privacy",
        "termsOfServiceURL": "https://travel.gjirafa.com/en/terms",
        "defaultPrompt": [
          "Find a bus from Prishtina to Tirana tomorrow morning.",
          "Which days is there a bus from Prishtina to Zurich?",
          "Autobus nga Shkupi n\u00eb Prishtin\u00eb sot"
        ],
        "brandColor": "#CD4D12",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png",
        "brandColorDark": "#FF7A4D"
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Direct route with an explicit date",
              "prompt": "Bus from Prishtina to Tirana tomorrow",
              "tools_triggered": "search_bus_lines",
              "expected_behavior": "A carousel of up to 8 routes with departure and arrival times, operator, a Direct tag (or the change) and price; the header shows the date and the total number of routes. \"See all\" and each card open travel.gjirafa.com/en/search-results/prishtina-to-tirana/<date>. The expand button opens the day's routes with filters for transfers and time of day and a sort by earliest, cheapest or fastest. A route that can't be booked online says so on its card. No sign-in is needed."
            },
            {
              "description": "Route facts, asked in Albanian",
              "prompt": "Sa zgjat autobusi nga Prishtina n\u00eb Mynih dhe cilat kompani shkojn\u00eb?",
              "tools_triggered": "get_route_info",
              "expected_behavior": "get_route_info is called with language \"sq\". ChatGPT answers in Albanian with the usual and fastest travel time, the buses per day, the first and last departure, the price range and the operators, and links the route page (travel.gjirafa.com/sq/bus/\u2026) and the search page where tickets are bought."
            },
            {
              "description": "Which days buses run, then the buses of the next day with any",
              "prompt": "Which days this week is there a bus from Pristina to Zurich? Show me the buses on the first of those days.",
              "tools_triggered": "get_weekly_departures, search_bus_lines",
              "expected_behavior": "get_weekly_departures lists the next 7 days with the number of buses each day (Zurich has buses only on some days, so some days show 0). search_bus_lines is then called for the first day with buses and the widget shows those routes. If ChatGPT searches a day without buses instead, the result says the next day with buses and the widget offers Show those buses."
            },
            {
              "description": "The user's own bookings (signed in with the reviewer test account)",
              "prompt": "Show my upcoming bus trips, then the details of the next one.",
              "tools_triggered": "list_my_trips, get_my_trip",
              "expected_behavior": "If the account isn't connected, ChatGPT shows the Connect button for Gjirafa (login.gjirafa.com). Once connected, the test account's upcoming trips appear as boarding-pass cards with date, times, route, booking number and passengers. The details show the route as a timeline with stations and connections, passengers, amount paid and Flex, with Ticket, Add to Apple Wallet and Manage booking; More options lists the actions the booking allows (email the ticket again, buses back, fix a passenger name, cancel)."
            },
            {
              "description": "Cancelling shows the refund first; nothing is cancelled without the user's confirmation (test account)",
              "prompt": "How much would I get back if I cancelled my next bus trip, and until when can I cancel? Don't cancel it yet.",
              "tools_triggered": "list_my_trips, preview_cancel_booking",
              "expected_behavior": "ChatGPT finds the next trip and shows the cancellation preview: the refund to the original payment method, the amount not refunded (service fee and add-ons such as Flex) and that cancelling can't be undone, with Cancel & refund and Keep booking. It says until when the booking can be cancelled under its Travel Flex. Nothing is cancelled: cancel_booking runs only after the user confirms, in ChatGPT's form (Desktop and Work web) or with the button in the widget."
            }
          ],
          "negative": [
            {
              "description": "Neither place is in the Balkans: the tool isn't called",
              "prompt": "Bus from Paris to Madrid tomorrow"
            },
            {
              "description": "General travel advice: the tool isn't called",
              "prompt": "What should I see in Tirana?"
            },
            {
              "description": "A flight, not a bus: the tools aren't called",
              "prompt": "Find me a flight from Prishtina to Zurich next Friday"
            }
          ]
        },
        "demo_recording_url": "https://w3mhh8jtzt.gjirafa.net/travel/gpt-plugin/gjirafa-travel-demo.mp4",
        "commerce": false,
        "commerce_description": "No purchase or payment happens in ChatGPT. Search results are informational and link to search result pages on travel.gjirafa.com, where users choose a departure and buy tickets. Signed-in users can manage bookings they already bought: cancel one (the refund to the original payment method is shown before they confirm), correct a passenger's name, get the ticket email again and rate a finished trip. Cancelling and name changes are previewed and need the user's confirmation; date changes happen on travel.gjirafa.com."
      },
      "publication": {
        "release_notes": "Bus search, route facts and help work without connecting a Gjirafa account; ChatGPT asks you to connect only for your own trips. Connect your Gjirafa account once and stay connected: allowing changes no longer ends the connection later. Turning on an email from Gjirafa Travel works again, dates and trip durations show in Albanian on ChatGPT web and desktop, and a booking you @-mention in the composer gives ChatGPT its details.",
        "translations": {
          "sq-AL": {
            "subtitle": "Linja autobusi n\u00eb Ballkan",
            "description": "Gjej linja autobusi nd\u00ebrqytet\u00ebse n\u00eb Ballkan (Kosov\u00eb, Shqip\u00ebri, Maqedoni t\u00eb Veriut dhe Mal t\u00eb Zi) dhe mes Ballkanit dhe pjes\u00ebs tjet\u00ebr t\u00eb Evrop\u00ebs, si Austria, Gjermania dhe Zvicra.\n\nPyet me fjal\u00ebt e tua, p\u00ebr shembull \"autobus nga Prishtina n\u00eb Tiran\u00eb nes\u00ebr\". Gjirafa Travel tregon or\u00ebt e nisjes dhe t\u00eb mb\u00ebrritjes, koh\u00ebzgjatjen, linjat direkte dhe ato me nd\u00ebrrim, operator\u00ebt dhe \u00e7mimet. N\u00eb pamjen e plot\u00eb i sheh t\u00eb gjith\u00eb autobus\u00ebt e dit\u00ebs dhe i filtron. Kur nj\u00eb dit\u00eb nuk ka autobus, t\u00eb tregon kur nisen t\u00eb ardhshmit.\n\nPyet edhe p\u00ebr linj\u00ebn n\u00eb p\u00ebrgjith\u00ebsi: \"sa zgjat autobusi p\u00ebr n\u00eb Mynih?\" ose \"cilat dit\u00eb ka autobus p\u00ebr n\u00eb Cyrih?\". Merr numrin e autobus\u00ebve n\u00eb dit\u00eb, nisjen e par\u00eb dhe t\u00eb fundit, \u00e7mimet, stacionet dhe vler\u00ebsimet e udh\u00ebtar\u00ebve.\n\nLidh llogarin\u00eb t\u00ebnde Gjirafa p\u00ebr t\u00eb par\u00eb dhe menaxhuar rezervimet e tua: mund ta anulosh nj\u00eb rezervim duke e par\u00eb rimbursimin para se ta konfirmosh, t\u00eb korrigjosh emrin e nj\u00eb pasagjeri, ta marr\u00ebsh bilet\u00ebn s\u00ebrish me email ose ta shtosh n\u00eb Apple Wallet, ta vler\u00ebsosh udh\u00ebtimin dhe t\u00eb zgjedh\u00ebsh cilat email-e merr. Anulimi dhe ndryshimi i emrave t\u00eb shfaqen m\u00eb par\u00eb dhe ndodhin vet\u00ebm pasi t'i konfirmosh. Shikon edhe deri kur mund ta anulosh rezervimin, dhe n\u00ebse operatori nuk e kryen m\u00eb nj\u00eb udh\u00ebtim t\u00ebndin, t\u00eb thuhet \u00e7far\u00eb t\u00eb b\u00ebsh.\n\nPyet edhe si funksionon Gjirafa Travel, p\u00ebr shembull \"a mund t\u00eb paguaj n\u00eb autobus?\" ose \"\u00e7far\u00eb mbulon Premium Flex?\": p\u00ebrgjigjet vijn\u00eb nga pyetjet e shpeshta t\u00eb Gjirafa Travel.\n\n\u00c7do rezultat t\u00eb \u00e7on n\u00eb Gjirafa Travel, ku i sheh t\u00eb gjitha linjat e dit\u00ebs dhe e blen bilet\u00ebn."
          },
          "de-DE": {
            "subtitle": "Busverbindungen im Balkan",
            "description": "Finde Fernbusverbindungen im Balkan (Kosovo, Albanien, Nordmazedonien und Montenegro) und zwischen dem Balkan und dem \u00fcbrigen Europa, etwa \u00d6sterreich, Deutschland und der Schweiz.\n\nFrag einfach, zum Beispiel \"Bus von Pristina nach M\u00fcnchen am Freitag\". Gjirafa Travel zeigt Abfahrts- und Ankunftszeiten, Reisedauer, Direktverbindungen und Verbindungen mit Umstieg, Busunternehmen und Preise. In der Vollansicht siehst und filterst du alle Busse des Tages. F\u00e4hrt an einem Tag kein Bus, erf\u00e4hrst du, wann die n\u00e4chsten fahren.\n\nFrag auch nach einer Strecke allgemein: \"Wie lange dauert der Bus nach M\u00fcnchen?\" oder \"An welchen Tagen f\u00e4hrt ein Bus nach Z\u00fcrich?\". Du bekommst Busse pro Tag, erste und letzte Abfahrt, \u00fcbliche Preise, Haltestellen und Bewertungen anderer Reisender.\n\nVerbinde dein Gjirafa-Konto, um deine Buchungen zu verwalten: stornieren und die Erstattung vor dem Best\u00e4tigen sehen, den Namen eines Fahrgasts korrigieren, das Ticket erneut per E-Mail bekommen oder zu Apple Wallet hinzuf\u00fcgen, eine Fahrt bewerten und w\u00e4hlen, welche E-Mails du bekommst. Stornierungen und Namens\u00e4nderungen werden zuerst angezeigt und erst nach deiner Best\u00e4tigung ausgef\u00fchrt. Du siehst auch, bis wann du stornieren kannst, und wenn ein Busunternehmen eine gebuchte Fahrt nicht mehr anbietet, erf\u00e4hrst du, was zu tun ist.\n\nFrag auch, wie Gjirafa Travel funktioniert, etwa \"Kann ich im Bus bezahlen?\" oder \"Was deckt Premium Flex ab?\": Die Antworten kommen aus den FAQ von Gjirafa Travel.\n\nJedes Ergebnis f\u00fchrt zu Gjirafa Travel, wo du alle Verbindungen des Tages siehst und dein Ticket kaufst."
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}