Previous value: -"Optional: the product's category in McClipFace's taxonomy, so results stay in it (e.g. honey -> grocery). One of: asian-fashion, audio, auto, bags, beauty, bedding, cleaning, computers, education, electronics, eyewear, fashion, fragrance, furniture, gaming, garden, gifts-food, golf, grocery, grooming, haircare, health, home, home-decor, home-improvement, household-essentials, j-beauty, japanese-fashion, jewelry, k-beauty, kitchen, korean-fashion, makeup, marketplace, office-supplies, oral-care, otc-medicine, personal-care, pets, phones, photo-editing, photo-printing, photography, skincare, smart-home, software, sports-outdoors, toys-kids, travel. A close name is mapped to the nearest one; an unknown one is ignored."New value: +"Optional: the product's category in McClipFace's taxonomy, so results stay in it inferred from what the shopper means, never from a keyword (honey for the pantry: grocery; honey face wash: beauty); omit when unsure. One of: asian-fashion, audio, auto, bags, beauty, bedding, cleaning, computers, education, electronics, eyewear, fashion, fragrance, furniture, gaming, garden, gifts-food, golf, grocery, grooming, haircare, health, home, home-decor, home-improvement, household-essentials, j-beauty, japanese-fashion, jewelry, k-beauty, kitchen, korean-fashion, makeup, marketplace, office-supplies, oral-care, otc-medicine, personal-care, pets, phones, photo-editing, photo-printing, photography, skincare, smart-home, software, sports-outdoors, toys-kids, travel. A close name is mapped to the nearest one; an unknown one is ignored."

Added value: +{
+  "description": "Optional: the product's category in McClipFace's taxonomy, so results stay in it (e.g. honey -> grocery). One of: asian-fashion, audio, auto, bags, beauty, bedding, cleaning, computers, education, electronics, eyewear, fashion, fragrance, furniture, gaming, garden, gifts-food, golf, grocery, grooming, haircare, health, home, home-decor, home-improvement, household-essentials, j-beauty, japanese-fashion, jewelry, k-beauty, kitchen, korean-fashion, makeup, marketplace, office-supplies, oral-care, otc-medicine, personal-care, pets, phones, photo-editing, photo-printing, photography, skincare, smart-home, software, sports-outdoors, toys-kids, travel. A close name is mapped to the nearest one; an unknown one is ignored.",
+  "maxLength": 60,
+  "minLength": 1,
+  "type": "string"
+}

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

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

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

Removed value: -"Commission disclosure, in every result. Offers with tracked=true (link_type \"affiliate\" in the text) are the affiliate links it refers to."

Removed value: -{
-  "description": "find_coupons: the call named no store (a request error, not a store with no coupons).",
-  "type": "string"
-}

Removed value: -{
-  "description": "get_deals: the store and brand filters applied.",
-  "type": "object"
-}

Removed value: -{
-  "description": "find_coupons: the accepted store arguments, with error.",
-  "type": "string"
-}

Removed value: -{
-  "description": "Present when an offer has an entry_url: how to use the link.",
-  "type": "string"
-}

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

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

Removed value: -{
-  "description": "Optional: what can be done with the offer. Use the ones you can; a plain chat assistant shows the link. buy appears only with a real checkout link and always needs the shopper's explicit approval.",
-  "items": {
-    "properties": {
-      "code": {
-        "type": "string"
-      },
-      "label": {
-        "type": "string"
-      },
-      "note": {
-        "type": "string"
-      },
-      "requires_user_approval": {
-        "type": "boolean"
-      },
-      "type": {
-        "enum": [
-          "open_link",
-          "apply_code",
-          "buy"
-        ],
-        "type": "string"
-      },
-      "url": {
-        "type": "string"
-      }
-    },
-    "type": "object"
-  },
-  "type": "array"
-}

Removed value: -{
-  "description": "The item a product code is for, else null.",
-  "type": [
-    "string",
-    "null"
-  ]
-}

Removed value: -"Enter it exactly as served; if the store rejects it, try it once in all caps."

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

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

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

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

Removed value: -{
-  "description": "End date is a feed placeholder; ends_at is null.",
-  "type": "boolean"
-}

Removed value: -{
-  "description": "A code the store gave McClipFace directly; label it \"Exclusive McClipFace code\".",
-  "type": "boolean"
-}

Removed value: -{
-  "description": "Date (YYYY-MM-DD) of the latest worked report when verified, else null. Not a guarantee; codes can still fail.",
-  "type": [
-    "string",
-    "null"
-  ]
-}

Removed value: -"product: a product code for the searched item (works only on applies_to). offer_text: a store offer whose text names the product. brand_store: no offer names the product, so an offer at a store in the brand's or product's category that may carry it (not limited to the product; check that the store has it and it applies). category_store: likewise, an offer at a multi-brand retailer that may carry this type of product."

Removed value: -[
-  "product",
-  "offer_text",
-  "brand_store",
-  "category_store"
-]

Removed value: -{
-  "description": "What the code applies to.",
-  "type": [
-    "string",
-    "null"
-  ]
-}

Removed value: -{
-  "description": "find_coupons: store match score, 0 to 1.",
-  "type": "number"
-}

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

