plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "velo-index",
  "version": "1.0.0",
  "description": "Search, look up and compare manufacturer-published e-bike specifications in the EU, UK, US, Canada, Australia and New Zealand, with an interactive panel for results and comparisons.",
  "author": {
    "name": "Alexander McParland",
    "email": "inquiries@theveloindex.com",
    "url": "https://www.theveloindex.com"
  },
  "homepage": "https://www.theveloindex.com/connect",
  "license": "MIT",
  "keywords": [
    "e-bike",
    "ebike",
    "electric bike",
    "electric bicycle",
    "bike specifications",
    "bike comparison"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Velo Index",
        "shortDescription": "Compare e-bike specifications",
        "longDescription": "Velo Index helps people find and compare e-bikes by budget, market and recorded specifications, using an independent catalogue of manufacturer-published information. It covers thousands of model variants from well over a hundred brands across the EU, UK, US, Canada, Australia and New Zealand, organized into consistent fields, with numeric specifications standardized for comparison and reviewed manually before publication.\n\nAsk for bikes that fit a budget, weight, claimed range, battery size, torque, frame type, motor position or sensor type, and in the US and Canada an e-bike class. Sort by price, weight, claimed range or battery and page through every match. Look up one model's recorded specifications, including frame material, suspension, wheel size and tyres, or set two to four models side by side. Numeric specifications are standardized for comparison; descriptive specifications retain the catalogue's recorded wording. Values Velo Index has not recorded are marked as not recorded, never estimated.\n\nResults appear in an interactive panel: a carousel of matching bikes with catalogue images, a filterable explorer, and a two-bike comparison table that marks differences without declaring a winner. Each bike links to its full record on Velo Index.\n\nVelo Index publishes no rankings and accepts no payment for inclusion or placement. It earns revenue through affiliate commissions, which have no bearing on which models appear or in what order. The plugin is read-only, needs no account and reads the public Velo Index catalogue only.",
        "developerName": "Alexander McParland",
        "category": "Other",
        "capabilities": [
          "Read"
        ],
        "websiteURL": "https://www.theveloindex.com",
        "supportURL": "https://www.theveloindex.com/connect#support",
        "privacyPolicyURL": "https://www.theveloindex.com/privacy",
        "termsOfServiceURL": "https://www.theveloindex.com/terms",
        "defaultPrompt": [
          "Find e-bikes under \u20ac2,500 and under 20 kg in the EU, closest to my budget first",
          "Step-through e-bikes under \u00a32,000 with a removable battery in the UK",
          "Compare the Lectric XP4 and Aventon Aventure 3 in the US"
        ],
        "brandColor": "#1A7431",
        "brandColorDark": "#22C55E",
        "logo": "./assets/logo.png",
        "composerIcon": "./assets/icon.png"
      },
      "review": {
        "demo_recording_url": "https://drive.google.com/file/d/1v3C41AxxSnFwXdvHgMc2tlgAujREAryJ/view?usp=sharing",
        "test_cases": {
          "positive": [
            {
              "description": "P1: EU budget, weight and descending-price ordering. Start a new conversation with Velo Index enabled. Open Explore and compare after the response.",
              "prompt": "Find e-bikes in the EU costing at most \u20ac2,500 and weighing at most 20 kg. Put the ones closest to my budget first.",
              "tools_triggered": "search_bikes",
              "expected_behavior": "Use region EU, price_max 2500, weight_max_kg 20 and sort price_desc. Returned models meet both inclusive limits; unknown weights do not qualify. Preserve result order in the answer and panel. Report listed prices and claimed specifications, not live offers or independent test results. Do not require a fixed model or result count."
            },
            {
              "description": "P2: US Class 3 filtering. Start a new conversation with Velo Index enabled.",
              "prompt": "Find Class 3 e-bikes costing at most $1,500 in the US.",
              "tools_triggered": "search_bikes",
              "expected_behavior": "Use region USA, us_class 3 and price_max 1500. Each returned class includes Class 3. Explain switchable class configurations accurately where relevant; do not assert that the class establishes legality everywhere. An honest empty result is acceptable if no records match."
            },
            {
              "description": "P3: Named US lookup with additional specifications. Start a new conversation. Open Details and View on Velo Index; check the linked bike and market.",
              "prompt": "What are the recorded specifications of the Velotric Discover 2 in the US, including frame material, suspension, wheel size and tyres?",
              "tools_triggered": "get_bike",
              "expected_behavior": "Retrieve the USA Velotric Discover 2 by brand/model or its exact resolved slug. Report the four requested fields faithfully when returned; otherwise say not recorded in Velo Index. Preserve source notation and do not invent units. The card and link identify the same bike and market. Do not claim every field returned to the conversation is displayed in the panel."
            },
            {
              "description": "P4: Named comparison and panel handoff. Start a new conversation. Open Compare side by side, use Show differences only, and open Details for one bike.",
              "prompt": "Compare the Lectric XP4 and Aventon Aventure 3 in the US. Explain the main recorded differences without declaring an overall winner.",
              "tools_triggered": "compare_bikes; refresh_bike_explorer only if invoked by panel interactions",
              "expected_behavior": "Compare both named USA records or their resolved slugs without silently substituting a model or year. Describe differences using returned values without an overall winner. The comparison panel shows the same pair. If an exact name cannot be resolved, present the returned candidates for clarification instead of inventing a match."
            },
            {
              "description": "P5: UK filtering and two-turn pagination. In a new conversation send the prompt, then after its response send: \"Show me the next ten, keeping the same filters and order.\" Open Explore and compare. Production fixture check on 13 October 2026 found 57 matches; recheck before recording.",
              "prompt": "Find step-through e-bikes costing at most \u00a32,000 with a removable battery in the UK. Show me ten, cheapest first.",
              "tools_triggered": "search_bikes on each conversational page; refresh_bike_explorer only for panel interactions",
              "expected_behavior": "Use region UK, price_max 2000, form_factor Step-Through, removable_battery true, sort price_asc and max_results 10. The follow-up uses the previous next_offset and preserves all filters and ordering. No repeated records or market changes. Report exhaustion honestly. Judge pagination against tool results; the inline carousel may display fewer than ten cards. The explorer reflects the search filters."
            }
          ],
          "negative": [
            {
              "description": "N1: Unsupported local services. Start a new conversation. No Velo Index catalogue call for shop locations or live opening hours. Explain the limitation; another appropriate source or general guidance is acceptable. Do not invent or attribute live shop information to Velo Index.",
              "prompt": "Find an e-bike repair shop near central Dublin that is open right now."
            },
            {
              "description": "N2: Unsupported purchase. Start a new conversation. Velo Index must not be invoked to purchase, request card details or claim an order. Explain that this connection cannot buy bikes. This request is for a transaction, not a specification lookup.",
              "prompt": "Complete checkout for the bike already in my Lectric cart using my saved card and delivery address."
            },
            {
              "description": "N3: Unsupported private order access. Start a new conversation. Do not invoke Velo Index to retrieve an order, or invent a delivery status. Explain that tracking belongs with the retailer. AV-TEST-123 is a fictional identifier.",
              "prompt": "Track my Aventon order AV-TEST-123 and tell me when it will arrive."
            }
          ]
        },
        "commerce_description": "Velo Index helps users research physical e-bikes using its public specification catalogue. It earns affiliate commissions from some outbound referrals and recorded codes. Results link to informational Velo Index records. The plugin does not collect payment details, operate checkout, place orders or access private orders. Recorded discount information may appear with its check date and commission disclosure. Catalogue inclusion and ordering are not paid placements."
      },
      "publication": {
        "release_notes": "Initial Velo Index plugin release: read-only regional e-bike search, named-model lookup and comparison, with an interactive search panel and two-bike comparison table. Supports filtering, sorting, pagination and links to Velo Index records. Lookup and comparison return recorded frame material, suspension, wheel size and tyres where available. Packaged guidance distinguishes missing catalogue values from manufacturer publication status.",
        "countries": [
          "AT",
          "BE",
          "BG",
          "HR",
          "CY",
          "CZ",
          "DK",
          "EE",
          "FI",
          "FR",
          "DE",
          "GR",
          "HU",
          "IE",
          "IT",
          "LV",
          "LT",
          "LU",
          "MT",
          "NL",
          "PL",
          "PT",
          "RO",
          "SK",
          "SI",
          "ES",
          "SE",
          "GB",
          "US",
          "CA",
          "AU",
          "NZ"
        ]
      },
      "apps": "./.app.json"
    }
  }
}