HALO Homebridge AI Surfaces

Resolve an exact Homebridge major-category variant

resolve_homebridge_major_variant

Read-onlyIdempotent

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.

Input Schema

TableJSON Schema

Name	Required	Default
`category`	Yes
`productHandle`	Yes
`referralSource`	No	halo
`selectedOptions`	Yes

Output Schema

TableJSON Schema

Name	Required	Description	Default
`product`	Yes
`consultation`	No
`configuration`	Yes
`purchaseState`	No
`shopperAction`	No
`actionBindings`	No
`shopperActions`	No
`referenceAction`	No
`inspectionAction`	No
`requiredDisclosures`	Yes
`shopperHandoffPolicy`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedSep 8, 2026

changedOutput schema / properties / configuration / anyOf

Previous value: -[
-  {
-    "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"
-              },
-              "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"
-  }
-]New value: +[
+  {
+    "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"
+  }
+]

Changed13 schema fields changedSep 7, 2026

addedOutput schema / properties / actionBindings

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "explicitPurchaseIntent": {
+      "const": "shopperAction",
+      "type": "string"
+    },
+    "inspectEvidence": {
+      "const": "referenceAction",
+      "type": "string"
+    },
+    "inspectExactProduct": {
+      "const": "inspectionAction",
+      "type": "string"
+    }
+  },
+  "required": [
+    "inspectExactProduct",
+    "explicitPurchaseIntent",
+    "inspectEvidence"
+  ],
+  "type": "object"
+}

removedOutput schema / properties / configuration / additionalProperties
```
Removed value: -false
```

addedOutput schema / properties / configuration / anyOf

Added value: +[
+  {
+    "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"
+              },
+              "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"
+  }
+]

removedOutput schema / properties / configuration / properties

Removed value: -{
-  "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"
-          },
-          "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"
-  }
-}

removedOutput schema / properties / configuration / required

Removed value: -[
-  "variantId",
-  "numericVariantId",
-  "sku",
-  "title",
-  "options",
-  "availability",
-  "price",
-  "primaryMedia",
-  "commerceLinks",
-  "purchaseState",
-  "actionBindings",
-  "inspectionAction",
-  "shopperAction",
-  "referenceAction",
-  "shopperActions",
-  "shopperHandoffPolicy"
-]

removedOutput schema / properties / configuration / type
```
Removed value: -"object"
```

addedOutput schema / properties / consultation

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "reason": {
+          "type": "string"
+        },
+        "required": {
+          "const": true,
+          "type": "boolean"
+        },
+        "url": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "required",
+        "reason",
+        "url"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / properties / inspectionAction

Added value: +{
+  "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"
+}

addedOutput schema / properties / purchaseState

Added value: +{
+  "enum": [
+    "purchase_ready",
+    "consultation_ready",
+    "view_only"
+  ],
+  "type": "string"
+}

addedOutput schema / properties / referenceAction

Added value: +{
+  "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"
+    }
+  ]
+}

addedOutput schema / properties / shopperAction

Added value: +{
+  "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"
+    }
+  ]
+}

addedOutput schema / properties / shopperActions

Added value: +{
+  "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"
+}

addedOutput schema / properties / shopperHandoffPolicy

Added value: +{
+  "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"
+}

Changed1 schema field changedSep 7, 2026

changedOutput schema / properties / configuration / properties / primaryMedia / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "altText": {
-        "type": "string"
-      },
-      "embeddedUrl": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "mediaId": {
-        "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"
-          }
-        ]
-      },
-      "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"
-      }
-    },
-    "required": [
-      "mediaId",
-      "type",
-      "position",
-      "altText",
-      "previewImage",
-      "sources",
-      "embeddedUrl"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "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"
+      },
+      "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"
+  }
+]

Changed5 schema fields changedSep 5, 2026

