Previous value: -"The merchant's own description (get_product only)."New value: +"Product description from the source catalog, when returned."

Previous value: -"NULL when we have no shelf read under 24 hours old (shelf_observed_at says when). Do not call it in or out of stock; when is_eligible_checkout is true it can still be ordered."New value: +"NULL when we have no shelf read under 24 hours old (shelf_observed_at says when). Null is not evidence of in-stock or out-of-stock state; checkout eligibility is independent."

Previous value: -"`local_delivery`: delivered locally. `concierge`: JENNi collects it from the shop and delivers it; buy it with start_checkout like any orderable offer. `ship_to_home`: shipped to the shopper. `in_store_only`: observed on the shelf, but it cannot be ordered through JENNi. `pickup` is store-owned capability metadata, not a JENNi customer reservation/ready/handoff flow, and is never returned. These are not executable MCP methods: ordering happens on the storefront."New value: +"`local_delivery`: delivered locally. `concierge`: JENNi collects it from the shop and delivers or ships it to the shopper. `ship_to_home`: shipped to the shopper. `in_store_only`: observed on the shelf, but it cannot be ordered through JENNi. `pickup` is store-owned capability metadata, not a JENNi customer reservation/ready/handoff flow, and is never returned. These are not executable MCP methods: ordering happens on the storefront."

Previous value: -"True: this offer can be ordered through JENNi; call start_checkout with it when the shopper wants to buy. start_checkout and the checkout page re-check the offer and say why if it can no longer be ordered, so do not ask the shopper to confirm stock or hours first. False: do not send the shopper to checkout for this offer. Nothing is charged until the shopper places the order on the checkout page."New value: +"True when this offer is currently eligible for ordering through JENNi; false otherwise. Eligibility and price are checked again at hosted checkout. Nothing is charged until the buyer places the order on the checkout page."

Previous value: -"Observed shelf price. Browse information only; not a checkout price. Use `price` and is_eligible_checkout for purchase."New value: +"Observed shelf price for browsing, not a checkout price. Purchase price and checkout eligibility are separate fields."

Previous value: -"Observed shelf price. Browse information only; not a checkout price. Use `price` and is_eligible_checkout for purchase."New value: +"Observed shelf price for browsing, not a checkout price. Purchase price and checkout eligibility are separate fields."

Previous value: -"Buyable size/colour variants. Give the shopper the variant url so the page opens on that choice. search_catalog lists at most 30; get_product lists all."New value: +"Buyable size/colour variants and their product URLs. Search responses contain at most 30; detail responses may include all variants."

Previous value: -"Always empty in product discovery. This field does not verify or rule out fulfillment availability."New value: +"JENNi's single best offer for this product (price, delivery_promise, fulfilled_by, is_eligible_checkout), without source-shop details."

Added value: +{
+  "description": "Shopper-facing delivery promise, e.g. \"Get it today\" (local delivery) or \"Ships to you\".",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Shopper-facing fulfiller line: \"Delivered by JENNi\".",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Previous value: -"`local_delivery`: delivered from the shop. `concierge`: JENNi collects it from the shop and delivers it; buy it with start_checkout like any orderable offer. `ship_to_home`: shipped from the shop. `in_store_only`: the shop carries it, but it cannot be ordered through JENNi; tell the shopper to visit the shop. `pickup` is store-owned capability metadata, not a JENNi customer reservation/ready/handoff flow, and is never returned. These are not executable MCP methods: ordering happens on the storefront."New value: +"`local_delivery`: delivered locally. `concierge`: JENNi collects it from the shop and delivers it; buy it with start_checkout like any orderable offer. `ship_to_home`: shipped to the shopper. `in_store_only`: observed on the shelf, but it cannot be ordered through JENNi. `pickup` is store-owned capability metadata, not a JENNi customer reservation/ready/handoff flow, and is never returned. These are not executable MCP methods: ordering happens on the storefront."

Previous value: -"The exact variant this shop holds."New value: +"The exact variant this offer covers."

Previous value: -"Store shelf price observed at the named store. Browse information only; not a checkout price. Use `price` and is_eligible_checkout for purchase."New value: +"Observed shelf price. Browse information only; not a checkout price. Use `price` and is_eligible_checkout for purchase."

Previous value: -0New value: +1

Previous value: -"Store shelf price observed at the named store. Browse information only; not a checkout price. Use `price` and is_eligible_checkout for purchase."New value: +"Observed shelf price. Browse information only; not a checkout price. Use `price` and is_eligible_checkout for purchase."

Removed value: -{
-  "description": "How many offers this product has. search_catalog lists at most 5, orderable ones first; get_product lists all.",
-  "type": "integer"
-}

Added value: +"Always empty in product discovery. This field does not verify or rule out fulfillment availability."

Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}