Removed value: -{
-  "description": "Always false: stale codes are left out.",
-  "type": "boolean"
-}

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

Removed value: -{
-  "description": "Demoted: recently reported as not working.",
-  "type": "boolean"
-}

Removed value: -"coupon: has a code. deal: a discount with no code. link_only: a store link, not a discount; say so and never place it above a better option."

Removed value: -[
-  "coupon",
-  "deal",
-  "link_only"
-]

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

Removed value: -{
-  "description": "Label to show with a needs_recheck offer.",
-  "type": [
-    "string",
-    "null"
-  ]
-}

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

Removed value: -"product: works only on the item in applies_to; never offer it as a store-wide code. store: not limited to one product."

Removed value: -[
-  "store",
-  "product"
-]

Removed value: -{
-  "description": "For a product code, which item it is for, else null.",
-  "type": [
-    "string",
-    "null"
-  ]
-}

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

Removed value: -"find_coupons and find_product_coupons: the store's domain, if known."

Removed value: -{
-  "description": "Optional rendering hint for a deal card; the offer's own fields stay the source of truth.",
-  "properties": {
-    "card_title": {
-      "type": "string"
-    },
-    "code_line": {
-      "description": "Show second, as a fallback: the raw code for a shopper already in the store's app. Only with a code.",
-      "type": "string"
-    },
-    "cta_label": {
-      "type": "string"
-    },
-    "expiry_display": {
-      "type": "string"
-    },
-    "headline": {
-      "description": "Show first: the offer's link. Link-first wording only for a tracked mcclipface.com /go link, else a neutral 'Store link: <url>'. Present when the offer has an https link.",
-      "type": "string"
-    },
-    "subtitle": {
-      "type": "string"
-    }
-  },
-  "type": "object"
-}

