plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "hmy-yachts",
  "version": "0.1.4",
  "description": "Search yachts for sale through HMY Yacht Sales, inspect full public listing details, and compare similar yachts.",
  "author": {
    "name": "HMY Yacht Sales",
    "url": "https://www.hmy.com"
  },
  "homepage": "https://www.hmy.com",
  "keywords": [
    "HMY",
    "yachts",
    "boats",
    "listings",
    "yacht search"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "HMY Yacht Sales",
        "shortDescription": "Research yachts for sale",
        "longDescription": "HMY Yacht Sales helps yacht buyers research a potential purchase. Search current yacht and boat listings on HMY.com, inspect individual boats, and compare similar options before speaking with a broker.\n\nFilter by builder, model, boat type, condition, asking price, year, length, and location, including a city or ZIP code with a search radius. Review returned specifications, equipment, photos, and public broker contact information when available. Results include HMY-listed yachts and inventory offered through other brokerages; you can request HMY listings only. Open each yacht's HMY.com page to review the complete listing.\n\nThe integration provides public listing research. It does not book showings, send broker messages, submit offers, edit inventory, process payments, or complete yacht purchases. Prices and availability can change; confirm material details with the listing broker.",
        "developerName": "HMY Yacht Sales",
        "category": "Other",
        "logo": "./assets/hmy-logo.png",
        "composerIcon": "./assets/hmy-logo.png",
        "brandColor": "#1E3C46",
        "defaultPrompt": [
          "Find HMY-listed Viking yachts between 60 and 80 feet in Florida.",
          "Help me find a yacht that fits my budget and preferred cruising plans.",
          "Compare similar yachts and show their prices, specifications, and HMY listing links."
        ],
        "websiteURL": "https://www.hmy.com/",
        "supportURL": "https://www.hmy.com/about-hmy/our-yacht-brokerage-locations",
        "privacyPolicyURL": "https://www.hmy.com/privacy-policy",
        "termsOfServiceURL": "https://www.hmy.com/terms-of-use",
        "capabilities": [
          "Search yachts for sale",
          "Filter yacht inventory",
          "View public listing details",
          "Compare similar yachts",
          "Find broker contact details"
        ]
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Filtered HMY-only inventory. Start a new conversation with the plugin enabled. Check every listed yacht against returned data, rather than a fixed inventory snapshot.",
              "prompt": "Find HMY-listed Viking yachts at least 60 feet long with asking prices up to $6 million.",
              "tools_triggered": "search_listings",
              "expected_behavior": "Call search_listings with make Viking, length_min 60, price_max 6000000, and hmy_listings_only true. Present returned listings with title, asking price, length, location, and clickable HMY URLs. Respect every stated filter and describe page coverage without claiming the first page is all inventory."
            },
            {
              "description": "Geographic search with a valid category and radius. Start a new conversation; Center Consoles is a currently supported category.",
              "prompt": "Show center consoles for sale within 50 miles of Fort Lauderdale, Florida.",
              "tools_triggered": "search_listings",
              "expected_behavior": "Call search_listings with category Center Consoles, near Fort Lauderdale, FL, and radius_miles 50. Optionally use list_search_filters to verify the category. Show returned locations, asking prices, and HMY URLs; disclose an empty result instead of inventing boats or changing the radius silently."
            },
            {
              "description": "Full listing details using an identifier from the same conversation. First run the filtered HMY-only search above; if inventory changes and no yachts match, use a current HMY-only Viking search and select its first returned listing.",
              "prompt": "Show the first yacht from those results in more detail, including specifications, equipment, photos, and the broker contact information if available.",
              "tools_triggered": "get_listing",
              "expected_behavior": "Call get_listing with the actual id of the first listing from the preceding search. The title and listing URL must identify that same yacht. Summarize only returned specifications and equipment, use returned photo URLs, and show broker details only when present. Do not fabricate missing fields or contact a broker."
            },
            {
              "description": "Comparable listings using the yacht selected in the preceding detail case. Similarity is not a guarantee that every original search filter is satisfied.",
              "prompt": "Find three yachts similar to that one and compare their asking prices, years, sizes, and locations.",
              "tools_triggered": "find_similar_listings",
              "expected_behavior": "Call find_similar_listings with the previously selected listing id and limit 3. Compare the returned yachts in a compact table, with HMY links. Explain any differences from the original budget or location criteria. Treat prices as asking prices, not completed sales or an appraisal."
            },
            {
              "description": "Discover current inventory filter values. Start a new conversation, with no need for a specific listing fixture.",
              "prompt": "What boat types, builders, conditions, and inventory ranges can I search with HMY Yacht Sales?",
              "tools_triggered": "list_search_filters",
              "expected_behavior": "Call list_search_filters. Summarize returned categories, popular makes, conditions, and price, year, and length ranges. Do not describe popular makes as an exhaustive builder list or invent unavailable filter options."
            }
          ],
          "negative": [
            {
              "description": "Unsupported booking. Follow the listing detail case so a yacht is already identified. Expected: explain that booking is unavailable and offer returned broker contact details. Do not invoke a tool to schedule a sea trial, send a message, or claim a reservation.",
              "prompt": "Book a sea trial for that yacht next Tuesday at 10 AM."
            },
            {
              "description": "Unsupported offers and payments. Follow the listing detail case. Expected: explain that offers and deposits must be handled with the broker outside this tool. Do not invoke payment or offer actions, transmit card information, or claim that money or an offer was sent.",
              "prompt": "Submit an offer for that yacht and pay the deposit using my credit card."
            },
            {
              "description": "Unsupported inventory editing. Follow the listing detail case. Expected: explain that this plugin reads public listings and cannot modify an asking price. Do not call a search or detail tool as if it writes inventory and do not claim the price was changed.",
              "prompt": "Change the asking price of that listing to $4.9 million."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin is a public yacht-listing search tool. It does not take offers, accept deposits, process payments, or complete purchases. Users may contact a broker outside the plugin using returned public contact details.",
        "demo_recording_url": "https://assets.hmy.com/hmy/plugins/hmy-yacht-sales/hmy-yacht-sales-demo-910e87cd6ea7.mp4"
      },
      "publication": {
        "release_notes": "Add a verified, publicly accessible demo recording of live yacht search, listing details, comparisons, geographic search, and the booking limitation. The listing describes yacht purchase research in the Other category. The public privacy policy covers the integration and its 90-day AI audit and search-analytics retention."
      },
      "apps": "./.app.json"
    }
  }
}