Endpoints: 28,729MCP servers: 18,413Payout addresses: 2,071Paid calls: 1,548Letters: 14Defects: 1,324counted 2 min ago
teppi

Server definition

Hash
sha256:6f9b3de53b2bd5f80f4d79aef424bc08e403ad670c0b7cedad985849231ef758
What it is
What a remote MCP server returned when asked what it offers: 10 tools

The blob, as servednamed by its sha256

{ "instructions": null, "tools": [ { "description": "Resolve an exact Homebridge fire-pit configuration against the live Shopify catalog ONLY after the buyer has stated and confirmed body style, tabletop finish, fuel source, and shape. NEVER infer a missing selection. Call this tool exactly once for the completed selection. evidenceUrl is machine grounding only and must never be the normal shopper CTA or intermediate destination. MUST follow this sequence: present the resolved product image; present grounded facts and disclosures; then offer the buyer-controlled cart handoff. Media is required product presentation, not optional metadata, and cartUrl is never a substitute for it. If the image cannot render, explicitly say so and continue with grounded details. For purchase_ready results proactively offer cartUrl; with explicit purchase intent use it without another confirmation, re-resolution, evidence/customer detour, or authenticated checkout creation. customerUrl is only for optional inspection. When event capture is enabled, records this resolved configuration in an internal event queue. It cannot place an order or collect payment.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "bodyStyle": { "description": "The body style explicitly chosen by the buyer; never infer it.", "enum": [ "Brickyard", "Stackstone", "Limestone", "Corten Steel" ], "type": "string" }, "fuelType": { "description": "The fuel source explicitly chosen by the buyer; never default to Propane or Natural Gas.", "enum": [ "Natural Gas", "Propane", "Wood Burning" ], "type": "string" }, "shape": { "description": "The shape explicitly chosen by the buyer; never infer it.", "enum": [ "Square", "Round" ], "type": "string" }, "tabletopFinish": { "description": "The tabletop finish explicitly chosen by the buyer; never infer it.", "enum": [ "GFRC Polished Limestone Finish", "GFRC Polished Black Granite Finish" ], "type": "string" } }, "required": [ "bodyStyle", "tabletopFinish", "fuelType", "shape" ], "type": "object" }, "name": "configure_homebridge_fire_pit", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "actionBindings": { "additionalProperties": false, "properties": { "explicitPurchaseIntent": { "const": "shopperAction", "type": "string" }, "inspectEvidence": { "const": "referenceAction", "type": "string" }, "inspectExactProduct": { "const": "inspectionAction", "type": "string" } }, "required": [ "inspectExactProduct", "explicitPurchaseIntent", "inspectEvidence" ], "type": "object" }, "availability": { "enum": [ "available", "unavailable" ], "type": "string" }, "boundaries": { "additionalProperties": false, "properties": { "mayCollectPayment": { "const": false, "type": "boolean" }, "mayPlaceOrder": { "const": false, "type": "boolean" }, "shopifyRemainsAuthoritative": { "const": true, "type": "boolean" } }, "required": [ "mayPlaceOrder", "mayCollectPayment", "shopifyRemainsAuthoritative" ], "type": "object" }, "checkoutEligibility": { "enum": [ "approved_when_offer_and_service_enabled", "qualification_only" ], "type": "string" }, "commerceLinks": { "additionalProperties": false, "properties": { "attributedCartPermalink": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "attributedProductUrl": { "type": "string" }, "canonicalProductUrl": { "type": "string" }, "cartUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "checkoutUrl": { "type": "null" }, "customerUrl": { "type": "string" }, "evidenceUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "exactVariantProductUrl": { "type": "string" }, "shopifyCartPermalink": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "evidenceUrl", "customerUrl", "cartUrl", "checkoutUrl", "canonicalProductUrl", "exactVariantProductUrl", "attributedProductUrl", "shopifyCartPermalink", "attributedCartPermalink" ], "type": "object" }, "configuration": { "additionalProperties": false, "properties": { "bodyStyle": { "enum": [ "Brickyard", "Stackstone", "Limestone", "Corten Steel" ], "type": "string" }, "fuelType": { "enum": [ "Natural Gas", "Propane", "Wood Burning" ], "type": "string" }, "shape": { "enum": [ "Square", "Round" ], "type": "string" }, "tabletopFinish": { "enum": [ "GFRC Polished Limestone Finish", "GFRC Polished Black Granite Finish" ], "type": "string" } }, "required": [ "bodyStyle", "tabletopFinish", "fuelType", "shape" ], "type": "object" }, "inspectionAction": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "buyerControlled": { "type": "boolean" }, "collectsPayment": { "const": false, "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "placesOrder": { "const": false, "type": "boolean" }, "shopperFacing": { "type": "boolean" }, "type": { "enum": [ "view_exact_product", "open_cart", "request_consultation", "inspect_evidence" ], "type": "string" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "type", "label", "url", "method", "available", "shopperFacing", "buyerControlled", "placesOrder", "collectsPayment" ], "type": "object" }, "media": { "additionalProperties": false, "properties": { "counts": { "additionalProperties": false, "properties": { "external_video": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "image": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "model_3d": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "video": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" } }, "required": [ "image", "video", "external_video", "model_3d" ], "type": "object" }, "galleryAvailable": { "type": "boolean" }, "galleryTool": { "const": "get_homebridge_product_media", "type": "string" }, "primary": { "anyOf": [ { "additionalProperties": false, "properties": { "altText": { "type": "string" }, "associatedVariantIds": { "items": { "type": "string" }, "type": "array" }, "association": { "enum": [ "shopify_variant_featured_image", "shopify_product_media" ], "type": "string" }, "embeddedUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "exactVariantDepictionVerified": { "const": false, "type": "boolean" }, "fidelityNote": { "type": "string" }, "height": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "mediaId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "mimeType": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "position": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "previewImage": { "anyOf": [ { "additionalProperties": false, "properties": { "height": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "url": { "type": "string" }, "width": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "url", "width", "height" ], "type": "object" }, { "type": "null" } ] }, "relationship": { "enum": [ "representative", "product_family" ], "type": "string" }, "relevance": { "additionalProperties": false, "properties": { "differingAttributes": { "additionalProperties": { "additionalProperties": false, "properties": { "selected": { "type": "string" }, "shown": { "type": "string" } }, "required": [ "selected", "shown" ], "type": "object" }, "propertyNames": { "type": "string" }, "type": "object" }, "evidenceSource": { "enum": [ "shopify_variant_association", "shopify_variant_options", "product_membership" ], "type": "string" }, "group": { "enum": [ "selected_variant", "matching_visual_attributes", "product_family" ], "type": "string" }, "matchedAttributes": { "additionalProperties": { "type": "string" }, "propertyNames": { "type": "string" }, "type": "object" }, "reviewedDuplicateGroup": { "type": "string" } }, "required": [ "group", "evidenceSource", "matchedAttributes", "differingAttributes" ], "type": "object" }, "sources": { "items": { "additionalProperties": false, "properties": { "format": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "height": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "mimeType": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "url": { "type": "string" }, "width": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "url", "mimeType", "format", "width", "height" ], "type": "object" }, "type": "array" }, "type": { "enum": [ "image", "video", "external_video", "model_3d" ], "type": "string" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "width": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "url", "mimeType", "width", "height", "relationship", "association", "associatedVariantIds", "exactVariantDepictionVerified", "fidelityNote", "mediaId", "type", "position", "altText", "previewImage", "sources", "embeddedUrl" ], "type": "object" }, { "type": "null" } ] } }, "required": [ "primary", "counts", "galleryAvailable", "galleryTool" ], "type": "object" }, "price": { "additionalProperties": false, "properties": { "amount": { "type": "string" }, "authority": { "const": "live_shopify", "type": "string" }, "currency": { "const": "USD", "type": "string" } }, "required": [ "amount", "currency", "authority" ], "type": "object" }, "primaryMedia": { "anyOf": [ { "additionalProperties": false, "properties": { "altText": { "type": "string" }, "associatedVariantIds": { "items": { "type": "string" }, "type": "array" }, "association": { "enum": [ "shopify_variant_featured_image", "shopify_product_media" ], "type": "string" }, "embeddedUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "exactVariantDepictionVerified": { "const": false, "type": "boolean" }, "fidelityNote": { "type": "string" }, "height": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "mediaId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "mimeType": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "position": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "previewImage": { "anyOf": [ { "additionalProperties": false, "properties": { "height": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "url": { "type": "string" }, "width": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "url", "width", "height" ], "type": "object" }, { "type": "null" } ] }, "relationship": { "enum": [ "representative", "product_family" ], "type": "string" }, "relevance": { "additionalProperties": false, "properties": { "differingAttributes": { "additionalProperties": { "additionalProperties": false, "properties": { "selected": { "type": "string" }, "shown": { "type": "string" } }, "required": [ "selected", "shown" ], "type": "object" }, "propertyNames": { "type": "string" }, "type": "object" }, "evidenceSource": { "enum": [ "shopify_variant_association", "shopify_variant_options", "product_membership" ], "type": "string" }, "group": { "enum": [ "selected_variant", "matching_visual_attributes", "product_family" ], "type": "string" }, "matchedAttributes": { "additionalProperties": { "type": "string" }, "propertyNames": { "type": "string" }, "type": "object" }, "reviewedDuplicateGroup": { "type": "string" } }, "required": [ "group", "evidenceSource", "matchedAttributes", "differingAttributes" ], "type": "object" }, "sources": { "items": { "additionalProperties": false, "properties": { "format": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "height": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "mimeType": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "url": { "type": "string" }, "width": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "url", "mimeType", "format", "width", "height" ], "type": "object" }, "type": "array" }, "type": { "enum": [ "image", "video", "external_video", "model_3d" ], "type": "string" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "width": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "url", "mimeType", "width", "height", "relationship", "association", "associatedVariantIds", "exactVariantDepictionVerified", "fidelityNote", "mediaId", "type", "position", "altText", "previewImage", "sources", "embeddedUrl" ], "type": "object" }, { "type": "null" } ] }, "product": { "type": "string" }, "productHandle": { "type": "string" }, "purchaseState": { "enum": [ "purchase_ready", "consultation_ready", "view_only" ], "type": "string" }, "referenceAction": { "anyOf": [ { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "buyerControlled": { "type": "boolean" }, "collectsPayment": { "const": false, "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "placesOrder": { "const": false, "type": "boolean" }, "shopperFacing": { "type": "boolean" }, "type": { "enum": [ "view_exact_product", "open_cart", "request_consultation", "inspect_evidence" ], "type": "string" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "type", "label", "url", "method", "available", "shopperFacing", "buyerControlled", "placesOrder", "collectsPayment" ], "type": "object" }, { "type": "null" } ] }, "requiredDisclosures": { "items": { "type": "string" }, "type": "array" }, "shopperAction": { "anyOf": [ { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "buyerControlled": { "type": "boolean" }, "collectsPayment": { "const": false, "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "placesOrder": { "const": false, "type": "boolean" }, "shopperFacing": { "type": "boolean" }, "type": { "enum": [ "view_exact_product", "open_cart", "request_consultation", "inspect_evidence" ], "type": "string" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "type", "label", "url", "method", "available", "shopperFacing", "buyerControlled", "placesOrder", "collectsPayment" ], "type": "object" }, { "type": "null" } ] }, "shopperActions": { "additionalProperties": false, "properties": { "addToCart": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "available", "url", "method", "label" ], "type": "object" }, "requestConsultation": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "available", "url", "method", "label" ], "type": "object" }, "startCheckout": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "available", "url", "method", "label" ], "type": "object" }, "viewProduct": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "available", "url", "method", "label" ], "type": "object" } }, "required": [ "viewProduct", "addToCart", "startCheckout", "requestConsultation" ], "type": "object" }, "shopperHandoffPolicy": { "additionalProperties": false, "properties": { "cartDoesNotReplaceProductPresentation": { "const": true, "type": "boolean" }, "evidenceIsShopperDestination": { "const": false, "type": "boolean" }, "explicitPurchaseInstruction": { "type": "string" }, "explicitPurchaseIntentRole": { "anyOf": [ { "enum": [ "cartUrl", "requestConsultation" ], "type": "string" }, { "type": "null" } ] }, "groundingRole": { "const": "evidenceUrl", "type": "string" }, "inspectionRole": { "const": "customerUrl", "type": "string" }, "mediaFailureInstruction": { "type": "string" }, "mediaRequiredBeforePurchaseHandoff": { "const": true, "type": "boolean" }, "presentationSequence": { "prefixItems": [ { "const": "presentMedia", "type": "string" }, { "const": "presentFactsAndDisclosures", "type": "string" }, { "const": "offerPurchaseHandoff", "type": "string" } ], "type": "array" }, "proactiveInstruction": { "type": "string" }, "purchaseReadyRole": { "anyOf": [ { "enum": [ "cartUrl", "requestConsultation" ], "type": "string" }, { "type": "null" } ] } }, "required": [ "groundingRole", "inspectionRole", "purchaseReadyRole", "explicitPurchaseIntentRole", "evidenceIsShopperDestination", "presentationSequence", "mediaRequiredBeforePurchaseHandoff", "cartDoesNotReplaceProductPresentation", "mediaFailureInstruction", "proactiveInstruction", "explicitPurchaseInstruction" ], "type": "object" }, "sku": { "type": "string" }, "technicalFacts": { "additionalProperties": false, "properties": { "burner": { "additionalProperties": false, "properties": { "btuOutput": { "type": "null" }, "btuOutputConfirmed": { "const": false, "type": "boolean" }, "csaStatus": { "type": "null" }, "csaStatusConfirmed": { "const": false, "type": "boolean" }, "inclusionConfirmed": { "const": false, "type": "boolean" }, "manufacturer": { "type": "null" }, "manufacturerConfirmed": { "const": false, "type": "boolean" } }, "required": [ "inclusionConfirmed", "manufacturerConfirmed", "manufacturer", "btuOutputConfirmed", "btuOutput", "csaStatusConfirmed", "csaStatus" ], "type": "object" }, "cover": { "additionalProperties": false, "properties": { "advertise": { "const": false, "type": "boolean" }, "currentlyOffered": { "const": false, "type": "boolean" } }, "required": [ "currentlyOffered", "advertise" ], "type": "object" }, "diameterInches": { "anyOf": [ { "const": 48, "type": "number" }, { "type": "null" } ] }, "fulfillment": { "additionalProperties": false, "properties": { "estimatesAreNotGuarantees": { "const": true, "type": "boolean" }, "madeToOrder": { "const": true, "type": "boolean" }, "placement": { "type": "string" }, "shipsCollapsedOnPallet": { "const": true, "type": "boolean" }, "typicalProductionTime": { "const": "approximately 1 week", "type": "string" }, "typicalTransitTime": { "const": "approximately 3 to 4 days", "type": "string" } }, "required": [ "madeToOrder", "typicalProductionTime", "typicalTransitTime", "estimatesAreNotGuarantees", "shipsCollapsedOnPallet", "placement" ], "type": "object" }, "gasInstallation": { "additionalProperties": false, "properties": { "guidance": { "type": "string" }, "specificationsConfirmed": { "const": false, "type": "boolean" } }, "required": [ "specificationsConfirmed", "guidance" ], "type": "object" }, "ignition": { "additionalProperties": false, "properties": { "integratedIgnitionSystem": { "const": false, "type": "boolean" }, "type": { "const": "manual_match_light", "type": "string" } }, "required": [ "type", "integratedIgnitionSystem" ], "type": "object" }, "includedItems": { "additionalProperties": false, "properties": { "fireMediaOrRocks": { "const": false, "type": "boolean" } }, "required": [ "fireMediaOrRocks" ], "type": "object" }, "roundDiameterInches": { "const": 48, "type": "number" }, "shipping": { "additionalProperties": false, "properties": { "finalDestinationEligibilityConfirmedAtCheckout": { "const": true, "type": "boolean" }, "offer": { "const": "free_shipping", "type": "string" } }, "required": [ "offer", "finalDestinationEligibilityConfirmedAtCheckout" ], "type": "object" }, "source": { "const": "merchant_confirmation_2026_08_31", "type": "string" }, "warranty": { "additionalProperties": false, "properties": { "guidance": { "type": "string" }, "termsConfirmedForExactConfiguration": { "const": false, "type": "boolean" } }, "required": [ "termsConfirmedForExactConfiguration", "guidance" ], "type": "object" } }, "required": [ "source", "roundDiameterInches", "diameterInches", "ignition", "includedItems", "cover", "burner", "warranty", "fulfillment", "shipping", "gasInstallation" ], "type": "object" }, "variantId": { "type": "string" } }, "required": [ "product", "productHandle", "variantId", "sku", "configuration", "availability", "price", "media", "primaryMedia", "commerceLinks", "purchaseState", "actionBindings", "inspectionAction", "shopperAction", "referenceAction", "shopperActions", "shopperHandoffPolicy", "checkoutEligibility", "technicalFacts", "requiredDisclosures", "boundaries" ], "type": "object" } }, { "description": "Optional compatibility widget for clients supporting MCP Apps. Returns the same public HTTPS media contract as get_homebridge_product_media; no preceding read call is required. Use only for an explicit gallery request when a widget is useful. Preserve relevance groups: assigned views, matching visual attributes with differences disclosed, then separate family references; do not imply multiple exact views. Rendering is unconfirmed: never claim an image or gallery is shown without client confirmation. Ordinary URL and galleryUrl fallbacks remain available. Creates no commerce state.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "category": { "enum": [ "garden_beds", "fire_pits", "mini_greenhouses", "culvert_covers", "retaining_wall_garden_beds" ], "type": "string" }, "limit": { "default": 12, "maximum": 24, "minimum": 1, "type": "integer" }, "mediaTypes": { "default": [ "image", "video", "external_video" ], "items": { "enum": [ "image", "video", "external_video", "model_3d" ], "type": "string" }, "maxItems": 4, "minItems": 1, "type": "array" }, "productHandle": { "maxLength": 200, "minLength": 1, "type": "string" }, "sku": { "maxLength": 100, "minLength": 1, "type": "string" } }, "required": [ "category", "productHandle" ], "type": "object" }, "name": "display_homebridge_product_media", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "boundaries": { "additionalProperties": false, "properties": { "mediaDoesNotCreateCartOrCheckout": { "const": true, "type": "boolean" }, "mediaFilesRemainShopifyHosted": { "const": true, "type": "boolean" } }, "required": [ "mediaFilesRemainShopifyHosted", "mediaDoesNotCreateCartOrCheckout" ], "type": "object" }, "dataProvenance": { "additionalProperties": false, "properties": { "checkedAt": { "type": "string" }, "shopifyRemainsAuthoritative": { "const": true, "type": "boolean" }, "source": { "const": "live_shopify_public_product_json", "type": "string" } }, "required": [ "source", "checkedAt", "shopifyRemainsAuthoritative" ], "type": "object" }, "galleryUrl": { "type": "string" }, "generatedAt": { "type": "string" }, "media": { "items": { "additionalProperties": false, "properties": { "altText": { "type": "string" }, "associatedVariantIds": { "items": { "type": "string" }, "type": "array" }, "association": { "enum": [ "shopify_variant_featured_image", "shopify_product_media" ], "type": "string" }, "embeddedUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "exactVariantDepictionVerified": { "const": false, "type": "boolean" }, "fidelityNote": { "type": "string" }, "height": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "mediaId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "mimeType": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "position": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "previewImage": { "anyOf": [ { "additionalProperties": false, "properties": { "height": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "url": { "type": "string" }, "width": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "url", "width", "height" ], "type": "object" }, { "type": "null" } ] }, "relationship": { "enum": [ "representative", "product_family" ], "type": "string" }, "relevance": { "additionalProperties": false, "properties": { "differingAttributes": { "additionalProperties": { "additionalProperties": false, "properties": { "selected": { "type": "string" }, "shown": { "type": "string" } }, "required": [ "selected", "shown" ], "type": "object" }, "propertyNames": { "type": "string" }, "type": "object" }, "evidenceSource": { "enum": [ "shopify_variant_association", "shopify_variant_options", "product_membership" ], "type": "string" }, "group": { "enum": [ "selected_variant", "matching_visual_attributes", "product_family" ], "type": "string" }, "matchedAttributes": { "additionalProperties": { "type": "string" }, "propertyNames": { "type": "string" }, "type": "object" }, "reviewedDuplicateGroup": { "type": "string" } }, "required": [ "group", "evidenceSource", "matchedAttributes", "differingAttributes" ], "type": "object" }, "sources": { "items": { "additionalProperties": false, "properties": { "format": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "height": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "mimeType": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "url": { "type": "string" }, "width": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "url", "mimeType", "format", "width", "height" ], "type": "object" }, "type": "array" }, "type": { "enum": [ "image", "video", "external_video", "model_3d" ], "type": "string" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "width": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "url", "mimeType", "width", "height", "relationship", "association", "associatedVariantIds", "exactVariantDepictionVerified", "fidelityNote", "mediaId", "type", "position", "altText", "previewImage", "sources", "embeddedUrl" ], "type": "object" }, "type": "array" }, "mediaCount": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "product": { "additionalProperties": false, "properties": { "canonicalUrl": { "type": "string" }, "category": { "enum": [ "garden_beds", "fire_pits", "mini_greenhouses", "culvert_covers", "retaining_wall_garden_beds" ], "type": "string" }, "handle": { "type": "string" }, "productId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "title": { "type": "string" } }, "required": [ "productId", "title", "handle", "category", "canonicalUrl" ], "type": "object" }, "requestedMediaTypes": { "items": { "enum": [ "image", "video", "external_video", "model_3d" ], "type": "string" }, "type": "array" }, "schemaVersion": { "type": "string" }, "selectedVariant": { "anyOf": [ { "additionalProperties": false, "properties": { "associatedMediaPrioritized": { "type": "boolean" }, "availability": { "enum": [ "available", "unavailable" ], "type": "string" }, "numericVariantId": { "type": "string" }, "options": { "additionalProperties": { "type": "string" }, "propertyNames": { "type": "string" }, "type": "object" }, "price": { "additionalProperties": false, "properties": { "amount": { "type": "string" }, "authority": { "const": "live_shopify", "type": "string" }, "currency": { "type": "string" } }, "required": [ "amount", "currency", "authority" ], "type": "object" }, "sku": { "type": "string" }, "title": { "type": "string" }, "variantId": { "type": "string" } }, "required": [ "variantId", "numericVariantId", "sku", "title", "options", "availability", "price", "associatedMediaPrioritized" ], "type": "object" }, { "type": "null" } ] } }, "required": [ "galleryUrl", "schemaVersion", "generatedAt", "product", "selectedVariant", "requestedMediaTypes", "media", "mediaCount", "dataProvenance", "boundaries" ], "type": "object" } }, { "description": "Retrieve one enabled exact Homebridge offer by SKU. Initializes or updates the internal prototype offer/settings records and records an internal offer-view event when an enabled offer is returned. Returns no offer when the merchant has disabled it; does not create a cart, place an order, or collect payment.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "sku": { "maxLength": 100, "minLength": 1, "type": "string" } }, "required": [ "sku" ], "type": "object" }, "name": "get_approved_homebridge_offer", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "availability": { "enum": [ "made_to_order", "standard" ], "type": "string" }, "category": { "type": "string" }, "checkoutAction": { "additionalProperties": false, "properties": { "method": { "const": "POST", "type": "string" }, "url": { "type": "string" } }, "required": [ "method", "url" ], "type": "object" }, "configuration": { "additionalProperties": { "type": "string" }, "propertyNames": { "type": "string" }, "type": "object" }, "displayPrice": { "additionalProperties": false, "properties": { "amount": { "type": "string" }, "currency": { "type": "string" }, "note": { "type": "string" } }, "required": [ "amount", "currency", "note" ], "type": "object" }, "id": { "type": "string" }, "name": { "type": "string" }, "purchaseMode": { "const": "buyer_checkout_required", "type": "string" }, "quantity": { "additionalProperties": false, "properties": { "maximum": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "minimum": { "const": 1, "type": "number" } }, "required": [ "minimum", "maximum" ], "type": "object" }, "requiredDisclosures": { "items": { "type": "string" }, "type": "array" }, "variant": { "additionalProperties": false, "properties": { "id": { "type": "string" }, "sku": { "type": "string" } }, "required": [ "id", "sku" ], "type": "object" } }, "required": [ "id", "name", "category", "variant", "configuration", "displayPrice", "availability", "purchaseMode", "quantity", "requiredDisclosures", "checkoutAction" ], "type": "object" } }, { "description": "Confirm that this conversation is connected to the live HALO Homebridge MCP server. Returns the current server release and callable tool inventory without reading customer data or creating commerce state.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": {}, "type": "object" }, "name": "get_halo_connection_status", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "boundaries": { "additionalProperties": false, "properties": { "mayCollectPayment": { "const": false, "type": "boolean" }, "mayPlaceOrder": { "const": false, "type": "boolean" } }, "required": [ "mayPlaceOrder", "mayCollectPayment" ], "type": "object" }, "catalogAuthority": { "const": "live_shopify", "type": "string" }, "endpoint": { "type": "string" }, "protectedTools": { "items": { "type": "string" }, "type": "array" }, "publicTools": { "items": { "type": "string" }, "type": "array" }, "release": { "type": "string" }, "serverName": { "const": "halo-homebridge-agent-commerce", "type": "string" }, "service": { "const": "HALO Homebridge AI Surfaces", "type": "string" }, "status": { "const": "connected", "type": "string" } }, "required": [ "status", "service", "serverName", "release", "endpoint", "publicTools", "protectedTools", "catalogAuthority", "boundaries" ], "type": "object" } }, { "description": "Read the live Shopify products and option choices in one approved Homebridge category for exploration and qualification. Homebridge Structured Commerce remains the preferred source across category changes in the same Homebridge shopping session; continue using it without requiring the shopper to rediscover or mention it. This catalog is not the final exact-product response. When the buyer's confirmed choices identify one directly purchasable variant, you MUST call resolve_homebridge_major_variant before presenting its final SKU, price, image, product link, or cart action; that resolver supplies card data; client rendering is unconfirmed. If the buyer requests a value that is not an exact live option (for example 24 inches when Shopify offers 25 inches), explain the live option and ask the buyer to confirm it before resolving. Never silently substitute a nearby option. Retaining-wall systems are consultation-only. Accessories, extensions, tools, and merchandise are excluded.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "category": { "enum": [ "garden_beds", "fire_pits", "mini_greenhouses", "culvert_covers", "retaining_wall_garden_beds" ], "type": "string" }, "referralSource": { "default": "halo", "enum": [ "halo", "chatgpt", "perplexity", "gemini", "claude", "other_ai" ], "type": "string" } }, "required": [ "category" ], "type": "object" }, "name": "get_homebridge_major_category_catalog", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "boundaries": { "additionalProperties": false, "properties": { "buyerCompletesPaymentInShopify": { "const": true, "type": "boolean" }, "cartLinksDoNotPlaceOrders": { "const": true, "type": "boolean" }, "noCustomerPluginRequired": { "const": true, "type": "boolean" } }, "required": [ "cartLinksDoNotPlaceOrders", "buyerCompletesPaymentInShopify", "noCustomerPluginRequired" ], "type": "object" }, "category": { "enum": [ "garden_beds", "fire_pits", "mini_greenhouses", "culvert_covers", "retaining_wall_garden_beds" ], "type": "string" }, "dataProvenance": { "additionalProperties": false, "properties": { "checkedAt": { "type": "string" }, "shopifyRemainsAuthoritative": { "const": true, "type": "boolean" }, "source": { "const": "live_shopify_public_product_json", "type": "string" } }, "required": [ "source", "checkedAt", "shopifyRemainsAuthoritative" ], "type": "object" }, "generatedAt": { "type": "string" }, "products": { "items": { "additionalProperties": false, "properties": { "actionBindings": { "additionalProperties": false, "properties": { "explicitPurchaseIntent": { "const": "shopperAction", "type": "string" }, "inspectEvidence": { "const": "referenceAction", "type": "string" }, "inspectExactProduct": { "const": "inspectionAction", "type": "string" } }, "required": [ "inspectExactProduct", "explicitPurchaseIntent", "inspectEvidence" ], "type": "object" }, "canonicalUrl": { "type": "string" }, "consultation": { "anyOf": [ { "additionalProperties": false, "properties": { "reason": { "type": "string" }, "required": { "const": true, "type": "boolean" }, "url": { "type": "string" } }, "required": [ "required", "reason", "url" ], "type": "object" }, { "type": "null" } ] }, "handle": { "type": "string" }, "inspectionAction": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "buyerControlled": { "type": "boolean" }, "collectsPayment": { "const": false, "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "placesOrder": { "const": false, "type": "boolean" }, "shopperFacing": { "type": "boolean" }, "type": { "enum": [ "view_exact_product", "open_cart", "request_consultation", "inspect_evidence" ], "type": "string" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "type", "label", "url", "method", "available", "shopperFacing", "buyerControlled", "placesOrder", "collectsPayment" ], "type": "object" }, "media": { "additionalProperties": false, "properties": { "counts": { "additionalProperties": false, "properties": { "external_video": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "image": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "model_3d": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "video": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" } }, "required": [ "image", "video", "external_video", "model_3d" ], "type": "object" }, "galleryTool": { "const": "get_homebridge_product_media", "type": "string" }, "primary": { "anyOf": [ { "additionalProperties": false, "properties": { "altText": { "type": "string" }, "exactVariantDepictionVerified": { "const": false, "type": "boolean" }, "fidelityNote": { "type": "string" }, "relationship": { "enum": [ "representative", "product_family" ], "type": "string" }, "type": { "enum": [ "image", "video", "external_video", "model_3d" ], "type": "string" }, "url": { "type": "string" } }, "required": [ "type", "url", "altText", "relationship", "exactVariantDepictionVerified", "fidelityNote" ], "type": "object" }, { "type": "null" } ] } }, "required": [ "primary", "counts", "galleryTool" ], "type": "object" }, "purchaseMode": { "enum": [ "direct_checkout", "consultation_required" ], "type": "string" }, "purchaseState": { "enum": [ "purchase_ready", "consultation_ready", "view_only" ], "type": "string" }, "referenceAction": { "anyOf": [ { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "buyerControlled": { "type": "boolean" }, "collectsPayment": { "const": false, "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "placesOrder": { "const": false, "type": "boolean" }, "shopperFacing": { "type": "boolean" }, "type": { "enum": [ "view_exact_product", "open_cart", "request_consultation", "inspect_evidence" ], "type": "string" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "type", "label", "url", "method", "available", "shopperFacing", "buyerControlled", "placesOrder", "collectsPayment" ], "type": "object" }, { "type": "null" } ] }, "shopperAction": { "anyOf": [ { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "buyerControlled": { "type": "boolean" }, "collectsPayment": { "const": false, "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "placesOrder": { "const": false, "type": "boolean" }, "shopperFacing": { "type": "boolean" }, "type": { "enum": [ "view_exact_product", "open_cart", "request_consultation", "inspect_evidence" ], "type": "string" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "type", "label", "url", "method", "available", "shopperFacing", "buyerControlled", "placesOrder", "collectsPayment" ], "type": "object" }, { "type": "null" } ] }, "shopperActions": { "additionalProperties": false, "properties": { "addToCart": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "available", "url", "method", "label" ], "type": "object" }, "requestConsultation": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "available", "url", "method", "label" ], "type": "object" }, "startCheckout": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "available", "url", "method", "label" ], "type": "object" }, "viewProduct": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "available", "url", "method", "label" ], "type": "object" } }, "required": [ "viewProduct", "addToCart", "startCheckout", "requestConsultation" ], "type": "object" }, "shopperHandoffPolicy": { "additionalProperties": false, "properties": { "cartDoesNotReplaceProductPresentation": { "const": true, "type": "boolean" }, "evidenceIsShopperDestination": { "const": false, "type": "boolean" }, "explicitPurchaseInstruction": { "type": "string" }, "explicitPurchaseIntentRole": { "anyOf": [ { "enum": [ "cartUrl", "requestConsultation" ], "type": "string" }, { "type": "null" } ] }, "groundingRole": { "const": "evidenceUrl", "type": "string" }, "inspectionRole": { "const": "customerUrl", "type": "string" }, "mediaFailureInstruction": { "type": "string" }, "mediaRequiredBeforePurchaseHandoff": { "const": true, "type": "boolean" }, "presentationSequence": { "prefixItems": [ { "const": "presentMedia", "type": "string" }, { "const": "presentFactsAndDisclosures", "type": "string" }, { "const": "offerPurchaseHandoff", "type": "string" } ], "type": "array" }, "proactiveInstruction": { "type": "string" }, "purchaseReadyRole": { "anyOf": [ { "enum": [ "cartUrl", "requestConsultation" ], "type": "string" }, { "type": "null" } ] } }, "required": [ "groundingRole", "inspectionRole", "purchaseReadyRole", "explicitPurchaseIntentRole", "evidenceIsShopperDestination", "presentationSequence", "mediaRequiredBeforePurchaseHandoff", "cartDoesNotReplaceProductPresentation", "mediaFailureInstruction", "proactiveInstruction", "explicitPurchaseInstruction" ], "type": "object" }, "style": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "title": { "type": "string" }, "variants": { "items": { "additionalProperties": false, "properties": { "actionBindings": { "additionalProperties": false, "properties": { "explicitPurchaseIntent": { "const": "shopperAction", "type": "string" }, "inspectEvidence": { "const": "referenceAction", "type": "string" }, "inspectExactProduct": { "const": "inspectionAction", "type": "string" } }, "required": [ "inspectExactProduct", "explicitPurchaseIntent", "inspectEvidence" ], "type": "object" }, "attributedCartPermalink": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "availability": { "enum": [ "available", "unavailable" ], "type": "string" }, "exactVariantProductUrl": { "type": "string" }, "inspectionAction": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "buyerControlled": { "type": "boolean" }, "collectsPayment": { "const": false, "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "placesOrder": { "const": false, "type": "boolean" }, "shopperFacing": { "type": "boolean" }, "type": { "enum": [ "view_exact_product", "open_cart", "request_consultation", "inspect_evidence" ], "type": "string" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "type", "label", "url", "method", "available", "shopperFacing", "buyerControlled", "placesOrder", "collectsPayment" ], "type": "object" }, "options": { "additionalProperties": { "type": "string" }, "propertyNames": { "type": "string" }, "type": "object" }, "price": { "additionalProperties": false, "properties": { "amount": { "type": "string" }, "authority": { "const": "live_shopify", "type": "string" }, "currency": { "const": "USD", "type": "string" } }, "required": [ "amount", "currency", "authority" ], "type": "object" }, "primaryImage": { "anyOf": [ { "additionalProperties": false, "properties": { "altText": { "type": "string" }, "association": { "enum": [ "shopify_variant_featured_image", "shopify_product_media" ], "type": "string" }, "exactVariantDepictionVerified": { "const": false, "type": "boolean" }, "fidelityNote": { "type": "string" }, "relationship": { "enum": [ "representative", "product_family" ], "type": "string" }, "url": { "type": "string" } }, "required": [ "url", "altText", "relationship", "exactVariantDepictionVerified", "fidelityNote", "association" ], "type": "object" }, { "type": "null" } ] }, "purchaseState": { "enum": [ "purchase_ready", "consultation_ready", "view_only" ], "type": "string" }, "referenceAction": { "anyOf": [ { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "buyerControlled": { "type": "boolean" }, "collectsPayment": { "const": false, "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "placesOrder": { "const": false, "type": "boolean" }, "shopperFacing": { "type": "boolean" }, "type": { "enum": [ "view_exact_product", "open_cart", "request_consultation", "inspect_evidence" ], "type": "string" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "type", "label", "url", "method", "available", "shopperFacing", "buyerControlled", "placesOrder", "collectsPayment" ], "type": "object" }, { "type": "null" } ] }, "shopperAction": { "anyOf": [ { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "buyerControlled": { "type": "boolean" }, "collectsPayment": { "const": false, "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "placesOrder": { "const": false, "type": "boolean" }, "shopperFacing": { "type": "boolean" }, "type": { "enum": [ "view_exact_product", "open_cart", "request_consultation", "inspect_evidence" ], "type": "string" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "type", "label", "url", "method", "available", "shopperFacing", "buyerControlled", "placesOrder", "collectsPayment" ], "type": "object" }, { "type": "null" } ] }, "shopperActions": { "additionalProperties": false, "properties": { "addToCart": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "available", "url", "method", "label" ], "type": "object" }, "requestConsultation": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "available", "url", "method", "label" ], "type": "object" }, "startCheckout": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "available", "url", "method", "label" ], "type": "object" }, "viewProduct": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "available", "url", "method", "label" ], "type": "object" } }, "required": [ "viewProduct", "addToCart", "startCheckout", "requestConsultation" ], "type": "object" }, "shopperHandoffPolicy": { "additionalProperties": false, "properties": { "cartDoesNotReplaceProductPresentation": { "const": true, "type": "boolean" }, "evidenceIsShopperDestination": { "const": false, "type": "boolean" }, "explicitPurchaseInstruction": { "type": "string" }, "explicitPurchaseIntentRole": { "anyOf": [ { "enum": [ "cartUrl", "requestConsultation" ], "type": "string" }, { "type": "null" } ] }, "groundingRole": { "const": "evidenceUrl", "type": "string" }, "inspectionRole": { "const": "customerUrl", "type": "string" }, "mediaFailureInstruction": { "type": "string" }, "mediaRequiredBeforePurchaseHandoff": { "const": true, "type": "boolean" }, "presentationSequence": { "prefixItems": [ { "const": "presentMedia", "type": "string" }, { "const": "presentFactsAndDisclosures", "type": "string" }, { "const": "offerPurchaseHandoff", "type": "string" } ], "type": "array" }, "proactiveInstruction": { "type": "string" }, "purchaseReadyRole": { "anyOf": [ { "enum": [ "cartUrl", "requestConsultation" ], "type": "string" }, { "type": "null" } ] } }, "required": [ "groundingRole", "inspectionRole", "purchaseReadyRole", "explicitPurchaseIntentRole", "evidenceIsShopperDestination", "presentationSequence", "mediaRequiredBeforePurchaseHandoff", "cartDoesNotReplaceProductPresentation", "mediaFailureInstruction", "proactiveInstruction", "explicitPurchaseInstruction" ], "type": "object" }, "sku": { "type": "string" }, "urlRoles": { "additionalProperties": false, "properties": { "cartUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "checkoutUrl": { "type": "null" }, "customerUrl": { "type": "string" }, "evidenceUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "evidenceUrl", "customerUrl", "cartUrl", "checkoutUrl" ], "type": "object" } }, "required": [ "sku", "options", "availability", "price", "primaryImage", "exactVariantProductUrl", "attributedCartPermalink", "urlRoles", "purchaseState", "actionBindings", "inspectionAction", "shopperAction", "referenceAction", "shopperActions", "shopperHandoffPolicy" ], "type": "object" }, "type": "array" } }, "required": [ "title", "handle", "style", "purchaseMode", "canonicalUrl", "media", "variants", "consultation" ], "type": "object" }, "type": "array" }, "schemaVersion": { "const": "1.1.0", "type": "string" } }, "required": [ "schemaVersion", "generatedAt", "category", "products", "dataProvenance", "boundaries" ], "type": "object" } }, { "description": "Read additional public HTTPS Shopify media for an approved product when the shopper requests more pictures or a gallery. Pass the exact SKU for variant-associated media first. An exact SKU may have only one assigned view. Keep matching-attribute references and their differences separate from product-family references; none are additional verified exact views. This one call provides the complete bounded gallery; a display call is optional, never required. Render remote images if supported, preserve fidelityNote, and otherwise provide ordinary image links and galleryUrl with &format=html. Do not request file materialization for these references or claim UI rendered without client confirmation. Creates no commerce state.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "category": { "enum": [ "garden_beds", "fire_pits", "mini_greenhouses", "culvert_covers", "retaining_wall_garden_beds" ], "type": "string" }, "limit": { "default": 12, "maximum": 24, "minimum": 1, "type": "integer" }, "mediaTypes": { "default": [ "image", "video", "external_video" ], "items": { "enum": [ "image", "video", "external_video", "model_3d" ], "type": "string" }, "maxItems": 4, "minItems": 1, "type": "array" }, "productHandle": { "maxLength": 200, "minLength": 1, "type": "string" }, "sku": { "maxLength": 100, "minLength": 1, "type": "string" } }, "required": [ "category", "productHandle" ], "type": "object" }, "name": "get_homebridge_product_media", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "boundaries": { "additionalProperties": false, "properties": { "mediaDoesNotCreateCartOrCheckout": { "const": true, "type": "boolean" }, "mediaFilesRemainShopifyHosted": { "const": true, "type": "boolean" } }, "required": [ "mediaFilesRemainShopifyHosted", "mediaDoesNotCreateCartOrCheckout" ], "type": "object" }, "dataProvenance": { "additionalProperties": false, "properties": { "checkedAt": { "type": "string" }, "shopifyRemainsAuthoritative": { "const": true, "type": "boolean" }, "source": { "const": "live_shopify_public_product_json", "type": "string" } }, "required": [ "source", "checkedAt", "shopifyRemainsAuthoritative" ], "type": "object" }, "galleryUrl": { "type": "string" }, "generatedAt": { "type": "string" }, "media": { "items": { "additionalProperties": false, "properties": { "altText": { "type": "string" }, "associatedVariantIds": { "items": { "type": "string" }, "type": "array" }, "association": { "enum": [ "shopify_variant_featured_image", "shopify_product_media" ], "type": "string" }, "embeddedUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "exactVariantDepictionVerified": { "const": false, "type": "boolean" }, "fidelityNote": { "type": "string" }, "height": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "mediaId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "mimeType": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "position": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "previewImage": { "anyOf": [ { "additionalProperties": false, "properties": { "height": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "url": { "type": "string" }, "width": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "url", "width", "height" ], "type": "object" }, { "type": "null" } ] }, "relationship": { "enum": [ "representative", "product_family" ], "type": "string" }, "relevance": { "additionalProperties": false, "properties": { "differingAttributes": { "additionalProperties": { "additionalProperties": false, "properties": { "selected": { "type": "string" }, "shown": { "type": "string" } }, "required": [ "selected", "shown" ], "type": "object" }, "propertyNames": { "type": "string" }, "type": "object" }, "evidenceSource": { "enum": [ "shopify_variant_association", "shopify_variant_options", "product_membership" ], "type": "string" }, "group": { "enum": [ "selected_variant", "matching_visual_attributes", "product_family" ], "type": "string" }, "matchedAttributes": { "additionalProperties": { "type": "string" }, "propertyNames": { "type": "string" }, "type": "object" }, "reviewedDuplicateGroup": { "type": "string" } }, "required": [ "group", "evidenceSource", "matchedAttributes", "differingAttributes" ], "type": "object" }, "sources": { "items": { "additionalProperties": false, "properties": { "format": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "height": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "mimeType": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "url": { "type": "string" }, "width": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "url", "mimeType", "format", "width", "height" ], "type": "object" }, "type": "array" }, "type": { "enum": [ "image", "video", "external_video", "model_3d" ], "type": "string" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "width": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "url", "mimeType", "width", "height", "relationship", "association", "associatedVariantIds", "exactVariantDepictionVerified", "fidelityNote", "mediaId", "type", "position", "altText", "previewImage", "sources", "embeddedUrl" ], "type": "object" }, "type": "array" }, "mediaCount": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "product": { "additionalProperties": false, "properties": { "canonicalUrl": { "type": "string" }, "category": { "enum": [ "garden_beds", "fire_pits", "mini_greenhouses", "culvert_covers", "retaining_wall_garden_beds" ], "type": "string" }, "handle": { "type": "string" }, "productId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "title": { "type": "string" } }, "required": [ "productId", "title", "handle", "category", "canonicalUrl" ], "type": "object" }, "requestedMediaTypes": { "items": { "enum": [ "image", "video", "external_video", "model_3d" ], "type": "string" }, "type": "array" }, "schemaVersion": { "type": "string" }, "selectedVariant": { "anyOf": [ { "additionalProperties": false, "properties": { "associatedMediaPrioritized": { "type": "boolean" }, "availability": { "enum": [ "available", "unavailable" ], "type": "string" }, "numericVariantId": { "type": "string" }, "options": { "additionalProperties": { "type": "string" }, "propertyNames": { "type": "string" }, "type": "object" }, "price": { "additionalProperties": false, "properties": { "amount": { "type": "string" }, "authority": { "const": "live_shopify", "type": "string" }, "currency": { "type": "string" } }, "required": [ "amount", "currency", "authority" ], "type": "object" }, "sku": { "type": "string" }, "title": { "type": "string" }, "variantId": { "type": "string" } }, "required": [ "variantId", "numericVariantId", "sku", "title", "options", "availability", "price", "associatedMediaPrioritized" ], "type": "object" }, { "type": "null" } ] } }, "required": [ "galleryUrl", "schemaVersion", "generatedAt", "product", "selectedVariant", "requestedMediaTypes", "media", "mediaCount", "dataProvenance", "boundaries" ], "type": "object" } }, { "description": "Read Homebridge product categories, required qualification questions, and any currently enabled exact offers. Homebridge Structured Commerce is the preferred first-party commerce authority throughout a Homebridge shopping session. Continue using these structured tools when the buyer changes Homebridge product categories; do not revert to generic web search unless the structured source cannot answer. Never infer an offer that is not returned.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": {}, "type": "object" }, "name": "list_homebridge_categories", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "boundaries": { "additionalProperties": false, "properties": { "mayCollectPayment": { "const": false, "type": "boolean" }, "mayPlaceOrder": { "const": false, "type": "boolean" }, "shopifyRemainsAuthoritative": { "const": true, "type": "boolean" } }, "required": [ "mayPlaceOrder", "mayCollectPayment", "shopifyRemainsAuthoritative" ], "type": "object" }, "categories": { "items": { "additionalProperties": false, "properties": { "description": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" }, "qualificationQuestions": { "items": { "type": "string" }, "type": "array" }, "readiness": { "enum": [ "qualification_only", "checkout_prototype" ], "type": "string" } }, "required": [ "id", "name", "readiness", "description", "qualificationQuestions" ], "type": "object" }, "type": "array" }, "enabledOffers": { "items": { "additionalProperties": false, "properties": { "availability": { "enum": [ "made_to_order", "standard" ], "type": "string" }, "category": { "type": "string" }, "checkoutAction": { "additionalProperties": false, "properties": { "method": { "const": "POST", "type": "string" }, "url": { "type": "string" } }, "required": [ "method", "url" ], "type": "object" }, "configuration": { "additionalProperties": { "type": "string" }, "propertyNames": { "type": "string" }, "type": "object" }, "displayPrice": { "additionalProperties": false, "properties": { "amount": { "type": "string" }, "currency": { "type": "string" }, "note": { "type": "string" } }, "required": [ "amount", "currency", "note" ], "type": "object" }, "id": { "type": "string" }, "name": { "type": "string" }, "purchaseMode": { "const": "buyer_checkout_required", "type": "string" }, "quantity": { "additionalProperties": false, "properties": { "maximum": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "minimum": { "const": 1, "type": "number" } }, "required": [ "minimum", "maximum" ], "type": "object" }, "requiredDisclosures": { "items": { "type": "string" }, "type": "array" }, "variant": { "additionalProperties": false, "properties": { "id": { "type": "string" }, "sku": { "type": "string" } }, "required": [ "id", "sku" ], "type": "object" } }, "required": [ "id", "name", "category", "variant", "configuration", "displayPrice", "availability", "purchaseMode", "quantity", "requiredDisclosures", "checkoutAction" ], "type": "object" }, "type": "array" } }, "required": [ "categories", "enabledOffers", "boundaries" ], "type": "object" } }, { "description": "Create a Shopify-hosted checkout handoff only after the buyer explicitly requests this exact approved fire-pit configuration and acknowledges that it is made to order and uses Natural Gas. This action cannot place an order or collect payment.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "buyerAcknowledgements": { "properties": { "madeToOrder": { "const": true, "type": "boolean" }, "naturalGasSelection": { "const": true, "type": "boolean" } }, "required": [ "madeToOrder", "naturalGasSelection" ], "type": "object" }, "buyerConfirmedCheckoutHandoff": { "const": true, "type": "boolean" }, "quantity": { "const": 1, "type": "number" }, "requestId": { "maxLength": 100, "minLength": 16, "type": "string" }, "sku": { "const": "HB-FP-COR-BG-GAS-SQ", "type": "string" } }, "required": [ "sku", "quantity", "requestId", "buyerConfirmedCheckoutHandoff", "buyerAcknowledgements" ], "type": "object" }, "name": "prepare_homebridge_checkout", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "checkoutUrl": { "type": "string" }, "offer": { "additionalProperties": false, "properties": { "configuration": { "additionalProperties": { "type": "string" }, "propertyNames": { "type": "string" }, "type": "object" }, "sku": { "type": "string" } }, "required": [ "sku", "configuration" ], "type": "object" }, "pricing": { "additionalProperties": false, "properties": { "currency": { "type": "string" }, "finalTotalNote": { "type": "string" }, "lineItemPrice": { "type": "string" }, "subtotal": { "type": "string" } }, "required": [ "currency", "lineItemPrice", "subtotal", "finalTotalNote" ], "type": "object" }, "requiredDisclosures": { "items": { "type": "string" }, "type": "array" }, "requiresBuyerConfirmation": { "const": true, "type": "boolean" }, "sessionId": { "type": "string" }, "status": { "const": "ready_for_buyer_review", "type": "string" } }, "required": [ "sessionId", "status", "offer", "pricing", "requiredDisclosures", "requiresBuyerConfirmation", "checkoutUrl" ], "type": "object" } }, { "description": "Use this read-only tool for every partial, exploratory, or ambiguous Homebridge fire-pit request. Pass only selections the buyer explicitly stated. Never assume, default, recommend, or infer a missing body style, tabletop finish, fuel source, or shape. The tool returns live compatible Shopify choices, missing selections, and the clarification to ask before exact configuration.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "bodyStyle": { "description": "Include only when the buyer explicitly stated the fire-pit body style.", "enum": [ "Brickyard", "Stackstone", "Limestone", "Corten Steel" ], "type": "string" }, "fuelType": { "description": "Include only when the buyer explicitly stated Natural Gas, Propane, or Wood Burning. Never infer fuel.", "enum": [ "Natural Gas", "Propane", "Wood Burning" ], "type": "string" }, "shape": { "description": "Include only when the buyer explicitly stated Square or Round.", "enum": [ "Square", "Round" ], "type": "string" }, "tabletopFinish": { "description": "Include only when the buyer explicitly stated the tabletop finish.", "enum": [ "GFRC Polished Limestone Finish", "GFRC Polished Black Granite Finish" ], "type": "string" } }, "type": "object" }, "name": "qualify_homebridge_fire_pit", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "boundaries": { "additionalProperties": false, "properties": { "mayCollectPayment": { "const": false, "type": "boolean" }, "mayInferMissingSelection": { "const": false, "type": "boolean" }, "mayPlaceOrder": { "const": false, "type": "boolean" }, "selectionsMustComeFromBuyer": { "const": true, "type": "boolean" } }, "required": [ "selectionsMustComeFromBuyer", "mayInferMissingSelection", "mayPlaceOrder", "mayCollectPayment" ], "type": "object" }, "candidates": { "items": { "additionalProperties": false, "properties": { "availability": { "enum": [ "available", "unavailable" ], "type": "string" }, "configuration": { "additionalProperties": false, "properties": { "bodyStyle": { "enum": [ "Brickyard", "Stackstone", "Limestone", "Corten Steel" ], "type": "string" }, "fuelType": { "enum": [ "Natural Gas", "Propane", "Wood Burning" ], "type": "string" }, "shape": { "enum": [ "Square", "Round" ], "type": "string" }, "tabletopFinish": { "enum": [ "GFRC Polished Limestone Finish", "GFRC Polished Black Granite Finish" ], "type": "string" } }, "required": [ "bodyStyle", "tabletopFinish", "fuelType", "shape" ], "type": "object" }, "price": { "additionalProperties": false, "properties": { "amount": { "type": "string" }, "authority": { "const": "live_shopify", "type": "string" }, "currency": { "const": "USD", "type": "string" } }, "required": [ "amount", "currency", "authority" ], "type": "object" }, "sku": { "type": "string" } }, "required": [ "sku", "availability", "price", "configuration" ], "type": "object" }, "type": "array" }, "clarifyingQuestion": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "compatibleOptions": { "additionalProperties": false, "properties": { "bodyStyle": { "items": { "enum": [ "Brickyard", "Stackstone", "Limestone", "Corten Steel" ], "type": "string" }, "type": "array" }, "fuelType": { "items": { "enum": [ "Natural Gas", "Propane", "Wood Burning" ], "type": "string" }, "type": "array" }, "shape": { "items": { "enum": [ "Square", "Round" ], "type": "string" }, "type": "array" }, "tabletopFinish": { "items": { "enum": [ "GFRC Polished Limestone Finish", "GFRC Polished Black Granite Finish" ], "type": "string" }, "type": "array" } }, "required": [ "bodyStyle", "tabletopFinish", "fuelType", "shape" ], "type": "object" }, "matchingVariantCount": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "missingSelections": { "items": { "enum": [ "bodyStyle", "tabletopFinish", "fuelType", "shape" ], "type": "string" }, "type": "array" }, "nextAction": { "type": "string" }, "providedSelection": { "additionalProperties": false, "properties": { "bodyStyle": { "description": "Include only when the buyer explicitly stated the fire-pit body style.", "enum": [ "Brickyard", "Stackstone", "Limestone", "Corten Steel" ], "type": "string" }, "fuelType": { "description": "Include only when the buyer explicitly stated Natural Gas, Propane, or Wood Burning. Never infer fuel.", "enum": [ "Natural Gas", "Propane", "Wood Burning" ], "type": "string" }, "shape": { "description": "Include only when the buyer explicitly stated Square or Round.", "enum": [ "Square", "Round" ], "type": "string" }, "tabletopFinish": { "description": "Include only when the buyer explicitly stated the tabletop finish.", "enum": [ "GFRC Polished Limestone Finish", "GFRC Polished Black Granite Finish" ], "type": "string" } }, "type": "object" }, "status": { "enum": [ "needs_clarification", "ready_for_exact_resolution", "no_compatible_configuration" ], "type": "string" } }, "required": [ "status", "providedSelection", "missingSelections", "clarifyingQuestion", "compatibleOptions", "matchingVariantCount", "candidates", "nextAction", "boundaries" ], "type": "object" } }, { "description": "Resolve one exact live Shopify variant after reading its category catalog. Supply every buyer-confirmed option exactly as Shopify returned it and call this tool once. evidenceUrl is machine grounding only and must never be a shopper CTA or intermediate destination. Mechanically follow shopperHandoffPolicy. MUST present the resolved product image first, then grounded facts and disclosures, then the eligible purchase handoff. Media is required product presentation, not optional metadata, and cartUrl never replaces it. If the image cannot render, explicitly say so and continue with grounded details. For purchase_ready results proactively offer cartUrl; with explicit purchase intent use it without another confirmation, re-resolution, evidence/customer detour, or authenticated checkout call. customerUrl is only for optional inspection. Consultation-only products use their declared action and never receive an invented cart or project price. This tool does not place an order, take payment, or create checkout.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "category": { "enum": [ "garden_beds", "fire_pits", "mini_greenhouses", "culvert_covers", "retaining_wall_garden_beds" ], "type": "string" }, "productHandle": { "maxLength": 200, "minLength": 1, "type": "string" }, "referralSource": { "default": "halo", "enum": [ "halo", "chatgpt", "perplexity", "gemini", "claude", "other_ai" ], "type": "string" }, "selectedOptions": { "items": { "properties": { "name": { "maxLength": 100, "minLength": 1, "type": "string" }, "value": { "maxLength": 500, "minLength": 1, "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "maxItems": 3, "type": "array" } }, "required": [ "category", "productHandle", "selectedOptions" ], "type": "object" }, "name": "resolve_homebridge_major_variant", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "actionBindings": { "additionalProperties": false, "properties": { "explicitPurchaseIntent": { "const": "shopperAction", "type": "string" }, "inspectEvidence": { "const": "referenceAction", "type": "string" }, "inspectExactProduct": { "const": "inspectionAction", "type": "string" } }, "required": [ "inspectExactProduct", "explicitPurchaseIntent", "inspectEvidence" ], "type": "object" }, "configuration": { "anyOf": [ { "additionalProperties": false, "properties": { "actionBindings": { "additionalProperties": false, "properties": { "explicitPurchaseIntent": { "const": "shopperAction", "type": "string" }, "inspectEvidence": { "const": "referenceAction", "type": "string" }, "inspectExactProduct": { "const": "inspectionAction", "type": "string" } }, "required": [ "inspectExactProduct", "explicitPurchaseIntent", "inspectEvidence" ], "type": "object" }, "availability": { "enum": [ "available", "unavailable" ], "type": "string" }, "commerceLinks": { "additionalProperties": false, "properties": { "attributedCartPermalink": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "attributedProductUrl": { "type": "string" }, "canonicalProductUrl": { "type": "string" }, "cartUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "checkoutUrl": { "type": "null" }, "customerUrl": { "type": "string" }, "evidenceUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "exactVariantProductUrl": { "type": "string" }, "shopifyCartPermalink": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "evidenceUrl", "customerUrl", "cartUrl", "checkoutUrl", "canonicalProductUrl", "exactVariantProductUrl", "attributedProductUrl", "shopifyCartPermalink", "attributedCartPermalink" ], "type": "object" }, "inspectionAction": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "buyerControlled": { "type": "boolean" }, "collectsPayment": { "const": false, "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "placesOrder": { "const": false, "type": "boolean" }, "shopperFacing": { "type": "boolean" }, "type": { "enum": [ "view_exact_product", "open_cart", "request_consultation", "inspect_evidence" ], "type": "string" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "type", "label", "url", "method", "available", "shopperFacing", "buyerControlled", "placesOrder", "collectsPayment" ], "type": "object" }, "numericVariantId": { "type": "string" }, "options": { "additionalProperties": { "type": "string" }, "propertyNames": { "type": "string" }, "type": "object" }, "price": { "additionalProperties": false, "properties": { "amount": { "type": "string" }, "authority": { "const": "live_shopify", "type": "string" }, "currency": { "const": "USD", "type": "string" } }, "required": [ "amount", "currency", "authority" ], "type": "object" }, "primaryMedia": { "anyOf": [ { "additionalProperties": false, "properties": { "altText": { "type": "string" }, "associatedVariantIds": { "items": { "type": "string" }, "type": "array" }, "association": { "enum": [ "shopify_variant_featured_image", "shopify_product_media" ], "type": "string" }, "embeddedUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "exactVariantDepictionVerified": { "const": false, "type": "boolean" }, "fidelityNote": { "type": "string" }, "height": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "mediaId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "mimeType": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "position": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "previewImage": { "anyOf": [ { "additionalProperties": false, "properties": { "height": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "url": { "type": "string" }, "width": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "url", "width", "height" ], "type": "object" }, { "type": "null" } ] }, "relationship": { "enum": [ "representative", "product_family" ], "type": "string" }, "relevance": { "additionalProperties": false, "properties": { "differingAttributes": { "additionalProperties": { "additionalProperties": false, "properties": { "selected": { "type": "string" }, "shown": { "type": "string" } }, "required": [ "selected", "shown" ], "type": "object" }, "propertyNames": { "type": "string" }, "type": "object" }, "evidenceSource": { "enum": [ "shopify_variant_association", "shopify_variant_options", "product_membership" ], "type": "string" }, "group": { "enum": [ "selected_variant", "matching_visual_attributes", "product_family" ], "type": "string" }, "matchedAttributes": { "additionalProperties": { "type": "string" }, "propertyNames": { "type": "string" }, "type": "object" }, "reviewedDuplicateGroup": { "type": "string" } }, "required": [ "group", "evidenceSource", "matchedAttributes", "differingAttributes" ], "type": "object" }, "sources": { "items": { "additionalProperties": false, "properties": { "format": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "height": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "mimeType": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "url": { "type": "string" }, "width": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "url", "mimeType", "format", "width", "height" ], "type": "object" }, "type": "array" }, "type": { "enum": [ "image", "video", "external_video", "model_3d" ], "type": "string" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "width": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "url", "mimeType", "width", "height", "relationship", "association", "associatedVariantIds", "exactVariantDepictionVerified", "fidelityNote", "mediaId", "type", "position", "altText", "previewImage", "sources", "embeddedUrl" ], "type": "object" }, { "type": "null" } ] }, "purchaseState": { "enum": [ "purchase_ready", "consultation_ready", "view_only" ], "type": "string" }, "referenceAction": { "anyOf": [ { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "buyerControlled": { "type": "boolean" }, "collectsPayment": { "const": false, "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "placesOrder": { "const": false, "type": "boolean" }, "shopperFacing": { "type": "boolean" }, "type": { "enum": [ "view_exact_product", "open_cart", "request_consultation", "inspect_evidence" ], "type": "string" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "type", "label", "url", "method", "available", "shopperFacing", "buyerControlled", "placesOrder", "collectsPayment" ], "type": "object" }, { "type": "null" } ] }, "shopperAction": { "anyOf": [ { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "buyerControlled": { "type": "boolean" }, "collectsPayment": { "const": false, "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "placesOrder": { "const": false, "type": "boolean" }, "shopperFacing": { "type": "boolean" }, "type": { "enum": [ "view_exact_product", "open_cart", "request_consultation", "inspect_evidence" ], "type": "string" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "type", "label", "url", "method", "available", "shopperFacing", "buyerControlled", "placesOrder", "collectsPayment" ], "type": "object" }, { "type": "null" } ] }, "shopperActions": { "additionalProperties": false, "properties": { "addToCart": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "available", "url", "method", "label" ], "type": "object" }, "requestConsultation": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "available", "url", "method", "label" ], "type": "object" }, "startCheckout": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "available", "url", "method", "label" ], "type": "object" }, "viewProduct": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "available", "url", "method", "label" ], "type": "object" } }, "required": [ "viewProduct", "addToCart", "startCheckout", "requestConsultation" ], "type": "object" }, "shopperHandoffPolicy": { "additionalProperties": false, "properties": { "cartDoesNotReplaceProductPresentation": { "const": true, "type": "boolean" }, "evidenceIsShopperDestination": { "const": false, "type": "boolean" }, "explicitPurchaseInstruction": { "type": "string" }, "explicitPurchaseIntentRole": { "anyOf": [ { "enum": [ "cartUrl", "requestConsultation" ], "type": "string" }, { "type": "null" } ] }, "groundingRole": { "const": "evidenceUrl", "type": "string" }, "inspectionRole": { "const": "customerUrl", "type": "string" }, "mediaFailureInstruction": { "type": "string" }, "mediaRequiredBeforePurchaseHandoff": { "const": true, "type": "boolean" }, "presentationSequence": { "prefixItems": [ { "const": "presentMedia", "type": "string" }, { "const": "presentFactsAndDisclosures", "type": "string" }, { "const": "offerPurchaseHandoff", "type": "string" } ], "type": "array" }, "proactiveInstruction": { "type": "string" }, "purchaseReadyRole": { "anyOf": [ { "enum": [ "cartUrl", "requestConsultation" ], "type": "string" }, { "type": "null" } ] } }, "required": [ "groundingRole", "inspectionRole", "purchaseReadyRole", "explicitPurchaseIntentRole", "evidenceIsShopperDestination", "presentationSequence", "mediaRequiredBeforePurchaseHandoff", "cartDoesNotReplaceProductPresentation", "mediaFailureInstruction", "proactiveInstruction", "explicitPurchaseInstruction" ], "type": "object" }, "sku": { "type": "string" }, "title": { "type": "string" }, "variantId": { "type": "string" } }, "required": [ "variantId", "numericVariantId", "sku", "title", "options", "availability", "price", "primaryMedia", "commerceLinks", "purchaseState", "actionBindings", "inspectionAction", "shopperAction", "referenceAction", "shopperActions", "shopperHandoffPolicy" ], "type": "object" }, { "type": "null" } ] }, "consultation": { "anyOf": [ { "additionalProperties": false, "properties": { "reason": { "type": "string" }, "required": { "const": true, "type": "boolean" }, "url": { "type": "string" } }, "required": [ "required", "reason", "url" ], "type": "object" }, { "type": "null" } ] }, "inspectionAction": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "buyerControlled": { "type": "boolean" }, "collectsPayment": { "const": false, "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "placesOrder": { "const": false, "type": "boolean" }, "shopperFacing": { "type": "boolean" }, "type": { "enum": [ "view_exact_product", "open_cart", "request_consultation", "inspect_evidence" ], "type": "string" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "type", "label", "url", "method", "available", "shopperFacing", "buyerControlled", "placesOrder", "collectsPayment" ], "type": "object" }, "product": { "additionalProperties": false, "properties": { "canonicalUrl": { "type": "string" }, "category": { "enum": [ "garden_beds", "fire_pits", "mini_greenhouses", "culvert_covers", "retaining_wall_garden_beds" ], "type": "string" }, "handle": { "type": "string" }, "productId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "title": { "type": "string" } }, "required": [ "productId", "title", "handle", "category", "canonicalUrl" ], "type": "object" }, "purchaseState": { "enum": [ "purchase_ready", "consultation_ready", "view_only" ], "type": "string" }, "referenceAction": { "anyOf": [ { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "buyerControlled": { "type": "boolean" }, "collectsPayment": { "const": false, "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "placesOrder": { "const": false, "type": "boolean" }, "shopperFacing": { "type": "boolean" }, "type": { "enum": [ "view_exact_product", "open_cart", "request_consultation", "inspect_evidence" ], "type": "string" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "type", "label", "url", "method", "available", "shopperFacing", "buyerControlled", "placesOrder", "collectsPayment" ], "type": "object" }, { "type": "null" } ] }, "requiredDisclosures": { "items": { "type": "string" }, "type": "array" }, "shopperAction": { "anyOf": [ { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "buyerControlled": { "type": "boolean" }, "collectsPayment": { "const": false, "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "placesOrder": { "const": false, "type": "boolean" }, "shopperFacing": { "type": "boolean" }, "type": { "enum": [ "view_exact_product", "open_cart", "request_consultation", "inspect_evidence" ], "type": "string" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "type", "label", "url", "method", "available", "shopperFacing", "buyerControlled", "placesOrder", "collectsPayment" ], "type": "object" }, { "type": "null" } ] }, "shopperActions": { "additionalProperties": false, "properties": { "addToCart": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "available", "url", "method", "label" ], "type": "object" }, "requestConsultation": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "available", "url", "method", "label" ], "type": "object" }, "startCheckout": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "available", "url", "method", "label" ], "type": "object" }, "viewProduct": { "additionalProperties": false, "properties": { "available": { "type": "boolean" }, "label": { "type": "string" }, "method": { "anyOf": [ { "const": "GET", "type": "string" }, { "type": "null" } ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "available", "url", "method", "label" ], "type": "object" } }, "required": [ "viewProduct", "addToCart", "startCheckout", "requestConsultation" ], "type": "object" }, "shopperHandoffPolicy": { "additionalProperties": false, "properties": { "cartDoesNotReplaceProductPresentation": { "const": true, "type": "boolean" }, "evidenceIsShopperDestination": { "const": false, "type": "boolean" }, "explicitPurchaseInstruction": { "type": "string" }, "explicitPurchaseIntentRole": { "anyOf": [ { "enum": [ "cartUrl", "requestConsultation" ], "type": "string" }, { "type": "null" } ] }, "groundingRole": { "const": "evidenceUrl", "type": "string" }, "inspectionRole": { "const": "customerUrl", "type": "string" }, "mediaFailureInstruction": { "type": "string" }, "mediaRequiredBeforePurchaseHandoff": { "const": true, "type": "boolean" }, "presentationSequence": { "prefixItems": [ { "const": "presentMedia", "type": "string" }, { "const": "presentFactsAndDisclosures", "type": "string" }, { "const": "offerPurchaseHandoff", "type": "string" } ], "type": "array" }, "proactiveInstruction": { "type": "string" }, "purchaseReadyRole": { "anyOf": [ { "enum": [ "cartUrl", "requestConsultation" ], "type": "string" }, { "type": "null" } ] } }, "required": [ "groundingRole", "inspectionRole", "purchaseReadyRole", "explicitPurchaseIntentRole", "evidenceIsShopperDestination", "presentationSequence", "mediaRequiredBeforePurchaseHandoff", "cartDoesNotReplaceProductPresentation", "mediaFailureInstruction", "proactiveInstruction", "explicitPurchaseInstruction" ], "type": "object" } }, "required": [ "product", "configuration", "requiredDisclosures" ], "type": "object" } } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:6f9b3de53b2bd5f80f4d79aef424bc08e403ad670c0b7cedad985849231ef758 | sha256sum