Removed value: -{
-  "description": "No-code deals only: parsed deal terms when confident, else null (never guessed).",
-  "properties": {
-    "category": {
-      "description": "Goods category the deal text names, if any.",
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "conditions": {
-      "items": {
-        "enum": [
-          "email_signup",
-          "membership",
-          "new_customer",
-          "app_only",
-          "in_store_only"
-        ],
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "ends_at": {
-      "description": "End date YYYY-MM-DD when known.",
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "min_spend": {
-      "description": "Minimum spend in USD, when stated.",
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "reward_type": {
-      "enum": [
-        "gift_card",
-        "dollars_off",
-        "percent_off",
-        "free_item",
-        "free_shipping",
-        "other"
-      ],
-      "type": "string"
-    },
-    "reward_value": {
-      "description": "Amount or percent.",
-      "type": [
-        "number",
-        "null"
-      ]
-    }
-  },
-  "type": [
-    "object",
-    "null"
-  ]
-}

Removed value: -"A recent shopper reported this code worked at checkout (more worked than failed reports in 14 days); ranked first. Not a guarantee; codes can still fail."

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

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

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

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

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

Removed value: -{
-  "description": "get_deals: excluded (sensitive-category stores left out of the general list) or included (a store or brand filter was sent). Prohibited goods are never returned.",
-  "enum": [
-    "excluded",
-    "included"
-  ],
-  "type": "string"
-}

Removed value: -[
-  "available",
-  "unavailable",
-  "invalid_arguments"
-]

Removed value: -"find_coupons: exact or alias when a store matched; none when no store did (offers is then empty)."

Removed value: -[
-  "exact",
-  "alias",
-  "none"
-]

Removed value: -{
-  "description": "find_coupons: the matched stores (store, domain, match, match_score).",
-  "type": "array"
-}

Removed value: -{
-  "description": "Only when no codes match: code-less links to supported stores that may carry the product (not a claim that they stock it). Absent when codes are found.",
-  "items": {
-    "properties": {
-      "applies_to": {
-        "description": "The item a product code is for, else null.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "code": {
-        "description": "Enter it exactly as served; if the store rejects it, try it once in all caps.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "community_evidence": {
-        "type": "object"
-      },
-      "currency": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "description": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "discount_type": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "discount_value": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "end_date_unknown": {
-        "description": "End date is a feed placeholder; ends_at is null.",
-        "type": "boolean"
-      },
-      "ends_at": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "entry_url": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "exclusive": {
-        "description": "A code the store gave McClipFace directly; label it \"Exclusive McClipFace code\".",
-        "type": "boolean"
-      },
-      "id": {
-        "type": "string"
-      },
-      "last_verified": {
-        "description": "Date (YYYY-MM-DD) of the latest worked report when verified, else null. Not a guarantee; codes can still fail.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "match": {
-        "description": "find_coupons: exact (the store's name or domain) or alias (a known other name).",
-        "enum": [
-          "exact",
-          "alias"
-        ],
-        "type": "string"
-      },
-      "match_score": {
-        "description": "find_coupons: store match score, 0 to 1.",
-        "type": "number"
-      },
-      "max_savings": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "may_have_expired": {
-        "description": "Always false: stale codes are left out.",
-        "type": "boolean"
-      },
-      "merchant": {
-        "type": "string"
-      },
-      "merchant_display": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "min_spend": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "needs_recheck": {
-        "description": "Demoted: recently reported as not working.",
-        "type": "boolean"
-      },
-      "offer_type": {
-        "description": "coupon: has a code. deal: a discount with no code. link_only: a store link, not a discount; say so and never place it above a better option.",
-        "enum": [
-          "coupon",
-          "deal",
-          "link_only"
-        ],
-        "type": "string"
-      },
-      "outbound_url": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "recheck_label": {
-        "description": "Label to show with a needs_recheck offer.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "restrictions": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "scope": {
-        "description": "product: works only on the item in applies_to; never offer it as a store-wide code. store: not limited to one product.",
-        "enum": [
-          "store",
-          "product"
-        ],
-        "type": "string"
-      },
-      "scope_note": {
-        "description": "For a product code, which item it is for, else null.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "starts_at": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "store_domain": {
-        "description": "find_coupons and find_product_coupons: the store's domain, if known.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "terms": {
-        "description": "No-code deals only: parsed deal terms when confident, else null (never guessed).",
-        "properties": {
-          "category": {
-            "description": "Goods category the deal text names, if any.",
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "conditions": {
-            "items": {
-              "enum": [
-                "email_signup",
-                "membership",
-                "new_customer",
-                "app_only",
-                "in_store_only"
-              ],
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "ends_at": {
-            "description": "End date YYYY-MM-DD when known.",
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "min_spend": {
-            "description": "Minimum spend in USD, when stated.",
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "reward_type": {
-            "enum": [
-              "gift_card",
-              "dollars_off",
-              "percent_off",
-              "free_item",
-              "free_shipping",
-              "other"
-            ],
-            "type": "string"
-          },
-          "reward_value": {
-            "description": "Amount or percent.",
-            "type": [
-              "number",
-              "null"
-            ]
-          }
-        },
-        "type": [
-          "object",
-          "null"
-        ]
-      },
-      "tracked": {
-        "type": "boolean"
-      },
-      "verified": {
-        "description": "A recent shopper reported this code worked at checkout (more worked than failed reports in 14 days); ranked first. Not a guarantee; codes can still fail.",
-        "type": "boolean"
-      }
-    },
-    "type": "object"
-  },
-  "type": "array"
-}

Removed value: -{
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

Added value: +{
+  "description": "Optional: the random install ID (a UUID) from the McClipFace skill, if it has one; never derived from the shopper. Only counted, as a monthly-salted hash, for monthly active installs; never stored as sent or linked to the store, codes or reports. Leave it out if there is none.",
+  "maxLength": 36,
+  "minLength": 36,
+  "type": "string"
+}

Previous value: -"find_coupons: the matched store's domain, if known."New value: +"find_coupons and find_product_coupons: the store's domain, if known."

Previous value: -"find_coupons: the matched store's domain, if known."New value: +"find_coupons and find_product_coupons: the store's domain, if known."

Added value: +{
+  "description": "Optional: what can be done with the offer. Use the ones you can; a plain chat assistant shows the link. buy appears only with a real checkout link and always needs the shopper's explicit approval.",
+  "items": {
+    "properties": {
+      "code": {
+        "type": "string"
+      },
+      "label": {
+        "type": "string"
+      },
+      "note": {
+        "type": "string"
+      },
+      "requires_user_approval": {
+        "type": "boolean"
+      },
+      "type": {
+        "enum": [
+          "open_link",
+          "apply_code",
+          "buy"
+        ],
+        "type": "string"
+      },
+      "url": {
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Optional rendering hint for a deal card; the offer's own fields stay the source of truth.",
+  "properties": {
+    "card_title": {
+      "type": "string"
+    },
+    "code_line": {
+      "description": "Show second, as a fallback: the raw code for a shopper already in the store's app. Only with a code.",
+      "type": "string"
+    },
+    "cta_label": {
+      "type": "string"
+    },
+    "expiry_display": {
+      "type": "string"
+    },
+    "headline": {
+      "description": "Show first: the offer's link. Link-first wording only for a tracked mcclipface.com /go link, else a neutral 'Store link: <url>'. Present when the offer has an https link.",
+      "type": "string"
+    },
+    "subtitle": {
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

Previous value: -"product: a product code for the searched item (works only on applies_to). offer_text: a store offer whose text names the product. brand_store: no offer names the product, so an offer at a store in the brand's or product's category that may carry it (not limited to the product; check that the store has it and it applies)."New value: +"product: a product code for the searched item (works only on applies_to). offer_text: a store offer whose text names the product. brand_store: no offer names the product, so an offer at a store in the brand's or product's category that may carry it (not limited to the product; check that the store has it and it applies). category_store: likewise, an offer at a multi-brand retailer that may carry this type of product."

Previous value: -[
-  "product",
-  "offer_text",
-  "brand_store"
-]New value: +[
+  "product",
+  "offer_text",
+  "brand_store",
+  "category_store"
+]

Previous value: -"product: a product code for the searched item (works only on applies_to). offer_text: a store offer whose text names the product."New value: +"product: a product code for the searched item (works only on applies_to). offer_text: a store offer whose text names the product. brand_store: no offer names the product, so an offer at a store in the brand's or product's category that may carry it (not limited to the product; check that the store has it and it applies)."

Previous value: -[
-  "product",
-  "offer_text"
-]New value: +[
+  "product",
+  "offer_text",
+  "brand_store"
+]

Previous value: -"ISO 4217 currency code, uppercase. Defaults to USD. Only offers in this currency are returned; non-US stores are left out of USD results."New value: +"ISO 4217 code, uppercase (default USD). Only offers in this currency are returned (USD leaves out non-US stores)."

Previous value: -"find_coupons only: set when the call named no store (a request error, not a store with no coupons)."New value: +"find_coupons: the call named no store (a request error, not a store with no coupons)."

Previous value: -"get_deals only: the store and brand filters applied."New value: +"get_deals: the store and brand filters applied."

Previous value: -"find_coupons only: the accepted store arguments, with error."New value: +"find_coupons: the accepted store arguments, with error."

Previous value: -"The product a scope \"product\" code is for; null otherwise."New value: +"The item a product code is for, else null."

Previous value: -"The feed's end date is a far-future placeholder, so ends_at is null."New value: +"End date is a feed placeholder; ends_at is null."

Previous value: -"An exclusive McClipFace code the store's affiliate program gave McClipFace directly (label it \"Exclusive McClipFace code\"). Same rules as every other offer."New value: +"A code the store gave McClipFace directly; label it \"Exclusive McClipFace code\"."

Previous value: -"Date (YYYY-MM-DD) of the latest report that the code worked at checkout, when verified; else null. Not a guarantee; codes can still fail."New value: +"Date (YYYY-MM-DD) of the latest worked report when verified, else null. Not a guarantee; codes can still fail."

Previous value: -"\"product\": a product code for the searched item (works only on applies_to). \"offer_text\": a store offer whose text names the product. Store names are not searched."New value: +"product: a product code for the searched item (works only on applies_to). offer_text: a store offer whose text names the product."

Previous value: -"One line saying what the code applies to."New value: +"What the code applies to."

Previous value: -"find_coupons only: store match score, 0 to 1."New value: +"find_coupons: store match score, 0 to 1."

Previous value: -"Always false. Codes more than 60 days old whose end date is unknown or a placeholder are left out; the field is kept for compatibility."New value: +"Always false: stale codes are left out."

Previous value: -"coupon: has a code. deal: a discount with no code. link_only: a store link, not a discount; label it as not a discount and never place it above a better option."New value: +"coupon: has a code. deal: a discount with no code. link_only: a store link, not a discount; say so and never place it above a better option."

Previous value: -"Short label to show with a needs-recheck offer (\"Recently reported as not working\")."New value: +"Label to show with a needs_recheck offer."

Previous value: -"\"product\": the code works only on the one item in applies_to. Offer it only for that item and never as a store-wide code. \"store\": not limited to one product in the feed (store terms still apply)."New value: +"product: works only on the item in applies_to; never offer it as a store-wide code. store: not limited to one product."

Previous value: -"For a product code, says which item it is for, e.g. \"DYUV: for the Dyson V11 Upright Cordless Stick Vacuum only, not store-wide\"; null otherwise."New value: +"For a product code, which item it is for, else null."

Previous value: -"find_coupons only: the matched store's domain, when known."New value: +"find_coupons: the matched store's domain, if known."

Previous value: -"No-code deals only: structured deal terms when the parser is confident, else null. Never guessed. Coupons and link_only rows are always null."New value: +"No-code deals only: parsed deal terms when confident, else null (never guessed)."

Previous value: -"Goods category when the deal text names one (e.g. household)."New value: +"Goods category the deal text names, if any."

Previous value: -"Gift-card or dollars-off amount, or percent value."New value: +"Amount or percent."

Previous value: -"Verified means a recent shopper reported this code worked at checkout (more worked than failed reports in the last 14 days). It is not a guarantee; codes can still fail. Verified codes rank first."New value: +"A recent shopper reported this code worked at checkout (more worked than failed reports in 14 days); ranked first. Not a guarantee; codes can still fail."

Previous value: -"get_deals only: whether stores whose names suggest a sensitive category were left out of the general digest (excluded) or a store or brand filter was sent (included). Prohibited goods stores are never returned either way."New value: +"get_deals: excluded (sensitive-category stores left out of the general list) or included (a store or brand filter was sent). Prohibited goods are never returned."

Previous value: -"find_coupons only: exact or alias when a store matched; none when no store matches exactly or by a known alias (offers is then empty)."New value: +"find_coupons: exact or alias when a store matched; none when no store did (offers is then empty)."

Previous value: -"find_coupons only: the matched stores (store, domain, match, match_score)."New value: +"find_coupons: the matched stores (store, domain, match, match_score)."

Previous value: -"Only when no codes match: code-less store links of stores McClipFace supports that may carry the product (no code, store link only). Not a claim that the store stocks the item. Absent when codes are found."New value: +"Only when no codes match: code-less links to supported stores that may carry the product (not a claim that they stock it). Absent when codes are found."

Previous value: -"The product a scope \"product\" code is for; null otherwise."New value: +"The item a product code is for, else null."

Previous value: -"The feed's end date is a far-future placeholder, so ends_at is null."New value: +"End date is a feed placeholder; ends_at is null."

Previous value: -"An exclusive McClipFace code the store's affiliate program gave McClipFace directly (label it \"Exclusive McClipFace code\"). Same rules as every other offer."New value: +"A code the store gave McClipFace directly; label it \"Exclusive McClipFace code\"."

Previous value: -"Date (YYYY-MM-DD) of the latest report that the code worked at checkout, when verified; else null. Not a guarantee; codes can still fail."New value: +"Date (YYYY-MM-DD) of the latest worked report when verified, else null. Not a guarantee; codes can still fail."

Previous value: -"find_coupons only: how the store matched the merchant asked for. \"exact\": its name, domain or the label of its own domain; \"alias\": a known other name of the store."New value: +"find_coupons: exact (the store's name or domain) or alias (a known other name)."

Previous value: -"find_coupons only: store match score, 0 to 1."New value: +"find_coupons: store match score, 0 to 1."

Previous value: -"Always false. Codes more than 60 days old whose end date is unknown or a placeholder are left out; the field is kept for compatibility."New value: +"Always false: stale codes are left out."

Previous value: -"coupon: has a code. deal: a discount with no code. link_only: a store link, not a discount; label it as not a discount and never place it above a better option."New value: +"coupon: has a code. deal: a discount with no code. link_only: a store link, not a discount; say so and never place it above a better option."

Previous value: -"Short label to show with a needs-recheck offer (\"Recently reported as not working\")."New value: +"Label to show with a needs_recheck offer."

Previous value: -"\"product\": the code works only on the one item in applies_to. Offer it only for that item and never as a store-wide code. \"store\": not limited to one product in the feed (store terms still apply)."New value: +"product: works only on the item in applies_to; never offer it as a store-wide code. store: not limited to one product."

Previous value: -"For a product code, says which item it is for, e.g. \"DYUV: for the Dyson V11 Upright Cordless Stick Vacuum only, not store-wide\"; null otherwise."New value: +"For a product code, which item it is for, else null."

Previous value: -"find_coupons only: the matched store's domain, when known."New value: +"find_coupons: the matched store's domain, if known."

Previous value: -"No-code deals only: structured deal terms when the parser is confident, else null. Never guessed. Coupons and link_only rows are always null."New value: +"No-code deals only: parsed deal terms when confident, else null (never guessed)."

Previous value: -"Goods category when the deal text names one (e.g. household)."New value: +"Goods category the deal text names, if any."

Previous value: -"Gift-card or dollars-off amount, or percent value."New value: +"Amount or percent."

Previous value: -"Verified means a recent shopper reported this code worked at checkout (more worked than failed reports in the last 14 days). It is not a guarantee; codes can still fail. Verified codes rank first."New value: +"A recent shopper reported this code worked at checkout (more worked than failed reports in 14 days); ranked first. Not a guarantee; codes can still fail."

Added value: +"Enter it exactly as served; if the store rejects it, try it once in all caps."

Added value: +"Enter it exactly as served; if the store rejects it, try it once in all caps."

Removed value: -{
-  "description": "Optional alias of client_version (client_version wins when both are sent).",
-  "maxLength": 32,
-  "minLength": 1,
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional: the installed McClipFace skill version (for example 2.0.0), used only for anonymous version mix counts and an update_notice on every result when outdated. Omit it when no McClipFace skill is installed (connector only): then no update_notice is sent. Use this argument (or its alias client_skill_version) rather than the HTTP header X-McClipFace-Version. No other client or user data.",
-  "maxLength": 32,
-  "minLength": 1,
-  "type": "string"
-}

Previous value: -"coupon: has a code. deal: a discount with no code. link_only: a store link, not a discount; label it as not a discount and pick it first only at a true tie."New value: +"coupon: has a code. deal: a discount with no code. link_only: a store link, not a discount; label it as not a discount and never place it above a better option."

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

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

Previous value: -"get_deals only: whether weapons, vape, tobacco, smoke shop, CBD/THC and adult stores were left out (the default) or included."New value: +"get_deals only: whether stores whose names suggest a sensitive category were left out of the general digest (excluded) or a store or brand filter was sent (included). Prohibited goods stores are never returned either way."

Previous value: -"coupon: has a code. deal: a discount with no code. link_only: a store link, not a discount; label it as not a discount and pick it first only at a true tie."New value: +"coupon: has a code. deal: a discount with no code. link_only: a store link, not a discount; label it as not a discount and never place it above a better option."

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

Removed value: -{
-  "description": "The first field when present: this client's skill version is older than the current one (on every such result; never sent when the call gives no version). The update is offered as a question before every update (yes / no); it happens only on the user's yes. latest is the current skill version; current is the version the caller sent (null when it could not be read); install is where the new SKILL.md is. Absent when the caller is current.",
-  "properties": {
-    "changes": {
-      "description": "One line: what changed in the latest version.",
-      "type": "string"
-    },
-    "current": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "install": {
-      "type": "string"
-    },
-    "latest": {
-      "type": "string"
-    },
-    "message": {
-      "type": "string"
-    }
-  },
-  "type": "object"
-}

Removed value: -{
-  "description": "Transitional: the same notice as one sentence (the shape before skill 1.4.14). Sent only with update_notice.",
-  "type": "string"
-}

Previous value: -"Optional: the installed McClipFace skill version (for example 1.4.24), used only for anonymous version mix counts and an update_notice on every result when outdated. Omit it when no McClipFace skill is installed (connector only): then no update_notice is sent. Use this argument (or its alias client_skill_version) rather than the HTTP header X-McClipFace-Version. No other client or user data."New value: +"Optional: the installed McClipFace skill version (for example 2.0.0), used only for anonymous version mix counts and an update_notice on every result when outdated. Omit it when no McClipFace skill is installed (connector only): then no update_notice is sent. Use this argument (or its alias client_skill_version) rather than the HTTP header X-McClipFace-Version. No other client or user data."

Previous value: -"The first field when present: this client's skill version is older than the current one (on every such result; never sent when the call gives no version). Read it before the offers. When latest is newer than the installed skill, update automatically from install without asking, then tell the user in one line the new version and what changed (changes); never update silently. If the skill file can't be written, tell the user once, in one line, that a newer version exists and how to install it. latest is the current skill version; current is the version the caller sent (null when it could not be read). Absent when the caller is current."New value: +"The first field when present: this client's skill version is older than the current one (on every such result; never sent when the call gives no version). The update is offered as a question before every update (yes / no); it happens only on the user's yes. latest is the current skill version; current is the version the caller sent (null when it could not be read); install is where the new SKILL.md is. Absent when the caller is current."

Previous value: -"Optional: the installed McClipFace skill version (for example 1.4.23), used only for anonymous version mix counts and an update_notice on every result when outdated. Omit it when no McClipFace skill is installed (connector only): then no update_notice is sent. Use this argument (or its alias client_skill_version) rather than the HTTP header X-McClipFace-Version. No other client or user data."New value: +"Optional: the installed McClipFace skill version (for example 1.4.24), used only for anonymous version mix counts and an update_notice on every result when outdated. Omit it when no McClipFace skill is installed (connector only): then no update_notice is sent. Use this argument (or its alias client_skill_version) rather than the HTTP header X-McClipFace-Version. No other client or user data."

Previous value: -"get_deals only: whether weapons, vape, tobacco, smoke shop and CBD/THC stores were left out (the default) or included."New value: +"get_deals only: whether weapons, vape, tobacco, smoke shop, CBD/THC and adult stores were left out (the default) or included."

Previous value: -"Optional: the installed McClipFace skill version (for example 1.4.22), used only for anonymous version mix counts and an update_notice on every result when outdated. Omit it when no McClipFace skill is installed (connector only): then no update_notice is sent. Use this argument (or its alias client_skill_version) rather than the HTTP header X-McClipFace-Version. No other client or user data."New value: +"Optional: the installed McClipFace skill version (for example 1.4.23), used only for anonymous version mix counts and an update_notice on every result when outdated. Omit it when no McClipFace skill is installed (connector only): then no update_notice is sent. Use this argument (or its alias client_skill_version) rather than the HTTP header X-McClipFace-Version. No other client or user data."

Previous value: -"get_deals only: whether weapons, vape, tobacco, smoke shop, CBD/THC and adult stores were left out (the default) or included."New value: +"get_deals only: whether weapons, vape, tobacco, smoke shop and CBD/THC stores were left out (the default) or included."

Previous value: -"Optional: the installed McClipFace skill version (for example 1.4.20), used only for anonymous version mix counts and an update_notice on every result when outdated. Omit it when no McClipFace skill is installed (connector only): then no update_notice is sent. Use this argument (or its alias client_skill_version) rather than the HTTP header X-McClipFace-Version. No other client or user data."New value: +"Optional: the installed McClipFace skill version (for example 1.4.22), used only for anonymous version mix counts and an update_notice on every result when outdated. Omit it when no McClipFace skill is installed (connector only): then no update_notice is sent. Use this argument (or its alias client_skill_version) rather than the HTTP header X-McClipFace-Version. No other client or user data."

Previous value: -"Optional: the installed McClipFace skill version (for example 1.4.19), used only for anonymous version mix counts and an update_notice on every result when outdated. Omit it when no McClipFace skill is installed (connector only): then no update_notice is sent. Use this argument (or its alias client_skill_version) rather than the HTTP header X-McClipFace-Version. No other client or user data."New value: +"Optional: the installed McClipFace skill version (for example 1.4.20), used only for anonymous version mix counts and an update_notice on every result when outdated. Omit it when no McClipFace skill is installed (connector only): then no update_notice is sent. Use this argument (or its alias client_skill_version) rather than the HTTP header X-McClipFace-Version. No other client or user data."

Previous value: -"Optional: the installed McClipFace skill version (for example 1.4.17), used only for anonymous version mix counts and an update_notice on every result when outdated. Omit it when no McClipFace skill is installed (connector only): then no update_notice is sent. Use this argument (or its alias client_skill_version) rather than the HTTP header X-McClipFace-Version. No other client or user data."New value: +"Optional: the installed McClipFace skill version (for example 1.4.19), used only for anonymous version mix counts and an update_notice on every result when outdated. Omit it when no McClipFace skill is installed (connector only): then no update_notice is sent. Use this argument (or its alias client_skill_version) rather than the HTTP header X-McClipFace-Version. No other client or user data."

Previous value: -"Present when an offer has an outbound_url: how to use the link."New value: +"Present when an offer has an entry_url: how to use the link."

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

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

Added value: +{
+  "description": "Optional alias of client_version (client_version wins when both are sent).",
+  "maxLength": 32,
+  "minLength": 1,
+  "type": "string"
+}

Previous value: -"Optional: the installed McClipFace skill version (for example 1.4.12), used only for anonymous version mix counts and a once-a-day update_notice when outdated. Use this argument rather than the HTTP header X-McClipFace-Version. No other client or user data."New value: +"Optional: the installed McClipFace skill version (for example 1.4.17), used only for anonymous version mix counts and an update_notice on every result when outdated. Omit it when no McClipFace skill is installed (connector only): then no update_notice is sent. Use this argument (or its alias client_skill_version) rather than the HTTP header X-McClipFace-Version. No other client or user data."

Added value: +{
+  "description": "find_coupons only: set when the call named no store (a request error, not a store with no coupons).",
+  "type": "string"
+}

Added value: +{
+  "description": "find_coupons only: the accepted store arguments, with error.",
+  "type": "string"
+}

Previous value: -"Present when this client's skill version is older than the current one, or missing, and at most once per day per caller: ask the user once in plain words whether to update now. On yes, install from the existing install URL. Absent when current or already nudged today."New value: +"The first field when present: this client's skill version is older than the current one (on every such result; never sent when the call gives no version). Read it before the offers. When latest is newer than the installed skill, update automatically from install without asking, then tell the user in one line the new version and what changed (changes); never update silently. If the skill file can't be written, tell the user once, in one line, that a newer version exists and how to install it. latest is the current skill version; current is the version the caller sent (null when it could not be read). Absent when the caller is current."

Added value: +{
+  "changes": {
+    "description": "One line: what changed in the latest version.",
+    "type": "string"
+  },
+  "current": {
+    "type": [
+      "string",
+      "null"
+    ]
+  },
+  "install": {
+    "type": "string"
+  },
+  "latest": {
+    "type": "string"
+  },
+  "message": {
+    "type": "string"
+  }
+}

Previous value: -"string"New value: +"object"

Added value: +{
+  "description": "Transitional: the same notice as one sentence (the shape before skill 1.4.14). Sent only with update_notice.",
+  "type": "string"
+}

Added value: +{
+  "description": "Optional: the installed McClipFace skill version (for example 1.4.12), used only for anonymous version mix counts and a once-a-day update_notice when outdated. Use this argument rather than the HTTP header X-McClipFace-Version. No other client or user data.",
+  "maxLength": 32,
+  "minLength": 1,
+  "type": "string"
+}

Added value: +{
+  "description": "Present when this client's skill version is older than the current one, or missing, and at most once per day per caller: ask the user once in plain words whether to update now. On yes, install from the existing install URL. Absent when current or already nudged today.",
+  "type": "string"
+}

Added value: +{
+  "description": "No-code deals only: structured deal terms when the parser is confident, else null. Never guessed. Coupons and link_only rows are always null.",
+  "properties": {
+    "category": {
+      "description": "Goods category when the deal text names one (e.g. household).",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "conditions": {
+      "items": {
+        "enum": [
+          "email_signup",
+          "membership",
+          "new_customer",
+          "app_only",
+          "in_store_only"
+        ],
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "ends_at": {
+      "description": "End date YYYY-MM-DD when known.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "min_spend": {
+      "description": "Minimum spend in USD, when stated.",
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "reward_type": {
+      "enum": [
+        "gift_card",
+        "dollars_off",
+        "percent_off",
+        "free_item",
+        "free_shipping",
+        "other"
+      ],
+      "type": "string"
+    },
+    "reward_value": {
+      "description": "Gift-card or dollars-off amount, or percent value.",
+      "type": [
+        "number",
+        "null"
+      ]
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}

Added value: +{
+  "description": "No-code deals only: structured deal terms when the parser is confident, else null. Never guessed. Coupons and link_only rows are always null.",
+  "properties": {
+    "category": {
+      "description": "Goods category when the deal text names one (e.g. household).",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "conditions": {
+      "items": {
+        "enum": [
+          "email_signup",
+          "membership",
+          "new_customer",
+          "app_only",
+          "in_store_only"
+        ],
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "ends_at": {
+      "description": "End date YYYY-MM-DD when known.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "min_spend": {
+      "description": "Minimum spend in USD, when stated.",
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "reward_type": {
+      "enum": [
+        "gift_card",
+        "dollars_off",
+        "percent_off",
+        "free_item",
+        "free_shipping",
+        "other"
+      ],
+      "type": "string"
+    },
+    "reward_value": {
+      "description": "Gift-card or dollars-off amount, or percent value.",
+      "type": [
+        "number",
+        "null"
+      ]
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}

Added value: +"Commission disclosure, in every result. Offers with tracked=true (link_type \"affiliate\" in the text) are the affiliate links it refers to."

Added value: +"Present when an offer has an outbound_url: how to use the link."

Previous value: -[
-  "available",
-  "unavailable"
-]New value: +[
+  "available",
+  "unavailable",
+  "invalid_arguments"
+]

Added value: +{
+  "description": "coupon: has a code. deal: a discount with no code. link_only: a store link, not a discount; label it as not a discount and pick it first only at a true tie.",
+  "enum": [
+    "coupon",
+    "deal",
+    "link_only"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "get_deals only: whether weapons, vape, tobacco, smoke shop, CBD/THC and adult stores were left out (the default) or included.",
+  "enum": [
+    "excluded",
+    "included"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "coupon: has a code. deal: a discount with no code. link_only: a store link, not a discount; label it as not a discount and pick it first only at a true tie.",
+  "enum": [
+    "coupon",
+    "deal",
+    "link_only"
+  ],
+  "type": "string"
+}

Previous value: -"\"product\": a product code for the searched item (works only on applies_to). \"offer_text\": a store offer whose text names the product. \"store\": a store-wide code at a store whose name matches the search, not limited to one product."New value: +"\"product\": a product code for the searched item (works only on applies_to). \"offer_text\": a store offer whose text names the product. Store names are not searched."

Previous value: -[
-  "product",
-  "offer_text",
-  "store"
-]New value: +[
+  "product",
+  "offer_text"
+]

Added value: +{
+  "description": "find_coupons only: store match score, 0 to 1.",
+  "type": "number"
+}

Added value: +{
+  "description": "find_coupons only: the matched store's domain, when known.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "find_coupons only: exact or alias when a store matched; none when no store matches exactly or by a known alias (offers is then empty).",
+  "enum": [
+    "exact",
+    "alias",
+    "none"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "find_coupons only: the matched stores (store, domain, match, match_score).",
+  "type": "array"
+}

Added value: +{
+  "description": "find_coupons only: how the store matched the merchant asked for. \"exact\": its name, domain or the label of its own domain; \"alias\": a known other name of the store.",
+  "enum": [
+    "exact",
+    "alias"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "find_coupons only: store match score, 0 to 1.",
+  "type": "number"
+}

Added value: +{
+  "description": "find_coupons only: the matched store's domain, when known.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Only when no codes match: code-less store links of stores McClipFace supports that may carry the product (no code, store link only). Not a claim that the store stocks the item. Absent when codes are found.",
+  "items": {
+    "properties": {
+      "applies_to": {
+        "description": "The product a scope \"product\" code is for; null otherwise.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "code": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "community_evidence": {
+        "type": "object"
+      },
+      "currency": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "description": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "discount_type": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "discount_value": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "end_date_unknown": {
+        "description": "The feed's end date is a far-future placeholder, so ends_at is null.",
+        "type": "boolean"
+      },
+      "ends_at": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "exclusive": {
+        "description": "An exclusive McClipFace code the store's affiliate program gave McClipFace directly (label it \"Exclusive McClipFace code\"). Same rules as every other offer.",
+        "type": "boolean"
+      },
+      "id": {
+        "type": "string"
+      },
+      "last_verified": {
+        "description": "Date (YYYY-MM-DD) of the latest report that the code worked at checkout, when verified; else null. Not a guarantee; codes can still fail.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "max_savings": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "may_have_expired": {
+        "description": "Always false. Codes more than 60 days old whose end date is unknown or a placeholder are left out; the field is kept for compatibility.",
+        "type": "boolean"
+      },
+      "merchant": {
+        "type": "string"
+      },
+      "merchant_display": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "min_spend": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "needs_recheck": {
+        "description": "Demoted: recently reported as not working.",
+        "type": "boolean"
+      },
+      "outbound_url": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "recheck_label": {
+        "description": "Short label to show with a needs-recheck offer (\"Recently reported as not working\").",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "restrictions": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "scope": {
+        "description": "\"product\": the code works only on the one item in applies_to. Offer it only for that item and never as a store-wide code. \"store\": not limited to one product in the feed (store terms still apply).",
+        "enum": [
+          "store",
+          "product"
+        ],
+        "type": "string"
+      },
+      "scope_note": {
+        "description": "For a product code, says which item it is for, e.g. \"DYUV: for the Dyson V11 Upright Cordless Stick Vacuum only, not store-wide\"; null otherwise.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "source_network": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "starts_at": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "tracked": {
+        "type": "boolean"
+      },
+      "verified": {
+        "description": "Verified means a recent shopper reported this code worked at checkout (more worked than failed reports in the last 14 days). It is not a guarantee; codes can still fail. Verified codes rank first.",
+        "type": "boolean"
+      }
+    },
+    "type": "object"
+  },
+  "type": "array"
+}

Previous value: -"An exclusive Clippy code the store's affiliate program gave Clippy directly (label it \"Exclusive Clippy code\"). Same rules as every other offer."New value: +"An exclusive McClipFace code the store's affiliate program gave McClipFace directly (label it \"Exclusive McClipFace code\"). Same rules as every other offer."

Added value: +{
+  "description": "Date (YYYY-MM-DD) of the latest report that the code worked at checkout, when verified; else null. Not a guarantee; codes can still fail.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Verified means a recent shopper reported this code worked at checkout (more worked than failed reports in the last 14 days). It is not a guarantee; codes can still fail. Verified codes rank first.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "get_deals only: the store and brand filters applied.",
+  "type": "object"
+}

Previous value: -"Product name, short and specific, e.g. \"iphone\", \"dyson v11\" or \"macbook air\". Not a store name: use find_coupons for a store."New value: +"Product name, short and specific, e.g. \"dyson\" or \"Dyson vacuum\". Not a store name: use find_coupons for a store."

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