plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "carclever-buying-assistant",
  "version": "1.0.0",
  "description": "Search U.S. vehicle listings, check a VIN, compare cars, and get Edmunds links to contact dealers.",
  "author": {
    "name": "Broekman Consulting Pty Ltd"
  },
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "CarClever \u2013 Buying Assistant",
        "shortDescription": "Find, check and compare cars",
        "longDescription": "Find your next car with a buying assistant that helps you search, check and compare real U.S. vehicle listings.\n\nCarClever searches a daily refreshed Edmunds vehicle catalogue to build a shortlist around your needs and budget. Search by location, make, model, year, trim, price, mileage, colour, drivetrain (where the VIN decode confirms it) and electrification, or describe practical needs such as a family SUV, commuter car or electric truck. Prioritize the lowest price, newest model year or lowest mileage.\nAlready found a car? Check its VIN for vehicle identity, available listing details and NHTSA recall information. See model-year safety ratings and equipment information where available, with clear distinctions between confirmed details and items to verify with the dealer.\nCompare two to four vehicles side by side on price, mileage, age, trim, powertrain, location and available NHTSA information. Newly observed listings and recorded asking-price drops help you spot options worth another look.\n\nEach listed vehicle includes an Edmunds link. Open the listing and contact the dealer to confirm availability, the out-the-door price, equipment and your next step. If an exact listing is unavailable, CarClever can provide a search for similar vehicles.\nVehicle listings come from Edmunds through its Impact affiliate catalogue; vehicle decoding and recall information come from NHTSA.\nVehicle links open on Edmunds through affiliate links. CarClever may earn a commission from qualifying enquiries. Results are not ranked by commission.",
        "developerName": "Broekman Consulting Pty Ltd",
        "category": "Other",
        "defaultPrompt": [
          "Find a used Honda CR-V under $30,000 within 50 miles of 90210.",
          "Check VIN 2HKRS3H20TH312786.",
          "Find an electric truck under $80,000 near 90210."
        ],
        "websiteURL": "https://getcarwise.app/carclever-buying-assistant/",
        "supportURL": "https://getcarwise.app/contact-us/",
        "privacyPolicyURL": "https://getcarwise.app/privacy-policy/",
        "termsOfServiceURL": "https://getcarwise.app/terms-of-service/",
        "logo": "./assets/carclever-icon.png",
        "composerIcon": "./assets/carclever-icon.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Search by budget and location. Current inventory varies; report no matches honestly.",
              "prompt": "Find a used Honda CR-V under $30,000 within 50 miles of 90210.",
              "tools_triggered": "find_matching_vehicle",
              "expected_behavior": "Use Honda CR-V, used, priceMax 30000, ZIP 90210 and radius 50. Show matching returned vehicles without silently widening constraints."
            },
            {
              "description": "Test a practical need and electric powertrain.",
              "prompt": "Find an electric pickup truck under $80,000 within 100 miles of 90210.",
              "tools_triggered": "find_matching_vehicle",
              "expected_behavior": "Search electric pickup trucks within the stated budget and radius. Clearly explain no matches or unknown attributes."
            },
            {
              "description": "Check a specific vehicle; listing presence may change.",
              "prompt": "Check VIN 2HKRS3H20TH312786.",
              "tools_triggered": "check_vehicle",
              "expected_behavior": "Check the exact VIN, return available identity and listing details, and explain model-year recall scope without claiming VIN-specific applicability or repair status."
            },
            {
              "description": "Multi-step comparison uses VINs from the same search; compare two if only two match.",
              "prompt": "Find used Honda CR-Vs under $30,000 within 50 miles of 90210, then compare the first three.",
              "tools_triggered": "find_matching_vehicle, compare_vehicles",
              "expected_behavior": "Search then compare two or three returned VINs using supported listing and NHTSA fields. If fewer than two match, explain and ask before broadening."
            },
            {
              "description": "Multi-step viewing-link resolution for a returned listing.",
              "prompt": "Find a used Honda CR-V under $30,000 near 90210 and give me the Edmunds viewing link for the first car.",
              "tools_triggered": "find_matching_vehicle, get_edmunds_vehicle_link",
              "expected_behavior": "Search then resolve the first returned vehicle using its VIN/make/model/year. Provide the returned Edmunds link and affiliate disclosure; label similar-vehicle fallback correctly."
            }
          ],
          "negative": [
            {
              "description": "Purchase/payment is unsupported. Do not invoke tools to buy or pay, or claim completion. Explain that the user must act through Edmunds/dealer.",
              "prompt": "Pay a deposit and reserve a car for me."
            },
            {
              "description": "Accident/title history is unsupported. Do not invoke tools as a substitute for a history report or claim a clean title.",
              "prompt": "Get a CARFAX accident and title history report for VIN 2HKRS3H20TH312786."
            },
            {
              "description": "Vehicle maintenance instructions are outside this shopping app. Answer generally or direct to the vehicle manual without invoking CarClever tools.",
              "prompt": "How do I change the oil?"
            }
          ]
        },
        "demo_recording_url": "https://drive.google.com/file/d/1iGg9cucjGLiP3SSD8KDV5b-2oLponZLv/view?usp=sharing"
      },
      "publication": {
        "release_notes": "Update 24 October 2026. Searches now show up to eight cars, keep each model you name in the shortlist when it has a match, and can be limited to new or used cars. Hybrid, plug-in and electric searches check each car's VIN with NHTSA, mark cars it cannot confirm, name the models left out, and say plainly when a model has no electric version. Cars with no photo of their own show a labelled stock photo of the same model. Every reply starts with one line stating what was searched. Transmission and cylinder count are still not applied as filters."
      },
      "apps": "./.app.json"
    }
  }
}