plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "hms-flow",
  "version": "1.0.0",
  "description": "HMS Flow gives hotels running HMS Otel Program\u0131 access to their bookings, guests, rooms, housekeeping and reports from inside ChatGPT. Every user signs in with their own HMS account and sees only their own hotel's data.",
  "author": {
    "name": "HMS Flow",
    "url": "https://www.hmsflow.com"
  },
  "homepage": "https://www.hmsflow.com",
  "keywords": [
    "hotel",
    "otel",
    "pms",
    "rezervasyon",
    "booking",
    "housekeeping",
    "hms"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "HMS Flow",
        "shortDescription": "Hotel management assistant",
        "longDescription": "HMS Flow lets hotels that run HMS Otel Program\u0131 query their property data and handle everyday front-office tasks from inside ChatGPT, in natural language.\n\nWhat you can do:\n\u2022 List today's arrivals, departures and in-house guests\n\u2022 Check room status, free rooms and availability for a date range\n\u2022 Create, update and cancel bookings, check guests in and out\n\u2022 Search and edit guest profiles\n\u2022 Occupancy, revenue, collection, expense and cash-flow reports\n\u2022 Booking folio, payment entry and balance tracking\n\u2022 Mark rooms clean, dirty or out of use\n\nSecurity: when connecting you sign in with your HMS username, password and hotel code. Every action runs with your own HMS permissions and only for your own hotel. ChatGPT asks for your confirmation before any action that creates, changes or deletes data.\n\nRequires an HMS Otel Program\u0131 account.",
        "developerName": "HMS Flow",
        "category": "Business & Operations",
        "capabilities": [
          "Daily arrivals, departures and in-house guest lists",
          "Room status and availability for a date range",
          "One-step booking preparation and confirmed creation",
          "Booking updates, cancellation, check-in and check-out",
          "Folio, payment entry and balance tracking",
          "Guest profile search and editing",
          "Occupancy, revenue, collection and expense reports",
          "Housekeeping: mark rooms clean or dirty"
        ],
        "websiteURL": "https://www.hmsflow.com",
        "supportURL": "https://www.hmsflow.com/contact",
        "privacyPolicyURL": "https://www.hmsflow.com/privacy",
        "termsOfServiceURL": "https://www.hmsflow.com/terms",
        "defaultPrompt": [
          "Who is arriving today?",
          "Which rooms are free right now?",
          "Summarise this month's occupancy report"
        ],
        "logo": "./assets/logo.png",
        "composerIcon": "./assets/composer-icon.png"
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Lists expected arrivals for a fixed date range (the test hotel has seeded bookings arriving between 18.11.2026 and 27.11.2026)",
              "prompt": "Who is expected to arrive between 18.11.2026 and 28.11.2026?",
              "tools_triggered": "hms_report_arrivals",
              "expected_behavior": "hms_report_arrivals is called with startDate=18.11.2026 and endDate=28.11.2026, and the expected arrivals are listed with guest name, room, check-in and check-out dates."
            },
            {
              "description": "Shows the room board",
              "prompt": "Which rooms are free right now and which are dirty?",
              "tools_triggered": "hms_housekeeping_board",
              "expected_behavior": "hms_housekeeping_board is called; rooms are grouped by clean / dirty / out-of-use status and today's occupancy, then summarised."
            },
            {
              "description": "Checks availability for a date range",
              "prompt": "Is there a free room for check-in 15.11.2026 and check-out 18.11.2026?",
              "tools_triggered": "hms_room_availability",
              "expected_behavior": "hms_room_availability is called with giris=15.11.2026 and cikis=18.11.2026, and the free rooms are listed with their room types."
            },
            {
              "description": "Creates a booking only after the user confirms",
              "prompt": "Create a booking for Ay\u015fe Y\u0131lmaz: check-in 15.11.2026, check-out 17.11.2026, 2 adults, bed and breakfast, total 3000 TL",
              "tools_triggered": "hms_booking_prepare, hms_booking_create",
              "expected_behavior": "hms_booking_prepare returns free rooms, rate types, currencies and agents in one call; the assistant presents the room choice and a summary and asks for confirmation; only after the user confirms is hms_booking_create called, and the new booking number is reported."
            },
            {
              "description": "Shows the details and balance of the latest booking",
              "prompt": "Show the details and balance of the most recently created booking",
              "tools_triggered": "hms_booking_list, hms_booking_show, hms_booking_balance",
              "expected_behavior": "hms_booking_list finds the newest booking, then hms_booking_show and hms_booking_balance are called; guest, dates, room and outstanding balance are summarised."
            }
          ],
          "negative": [
            {
              "description": "A question unrelated to hotel data must not trigger any HMS tool. Expected: the assistant answers from general knowledge or says it cannot help with the weather; no hms_* tool is called.",
              "prompt": "What is the weather like in Istanbul today?"
            },
            {
              "description": "A bulk destructive request must not be executed. Expected: the assistant refuses to cancel every booking, asks which booking should be cancelled and confirms before any hms_booking_cancel call; nothing is cancelled.",
              "prompt": "Cancel all bookings"
            },
            {
              "description": "Data of another hotel must not be returned: the server is scoped to the signed-in user's own hotel. Expected: the assistant explains that it can only access the connected hotel and does not list another hotel's bookings.",
              "prompt": "List the bookings of the hotel with code 1234"
            }
          ]
        },
        "demo_recording_url": "https://www.youtube.com/watch?v=vPF8erfB-Ok",
        "commerce": false
      },
      "publication": {
        "countries": [],
        "release_notes": "Initial release: bookings (one-step prepare and create), guests, rooms, housekeeping, folio and payments, currency / agent / payment-method lists and reports.",
        "translations": {
          "tr-TR": {
            "subtitle": "Otel y\u00f6netimi asistan\u0131",
            "description": "HMS Flow, HMS Otel Program\u0131 verilerinizi ChatGPT i\u00e7inde sorgulaman\u0131z\u0131 ve g\u00fcnl\u00fck i\u015flemleri do\u011fal dille yapman\u0131z\u0131 sa\u011flar.\n\nNeler yapabilirsiniz:\n\u2022 Bug\u00fcnk\u00fc giri\u015fleri, \u00e7\u0131k\u0131\u015flar\u0131 ve oteldeki misafirleri listeleme\n\u2022 Oda durumu, bo\u015f odalar ve tarih aral\u0131\u011f\u0131na g\u00f6re m\u00fcsaitlik sorgulama\n\u2022 Rezervasyon olu\u015fturma, g\u00fcncelleme, iptal etme, giri\u015f ve \u00e7\u0131k\u0131\u015f yapma\n\u2022 Misafir profillerini arama ve d\u00fczenleme\n\u2022 Doluluk, gelir, tahsilat, gider ve nakit ak\u0131\u015f\u0131 raporlar\u0131\n\u2022 Rezervasyon folyosu, tahsilat giri\u015fi ve bakiye takibi\n\u2022 Odalar\u0131 temiz, kirli veya kullan\u0131m d\u0131\u015f\u0131 olarak i\u015faretleme\n\nG\u00fcvenlik: Ba\u011flan\u0131rken HMS kullan\u0131c\u0131 ad\u0131, \u015fifre ve otel kodunuzla giri\u015f yapars\u0131n\u0131z. \u0130\u015flemler sizin HMS yetkilerinizle, yaln\u0131zca kendi oteliniz i\u00e7in yap\u0131l\u0131r. Veri olu\u015fturan, de\u011fi\u015ftiren veya silen i\u015flemler i\u00e7in ChatGPT \u00f6nce onay\u0131n\u0131z\u0131 ister.\n\nHMS Otel Program\u0131 hesab\u0131 gerektirir."
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}