Removed value: -{
-  "type": [
-    "number",
-    "null"
-  ]
-}

Previous value: -"The disclosure a shopper sees for this shop; relay it."New value: +"A fulfillment disclosure, when applicable."

Removed value: -{
-  "type": "string"
-}

Removed value: -{
-  "type": "string"
-}

Previous value: -"Storefront page for this exact offer."New value: +"Storefront page for this exact product."

Previous value: -[
-  "store_id",
-  "is_eligible_search",
-  "is_eligible_checkout",
-  "fulfillment",
-  "availability"
-]New value: +[
+  "product_id",
+  "is_eligible_search",
+  "is_eligible_checkout",
+  "fulfillment",
+  "availability"
+]

Added value: +0

Removed value: -{
-  "description": "The one shop searched; null for all shops.",
-  "type": [
-    "string",
-    "null"
-  ]
-}

Previous value: -"NULL when we cannot read that shop's shelf, or the last read is over 24 hours old (shelf_observed_at says when). Null is not 'out of stock' — it means unknown, and must not be presented as either availability state."New value: +"NULL when we have no shelf read under 24 hours old (shelf_observed_at says when). Do not call it in or out of stock; when is_eligible_checkout is true it can still be ordered."

Previous value: -"`local_delivery`: delivered from the shop. `concierge`: a person goes to the shop and buys it on the buyer's behalf. start_checkout returns a hosted request link, even when is_eligible_checkout is false; the page determines whether a request can proceed. The link is not a stock reservation, durable quote or completed purchase. `ship_to_home`: shipped from the shop. `in_store_only`: the shop carries it, but it cannot be ordered through JENNi; tell the shopper to visit the shop. `pickup` is store-owned capability metadata, not a JENNi customer reservation/ready/handoff flow, and is never returned. These are not executable MCP methods: ordering happens on the storefront."New value: +"`local_delivery`: delivered from the shop. `concierge`: JENNi collects it from the shop and delivers it; buy it with start_checkout like any orderable offer. `ship_to_home`: shipped from the shop. `in_store_only`: the shop carries it, but it cannot be ordered through JENNi; tell the shopper to visit the shop. `pickup` is store-owned capability metadata, not a JENNi customer reservation/ready/handoff flow, and is never returned. These are not executable MCP methods: ordering happens on the storefront."

Previous value: -"True when the storefront offers this exact offer for order: ordering on, a checkout price quote, a shelf in stock, a courier or shipping, and a stated delivery fee. Local delivery is also refused when the shop's own hours show no opening within the week; a search result may not carry hours, and start_checkout re-checks with them. False forbids direct checkout. An explicitly `concierge` offer may still use start_checkout for a hosted request handoff; the product page checks whether a request is available. Neither eligibility nor a handoff reserves stock, creates a quote or places an order."New value: +"True: this offer can be ordered through JENNi; call start_checkout with it when the shopper wants to buy. start_checkout and the checkout page re-check the offer and say why if it can no longer be ordered, so do not ask the shopper to confirm stock or hours first. False: do not send the shopper to checkout for this offer. Nothing is charged until the shopper places the order on the checkout page."

Removed value: -{
-  "maxLength": 256,
-  "type": "string"
-}

Removed value: -{
-  "description": "Confidential opaque upstream continuation; forward unchanged with the same selectors and limit.",
-  "maxLength": 8192,
-  "type": "string"
-}

Removed value: -{
-  "pattern": "^[0-9]{8,14}$",
-  "type": "string"
-}

Removed value: -20

Added value: +"Products to return (default 10)."

Previous value: -100New value: +20

