plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "mandarin-beach-villa",
  "version": "1.0.3",
  "description": "Check availability, see the direct price and get a pre-filled link to the villa's website for Mandarin Beach Villa, a six-bedroom private beachfront villa on Lipa Noi Beach, Koh Samui, Thailand.",
  "author": {
    "name": "Mandarin Beach Villa L.L.C-FZ",
    "email": "book@mandarinbeachvilla.com",
    "url": "https://mandarinbeachvilla.com"
  },
  "homepage": "https://mandarinbeachvilla.com/ai-booking-interface/",
  "keywords": [
    "koh samui",
    "villa",
    "beachfront",
    "family villa",
    "thailand",
    "direct booking",
    "lipa noi"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Mandarin Beach Villa",
        "shortDescription": "Koh Samui villa dates & prices",
        "longDescription": "Mandarin Beach Villa is a six-bedroom private beachfront villa for up to 16 guests on Lipa Noi Beach, Koh Samui, Thailand, offered direct by its owners.\n\nWith this plugin, ChatGPT can check whether the villa is available for your dates, find the nearest open stays of the length you want, show the direct price for your party for each of the two packages (The Residence and All-Inclusive) with what each includes and excludes and the payment options, answer questions about the estate from the villa\u2019s published facts, and give you a link to the villa\u2019s website with your dates and party filled in.\n\nIntended for families and groups planning a stay at Mandarin Beach Villa. Prices are shown in GBP for the whole villa and dates are in villa time (Asia/Bangkok). The plugin does not take payment, hold dates or make bookings. It does not quote for more than 16 guests or for stays shorter than the minimum for the dates; in those cases it explains the limit.",
        "developerName": "Mandarin Beach Villa L.L.C-FZ",
        "category": "Travel",
        "capabilities": [
          "Check availability",
          "Find open dates",
          "Direct price for both packages",
          "What each package includes",
          "Link to the villa's website"
        ],
        "websiteURL": "https://mandarinbeachvilla.com/",
        "supportURL": "https://mandarinbeachvilla.com/support/",
        "privacyPolicyURL": "https://mandarinbeachvilla.com/privacy-policy/",
        "termsOfServiceURL": "https://mandarinbeachvilla.com/terms/",
        "defaultPrompt": [
          "Is Mandarin Beach Villa available from 1 to 8 May 2027?",
          "What is the direct price of Mandarin Beach Villa for 8 adults and 4 children for a week in September 2027?",
          "What does the All-Inclusive package at Mandarin Beach Villa include?"
        ],
        "brandColor": "#26372f",
        "brandColorDark": "#c9b27a",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Check live availability for exact dates",
              "prompt": "Is Mandarin Beach Villa available from 1 to 8 May 2027?",
              "tools_triggered": "check_availability",
              "expected_behavior": "ChatGPT calls check_availability with check_in 2027-05-01 and check_out 2027-05-08 and reports what the live calendar says: available or unavailable (with the blocked dates when unavailable), whether the minimum stay is met, and the villa's own booking link. If the dates are unavailable it offers to look for the nearest open dates. It does not invent availability or a price."
            },
            {
              "description": "Exact direct price for a party and dates, both packages",
              "prompt": "What is the direct price of Mandarin Beach Villa for 8 adults and 4 children from 3 to 10 September 2027?",
              "tools_triggered": "get_direct_quote",
              "expected_behavior": "ChatGPT calls get_direct_quote with the dates, 8 adults and 4 children. If the dates are open it shows both packages, The Residence and All-Inclusive, each with its whole-villa total in GBP, the payment options, what each includes and excludes, and the booking link; the booking card renders with the two totals and a button that opens the villa's booking page. If those dates have been booked since submission, the tool reports them unavailable with the blocked dates and ChatGPT offers search_available_dates instead. Prices are never stated from memory."
            },
            {
              "description": "Find the nearest open week when the guest is flexible",
              "prompt": "Find the next available week at Mandarin Beach Villa from June 2027.",
              "tools_triggered": "search_available_dates",
              "expected_behavior": "ChatGPT calls search_available_dates with nights 7 and a window starting 2027-06-01 and lists real open 7-night stays from the live calendar, nearest first, each with its direct total for both packages. It lists only dates the tool returned."
            },
            {
              "description": "Verified facts about the estate and a package's inclusions",
              "prompt": "What does the All-Inclusive package at Mandarin Beach Villa include?",
              "tools_triggered": "get_property_details",
              "expected_behavior": "ChatGPT calls get_property_details and answers from its packages section: All-Inclusive includes exclusive use of the whole estate, all meals cooked by the private chef, drinks, the villa-owned vehicles and water-sports fleet with fuel, airport transfers, and, when booked direct, the chauffeured VIP van for outings; it names the listed exclusions (licences, outside excursions and third-party activities). No prices or availability are given by this tool."
            },
            {
              "description": "The villa's own booking link with dates, party and package filled in",
              "prompt": "Give me the link to book Mandarin Beach Villa All-Inclusive for 6 adults from 3 to 10 September 2027.",
              "tools_triggered": "get_booking_link",
              "expected_behavior": "ChatGPT calls get_booking_link with the dates, 6 adults and selected_package all_inclusive and returns a URL on mandarinbeachvilla.com/book/ with those values pre-filled. It explains that the page re-checks availability, shows the same price and continues to the villa's payment page; no payment is taken in ChatGPT."
            }
          ],
          "negative": [
            {
              "description": "Party above the villa's capacity: the plugin must not quote",
              "prompt": "Book Mandarin Beach Villa for 20 adults next March."
            },
            {
              "description": "Impossible dates: the plugin must not quote or guess",
              "prompt": "Quote Mandarin Beach Villa for 30 February 2027 to 5 March 2027."
            },
            {
              "description": "Payment or card details in chat: the plugin has no payment tool and never takes card data",
              "prompt": "Take my card number now and charge me for Mandarin Beach Villa."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "No purchase is completed in the plugin. It quotes the villa's direct price and returns the villa's own booking link; payment is taken only on mandarinbeachvilla.com (external checkout on the developer's own domain). The plugin never collects card details."
      },
      "publication": {
        "countries": [],
        "release_notes": "Initial release: availability, nearest open dates, the direct price for both packages with inclusions and payment options, estate facts, and a pre-filled link to the villa's website. 1.0.3 limits the listing text to the plugin's functions, users and limits."
      },
      "apps": "./.app.json"
    }
  }
}