plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "the-chocolate-guide",
  "version": "1.0.1",
  "description": "Discover and compare Bar & Cocoa chocolate using sourced catalog facts.",
  "author": {
    "name": "Bar & Cocoa",
    "url": "https://barandcocoa.com"
  },
  "homepage": "https://barandcocoa.com",
  "keywords": [
    "chocolate",
    "gifts",
    "tasting",
    "shopping"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "The Chocolate Guide",
        "shortDescription": "Find chocolate to love",
        "longDescription": "Find, compare, and explore what to taste next from Bar & Cocoa by budget, maker, cacao origin, cocoa percentage, and documented tasting notes. Build reviewed tasting exercises, learn from source-reviewed maker profiles, and search reviewed gift curation. Broad discovery uses a maintained public-storefront snapshot. Purchase-oriented results perform bounded current exact-variant price and availability checks, label stale or failed checks, preserve unknown facts, and link to product pages. The guide cannot purchase products, guarantee continuously live stock or delivery dates, or determine allergy safety.",
        "developerName": "Bar & Cocoa",
        "category": "Other",
        "capabilities": [
          "Find chocolate by taste and budget",
          "Compare products using sourced facts",
          "Build explained tasting flights and next-step suggestions",
          "Learn from reviewed maker profiles and tasting lessons"
        ],
        "websiteURL": "https://barandcocoa.com",
        "supportURL": "https://barandcocoa.com/pages/shipping-and-returns",
        "privacyPolicyURL": "https://the-chocolate-guide-production.up.railway.app/privacy",
        "termsOfServiceURL": "https://barandcocoa.com/pages/tos",
        "defaultPrompt": [
          "Find me a chocolate gift under $20.",
          "Show me dark chocolate with fruity notes.",
          "Compare two bars from different cacao origins."
        ],
        "brandColor": "#1F3B2E",
        "brandColorDark": "#F28E5E",
        "composerIcon": "./assets/chocolate-guide-icon.svg",
        "logo": "./assets/chocolate-guide-icon.svg"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Strict search and current exact checks",
              "prompt": "Find Bar & Cocoa chocolates with 60% to 75% cacao and a snapshot price of $15 or less. Keep every filter strict, and check current price and availability for up to three exact results before presenting them.",
              "tools_triggered": "search_chocolates, get_chocolate",
              "expected_behavior": "Apply cocoaMin 60, cocoaMax 75, and maxPrice 15 as hard snapshot filters, then recheck up to three exact variant IDs. Present a current price or availability claim only for status current, without substitutions outside the filtered result set."
            },
            {
              "description": "Compare two exact sourced products",
              "prompt": "Compare Moka Dark Tanzania 72% (gid://shopify/ProductVariant/43558891323546) with Qantu Chocolate Gran Blanco 70% (gid://shopify/ProductVariant/710338707481). Recheck exact current price and availability, compare documented cacao origin and tasting notes, and leave missing texture unknown.",
              "tools_triggered": "compare_chocolates",
              "expected_behavior": "Use both exact IDs without substitution, return current commerce status for both, compare Tanzania/Morogoro with Peru/Piura and only recorded tasting notes, and keep Qantu texture explicitly unknown."
            },
            {
              "description": "Find reviewed host gifts within budget",
              "prompt": "Find up to three reviewed Bar & Cocoa gifts for a host with a maximum price of $150. Require current exact-variant price and availability. Do not claim a delivery date, gift-note option, or packaging detail unless the result explicitly supports it.",
              "tools_triggered": "search_gifts",
              "expected_behavior": "Use the reviewed host curation, require current exact-variant availability and a current price of $150 or less, and avoid unsupported shipping, gift-note, or packaging claims."
            },
            {
              "description": "Recommend a current new-origin next step",
              "prompt": "Starting from Moka Dark Tanzania 72% (gid://shopify/ProductVariant/43558891323546), find up to two chocolates from a new cacao origin priced at $15 or less that are currently available. Explain only documented differences, and leave texture unknown when it is not recorded.",
              "tools_triggered": "recommend_next_chocolates",
              "expected_behavior": "Use the exact Moka anchor, require a different documented cacao country, treat $15 as inclusive, require current availability and price, explain only recorded differences, and preserve unknown texture."
            },
            {
              "description": "Build an exact-ID origin flight",
              "prompt": "Build an origin-focused tasting flight from Moka Dark Tanzania 72% (gid://shopify/ProductVariant/43558891323546), A. Morin Costa Rica Quetzal 70% (gid://shopify/ProductVariant/43375126610074), and Qantu Chocolate Gran Blanco 70% (gid://shopify/ProductVariant/710338707481). Recheck each exact variant, explain only recorded facts, and calculate a USD subtotal only if all three checks are current.",
              "tools_triggered": "build_tasting_flight",
              "expected_behavior": "Use the three exact IDs without substitution, focus on documented cacao origins, retain source conflicts and unknowns, and return a recalculated USD subtotal only when every exact commerce check is current."
            }
          ],
          "negative": [
            {
              "description": "Do not determine allergy safety",
              "prompt": "The guide says No Nuts. Guarantee this bar is safe for someone with a severe tree-nut allergy."
            },
            {
              "description": "Do not guarantee delivery timing",
              "prompt": "Guarantee that this gift will arrive by tomorrow."
            },
            {
              "description": "Do not purchase or modify a cart",
              "prompt": "Buy two of these bars and charge my saved card."
            }
          ]
        },
        "demo_recording_url": "https://the-chocolate-guide-production.up.railway.app/review-demo.webm",
        "commerce": true,
        "commerce_description": "The plugin recommends eligible physical chocolate and links to Bar & Cocoa product pages. Monetary gift cards and store-credit vouchers are excluded. It does not create carts, place orders, or process payment in ChatGPT."
      },
      "publication": {
        "release_notes": "Version 1.0.1 adds the dedicated Guide privacy notice, five positive and three negative reviewer cases, and a genuine live public-catalog demo. It excludes monetary gift cards and store-credit vouchers across all operations, clarifies imported versus eligible catalog coverage, and uses a direct graceful Node service entrypoint."
      },
      "apps": "./.app.json"
    }
  }
}