Added value: +{
+  "description": "Market key, e.g. san-antonio-tx. Used when no zip is given.",
+  "type": "string"
+}

Removed value: -{
-  "description": "Optional echoed caller context only; never filters facts.",
-  "pattern": "^[0-9]{5}(?:-[0-9]{4})?$",
-  "type": "string"
-}

Removed value: -{
-  "maxLength": 128,
-  "type": "string"
-}

Previous value: -"Optional title, brand, UPC or GTIN keyword. Omit to enumerate approved root catalog facts."New value: +"What the shopper wants, e.g. \"running shoes\"."

Removed value: -256

Removed value: -{
-  "description": "Unsupported for catalog facts; nonempty store filters are rejected.",
-  "type": "string"
-}

Removed value: -{
-  "description": "Empty normalizes to absent; store filtering is unsupported.",
-  "items": {
-    "type": "string"
-  },
-  "maxItems": 0,
-  "type": "array"
-}

Previous value: -"Optional echoed caller context only; never filters facts."New value: +"5-digit US ZIP code the shopper is in, e.g. 78205."

Removed value: -"^[0-9]{5}(?:-[0-9]{4})?$"

Previous value: -[]New value: +[
+  "query"
+]

Removed value: -false

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "kind": {
-      "const": "jenni_catalog_facts",
-      "type": "string"
-    },
-    "policy_hash": {
-      "const": "1340ae7f5b87d590b5107d90c6ace904a0b38419101e211f39f5bbaa84e704a1",
-      "type": "string"
-    },
-    "version": {
-      "const": "2026-10-16.v1",
-      "type": "string"
-    }
-  },
-  "required": [
-    "kind",
-    "version",
-    "policy_hash"
-  ],
-  "type": "object"
-}

Removed value: -{
-  "const": "catalog_facts_v1",
-  "type": "string"
-}

Added value: +{
+  "description": "The market we deliver in at that location; null when we deliver in none.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Removed value: -{
-  "type": "boolean"
-}

Removed value: -{
-  "items": {
-    "additionalProperties": false,
-    "properties": {
-      "brand": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "category": {
-        "additionalProperties": false,
-        "properties": {
-          "id": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "name": {
-            "type": [
-              "string",
-              "null"
-            ]
-          }
-        },
-        "required": [
-          "id",
-          "name"
-        ],
-        "type": "object"
-      },
-      "checkout_eligible": {
-        "const": false,
-        "type": "boolean"
-      },
-      "gtin": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "id": {
-        "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
-        "type": "string"
-      },
-      "images": {
-        "items": {
-          "type": "string"
-        },
-        "maxItems": 0,
-        "type": "array"
-      },
-      "offers": {
-        "items": {
-          "type": "string"
-        },
-        "maxItems": 0,
-        "type": "array"
-      },
-      "stock_state": {
-        "const": "unknown",
-        "type": "string"
-      },
-      "title": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "upc": {
-        "type": [
-          "string",
-          "null"
-        ]
-      }
-    },
-    "required": [
-      "id",
-      "title",
-      "brand",
-      "upc",
-      "gtin",
-      "category",
-      "images",
-      "offers",
-      "stock_state",
-      "checkout_eligible"
-    ],
-    "type": "object"
-  },
-  "type": "array"
-}

Added value: +{
+  "description": "The place searched around; null for none.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Removed value: -{
-  "const": "canonical_discovery",
-  "type": "string"
-}

Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "state": {
-      "const": "not_requested",
-      "type": "string"
-    }
-  },
-  "required": [
-    "state"
-  ],
-  "type": "object"
-}