addedOutput schema / properties / configuration / properties / actionBindings

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "explicitPurchaseIntent": {
+      "const": "shopperAction",
+      "type": "string"
+    },
+    "inspectEvidence": {
+      "const": "referenceAction",
+      "type": "string"
+    },
+    "inspectExactProduct": {
+      "const": "inspectionAction",
+      "type": "string"
+    }
+  },
+  "required": [
+    "inspectExactProduct",
+    "explicitPurchaseIntent",
+    "inspectEvidence"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / configuration / properties / inspectionAction

Added value: +{
+  "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"
+}

addedOutput schema / properties / configuration / properties / referenceAction

Added value: +{
+  "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"
+    }
+  ]
+}

addedOutput schema / properties / configuration / properties / shopperAction

Added value: +{
+  "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"
+    }
+  ]
+}

changedOutput schema / properties / configuration / required

Previous value: -[
-  "variantId",
-  "numericVariantId",
-  "sku",
-  "title",
-  "options",
-  "availability",
-  "price",
-  "primaryMedia",
-  "commerceLinks",
-  "purchaseState",
-  "shopperActions",
-  "shopperHandoffPolicy"
-]New value: +[
+  "variantId",
+  "numericVariantId",
+  "sku",
+  "title",
+  "options",
+  "availability",
+  "price",
+  "primaryMedia",
+  "commerceLinks",
+  "purchaseState",
+  "actionBindings",
+  "inspectionAction",
+  "shopperAction",
+  "referenceAction",
+  "shopperActions",
+  "shopperHandoffPolicy"
+]

Changed5 schema fields changedSep 5, 2026

addedOutput schema / properties / configuration / properties / shopperHandoffPolicy / properties / cartDoesNotReplaceProductPresentation
```
Added value: +{
+  "const": true,
+  "type": "boolean"
+}
```
addedOutput schema / properties / configuration / properties / shopperHandoffPolicy / properties / mediaFailureInstruction
```
Added value: +{
+  "type": "string"
+}
```
addedOutput schema / properties / configuration / properties / shopperHandoffPolicy / properties / mediaRequiredBeforePurchaseHandoff
```
Added value: +{
+  "const": true,
+  "type": "boolean"
+}
```

addedOutput schema / properties / configuration / properties / shopperHandoffPolicy / properties / presentationSequence

Added value: +{
+  "prefixItems": [
+    {
+      "const": "presentMedia",
+      "type": "string"
+    },
+    {
+      "const": "presentFactsAndDisclosures",
+      "type": "string"
+    },
+    {
+      "const": "offerPurchaseHandoff",
+      "type": "string"
+    }
+  ],
+  "type": "array"
+}

changedOutput schema / properties / configuration / properties / shopperHandoffPolicy / required

Previous value: -[
-  "groundingRole",
-  "inspectionRole",
-  "purchaseReadyRole",
-  "explicitPurchaseIntentRole",
-  "evidenceIsShopperDestination",
-  "proactiveInstruction",
-  "explicitPurchaseInstruction"
-]New value: +[
+  "groundingRole",
+  "inspectionRole",
+  "purchaseReadyRole",
+  "explicitPurchaseIntentRole",
+  "evidenceIsShopperDestination",
+  "presentationSequence",
+  "mediaRequiredBeforePurchaseHandoff",
+  "cartDoesNotReplaceProductPresentation",
+  "mediaFailureInstruction",
+  "proactiveInstruction",
+  "explicitPurchaseInstruction"
+]

Changed4 schema fields changedSep 4, 2026

addedOutput schema / properties / configuration / properties / purchaseState

Added value: +{
+  "enum": [
+    "purchase_ready",
+    "consultation_ready",
+    "view_only"
+  ],
+  "type": "string"
+}

addedOutput schema / properties / configuration / properties / shopperActions

Added value: +{
+  "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"
+}