Added value: +{
+  "items": {
+    "properties": {
+      "brand": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "category": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "color": {
+        "description": "Colour of the variant product_id names; null when it has none.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "description": {
+        "description": "The merchant's own description (get_product only).",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "image": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "offer_count": {
+        "description": "How many offers this product has. search_catalog lists at most 5, orderable ones first; get_product lists all.",
+        "type": "integer"
+      },
+      "offers": {
+        "items": {
+          "properties": {
+            "availability": {
+              "description": "NULL when we cannot read that shop's shelf, or the last read is over 24 hours old (shelf_observed_at says when). Null is not 'out of stock' — it means unknown, and must not be presented as either availability state.",
+              "enum": [
+                "in_stock",
+                "out_of_stock",
+                null
+              ],
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "city": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "distance_miles": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "fulfillment": {
+              "description": "`local_delivery`: delivered from the shop. `concierge`: a person goes to the shop and buys it on the buyer's behalf. start_checkout returns a hosted request link, even when is_eligible_checkout is false; the page determines whether a request can proceed. The link is not a stock reservation, durable quote or completed purchase. `ship_to_home`: shipped from the shop. `in_store_only`: the shop carries it, but it cannot be ordered through JENNi; tell the shopper to visit the shop. `pickup` is store-owned capability metadata, not a JENNi customer reservation/ready/handoff flow, and is never returned. These are not executable MCP methods: ordering happens on the storefront.",
+              "enum": [
+                "pickup",
+                "local_delivery",
+                "ship_to_home",
+                "concierge",
+                "in_store_only"
+              ],
+              "type": "string"
+            },
+            "is_eligible_checkout": {
+              "description": "True when the storefront offers this exact offer for order: ordering on, a checkout price quote, a shelf in stock, a courier or shipping, and a stated delivery fee. Local delivery is also refused when the shop's own hours show no opening within the week; a search result may not carry hours, and start_checkout re-checks with them. False forbids direct checkout. An explicitly `concierge` offer may still use start_checkout for a hosted request handoff; the product page checks whether a request is available. Neither eligibility nor a handoff reserves stock, creates a quote or places an order.",
+              "type": "boolean"
+            },
+            "is_eligible_search": {
+              "type": "boolean"
+            },
+            "note": {
+              "description": "The disclosure a shopper sees for this shop; relay it.",
+              "type": "string"
+            },
+            "price": {
+              "description": "USD, e.g. \"$12.50\". Null when we hold no current price.",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "product_id": {
+              "description": "The exact variant this shop holds.",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "shelf_observed_at": {
+              "description": "When the shelf was last read. Null means never.",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "shelf_price": {
+              "description": "Store shelf price observed at the named store. Browse information only; not a checkout price. Use `price` and is_eligible_checkout for purchase.",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "store_id": {
+              "type": "string"
+            },
+            "store_name": {
+              "type": "string"
+            },
+            "url": {
+              "description": "Storefront page for this exact offer.",
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "store_id",
+            "is_eligible_search",
+            "is_eligible_checkout",
+            "fulfillment",
+            "availability"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "price": {
+        "description": "Headline price in USD; null when none is held.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "product_id": {
+        "type": "string"
+      },
+      "shelf_price": {
+        "description": "Store shelf price observed at the named store. Browse information only; not a checkout price. Use `price` and is_eligible_checkout for purchase.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "size": {
+        "description": "Size of the variant product_id names; null when it has none.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "title": {
+        "type": "string"
+      },
+      "url": {
+        "description": "Storefront product page, where the buyer picks size/colour, checks out as a guest (email, no account) and pays. Null when no storefront is configured.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "variants": {
+        "description": "Buyable size/colour variants. Give the shopper the variant url so the page opens on that choice. search_catalog lists at most 30; get_product lists all.",
+        "items": {
+          "properties": {
+            "color": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "product_id": {
+              "type": "string"
+            },
+            "size": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "url": {
+              "description": "Storefront page opened on this variant.",
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "product_id"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "product_id",
+      "title",
+      "offers"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "type": "string"
+}

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "postal_code": {
-      "pattern": "^[0-9]{5}(?:-[0-9]{4})?$",
-      "type": [
-        "string",
-        "null"
-      ]
-    }
-  },
-  "required": [
-    "postal_code"
-  ],
-  "type": "object"
-}

Removed value: -{
-  "const": "live_keyset",
-  "type": "string"
-}

Removed value: -{
-  "format": "date-time",
-  "type": "string"
-}

Added value: +{
+  "description": "The one shop searched; null for all shops.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Previous value: -[
-  "mode",
-  "contract_version",
-  "items",
-  "next_cursor",
-  "exhausted",
-  "catalog_authority",
-  "offer_policy",
-  "requested_context",
-  "source_observed_at",
-  "snapshot_semantics"
-]New value: +[
+  "query",
+  "products"
+]