addedOutput schema / properties / configuration / properties / shopperHandoffPolicy

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "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"
+    },
+    "proactiveInstruction": {
+      "type": "string"
+    },
+    "purchaseReadyRole": {
+      "anyOf": [
+        {
+          "enum": [
+            "cartUrl",
+            "requestConsultation"
+          ],
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  },
+  "required": [
+    "groundingRole",
+    "inspectionRole",
+    "purchaseReadyRole",
+    "explicitPurchaseIntentRole",
+    "evidenceIsShopperDestination",
+    "proactiveInstruction",
+    "explicitPurchaseInstruction"
+  ],
+  "type": "object"
+}

changedOutput schema / properties / configuration / required

Previous value: -[
-  "variantId",
-  "numericVariantId",
-  "sku",
-  "title",
-  "options",
-  "availability",
-  "price",
-  "primaryMedia",
-  "commerceLinks"
-]New value: +[
+  "variantId",
+  "numericVariantId",
+  "sku",
+  "title",
+  "options",
+  "availability",
+  "price",
+  "primaryMedia",
+  "commerceLinks",
+  "purchaseState",
+  "shopperActions",
+  "shopperHandoffPolicy"
+]

Changed5 schema fields changedSep 4, 2026

addedOutput schema / properties / configuration / properties / commerceLinks / properties / cartUrl

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / properties / configuration / properties / commerceLinks / properties / checkoutUrl
```
Added value: +{
+  "type": "null"
+}
```
addedOutput schema / properties / configuration / properties / commerceLinks / properties / customerUrl
```
Added value: +{
+  "type": "string"
+}
```

addedOutput schema / properties / configuration / properties / commerceLinks / properties / evidenceUrl

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

changedOutput schema / properties / configuration / properties / commerceLinks / required

Previous value: -[
-  "canonicalProductUrl",
-  "exactVariantProductUrl",
-  "attributedProductUrl",
-  "shopifyCartPermalink",
-  "attributedCartPermalink"
-]New value: +[
+  "evidenceUrl",
+  "customerUrl",
+  "cartUrl",
+  "checkoutUrl",
+  "canonicalProductUrl",
+  "exactVariantProductUrl",
+  "attributedProductUrl",
+  "shopifyCartPermalink",
+  "attributedCartPermalink"
+]

First observedSep 1, 2026

TDQS

A3.9/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already provide readOnlyHint, idempotentHint, and destructiveHint. The description adds substantial behavioral detail beyond those: no order or checkout creation, evidenceUrl is machine-grounding only, media is mandatory presentation, cartUrl behavior depends on purchase intent, and consultation-only products must follow their declared action. This is consistent with the annotations and highly transparent.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded with the core action, then proceeds through evidence grounding, presentation requirements, and handoff policy. It is long but each sentence carries operational policy; the final statement about not placing an order is slightly redundant given the annotations. Overall it is dense and structured rather than padded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description covers invocation context, selectedOptions handling, evidenceUrl constraints, media presentation, cartUrl behavior, customerUrl scope, and consultation-only products. Output schema and annotations cover return values and safety. The main gap is not explicitly relating this tool to siblings like get_approved_homebridge_offer, but the operational contract is otherwise thorough.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate. It meaningfully explains selectedOptions with 'exactly as Shopify returned it,' but category is only left to its enum values, productHandle is never semantically described, and referralSource is entirely unmentioned. The description does not fill the gap left by the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: 'Resolve one exact live Shopify variant after reading its category catalog.' It clearly separates this from transaction tools by adding 'This tool does not place an order, take payment, or create checkout.' However, it does not explicitly distinguish itself from sibling tools like get_approved_homebridge_offer or get_homebridge_major_category_catalog.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives strong usage context: call after reading the category catalog, supply buyer-confirmed options exactly, and call once. It also provides exclusions, such as no re-resolution, no evidence/customer detour, no authenticated checkout call, and no invented carts for consultation-only products. It does not directly name alternative sibling tools, so it falls short of a 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All HALO Homebridge AI Surfaces tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?