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": "Show second, as a fallback: the raw code for a shopper already in the store's app. Only with a code.",
+  "type": "string"
+}

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

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"
+    },
+    "cta_label": {
+      "type": "string"
+    },
+    "expiry_display": {
+      "type": "string"
+    },
+    "subtitle": {
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

Previous value: -"find_coupons, when an offer has a code or deal: the one-time Community mode question and when to report (only with the shopper's agreement)."New value: +"find_coupons, when an offer has a code or deal: when to report (only with the shopper's agreement, as report_coupon_result says)."

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: -"Number of deals, 1-20. Defaults to 5."New value: +"Number of deals, 1-20 (default 5)."

Previous value: -"find_coupons with target_url only (absent otherwise): a shopping link straight to that page at the store. status \"built\": url is that page's shopping link, used instead of entry_url when the shopper chooses it. status \"not_available\": no deep link for this store or page (reason says why); use entry_url as usual. Built Feedico links may still open the programme's usual landing page (note says so when that applies)."New value: +"find_coupons with target_url only: status \"built\": url is that page's shopping link, used instead of entry_url when the shopper chooses it; \"not_available\": use entry_url (reason says why). A built Feedico link may still open the programme's usual landing page (note says so)."

Previous value: -"When status is built for a Feedico goUrl: the store's programme may still open its usual landing page. Absent or null otherwise."New value: +"Built Feedico goUrl only: the programme may still open its usual landing page."

Previous value: -"find_coupons with target_urls only (absent otherwise): one deep link per address, in the same order. Each item is like deep_link, plus index (its position in target_urls, from 0); reason invalid_target means that address can't be used."New value: +"find_coupons with target_urls only: one item per address, in order, like deep_link plus index; reason invalid_target means that address can't be used."

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: -"A short explanation, e.g. find_coupons with store_match none."New value: +"A short explanation, e.g. why store_match is none."

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."

Previous value: -"find_coupons only, when an offer has a code or a no-code deal: the one-time Community mode question, and when and how to report a result (only with the shopper's agreement)."New value: +"find_coupons, when an offer has a code or deal: the one-time Community mode question and when to report (only with the shopper's agreement)."

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: -"find_coupons only, when an offer has a code or a no-code deal: when and how to report the result (only with the shopper's agreement)."New value: +"find_coupons only, when an offer has a code or a no-code deal: the one-time Community mode question, and when and how to report a result (only with the shopper's agreement)."

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"
-}

Removed value: -{
-  "default": false,
-  "description": "Optional: true includes weapons, vape, tobacco, smoke shop, CBD/THC and adult stores, which are left out by default. Set it only when the shopper asked for those categories.",
-  "type": "boolean"
-}

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."

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: -"find_coupons with target_url only (absent otherwise): a shopping link straight to that page at the store. status \"built\": open url in place of entry_url. status \"not_available\": no deep link for this store or page (reason says why); use entry_url as usual. Built Feedico links may still open the programme's usual landing page (note says so when that applies)."New value: +"find_coupons with target_url only (absent otherwise): a shopping link straight to that page at the store. status \"built\": url is that page's shopping link, used instead of entry_url when the shopper chooses it. status \"not_available\": no deep link for this store or page (reason says why); use entry_url as usual. Built Feedico links may still open the programme's usual landing page (note says so when that applies)."

Previous value: -"find_coupons only, when an offer has a code or a no-code deal: when and how to report the result (Community mode only)."New value: +"find_coupons only, when an offer has a code or a no-code deal: when and how to report the result (only with the shopper's agreement)."

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: -"Optional: true includes weapons, vape, tobacco, smoke shop and CBD/THC stores, which are left out by default. Set it only when the shopper asked for those categories."New value: +"Optional: true includes weapons, vape, tobacco, smoke shop, CBD/THC and adult stores, which are left out by default. Set it only when the shopper asked for those categories."

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: -"Optional: true includes weapons, vape, tobacco, smoke shop, CBD/THC and adult stores, which are left out by default. Set it only when the shopper asked for those categories."New value: +"Optional: true includes weapons, vape, tobacco, smoke shop and CBD/THC stores, which are left out by default. Set it only when the shopper asked for those categories."

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."

Added value: +{
+  "description": "find_coupons with target_urls only (absent otherwise): one deep link per address, in the same order. Each item is like deep_link, plus index (its position in target_urls, from 0); reason invalid_target means that address can't be used.",
+  "items": {
+    "properties": {
+      "index": {
+        "type": "integer"
+      },
+      "network": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "note": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "offer_id": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "reason": {
+        "enum": [
+          null,
+          "partner_link_unchanged",
+          "deep_link_not_allowed",
+          "no_tracked_link",
+          "no_offers",
+          "off_site",
+          "unknown_store_domain",
+          "invalid_target"
+        ],
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "status": {
+        "enum": [
+          "built",
+          "not_available"
+        ],
+        "type": "string"
+      },
+      "url": {
+        "type": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "type": "object"
+  },
+  "type": "array"
+}

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: -"find_coupons with target_url only (absent otherwise): a shopping link straight to that page at the store. status \"built\": open url in place of outbound_url. status \"not_available\": no deep link for this store or page (reason says why); use outbound_url as usual. Built Feedico links may still open the programme's usual landing page (note says so when that applies)."New value: +"find_coupons with target_url only (absent otherwise): a shopping link straight to that page at the store. status \"built\": open url in place of entry_url. status \"not_available\": no deep link for this store or page (reason says why); use entry_url as usual. Built Feedico links may still open the programme's usual landing page (note says so when that applies)."

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: +{
+  "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: -"find_coupons only, when an offer has a code: when and how to report the code's result (Community mode only)."New value: +"find_coupons only, when an offer has a code or a no-code deal: when and how to report the result (Community mode only)."

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"
+  ]
+}

Previous value: -"find_coupons with target_url only (absent otherwise): a shopping link straight to that page at the store. status \"built\": open url in place of outbound_url. status \"not_available\": no deep link for this store or page (reason says why); use outbound_url as usual. Store links from the coupon data partner are never changed, so its stores return not_available."New value: +"find_coupons with target_url only (absent otherwise): a shopping link straight to that page at the store. status \"built\": open url in place of outbound_url. status \"not_available\": no deep link for this store or page (reason says why); use outbound_url as usual. Built Feedico links may still open the programme's usual landing page (note says so when that applies)."

Added value: +{
+  "description": "When status is built for a Feedico goUrl: the store's programme may still open its usual landing page. Absent or null otherwise.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Previous value: -[
-  null,
-  "partner_link_unchanged",
-  "deep_link_not_allowed",
-  "no_tracked_link",
-  "no_offers"
-]New value: +[
+  null,
+  "partner_link_unchanged",
+  "deep_link_not_allowed",
+  "no_tracked_link",
+  "no_offers",
+  "off_site",
+  "unknown_store_domain"
+]

Added value: +{
+  "description": "find_coupons only, when an offer has a code: when and how to report the code's result (Community mode only).",
+  "type": "string"
+}

Added value: +{
+  "description": "find_coupons with target_url only (absent otherwise): a shopping link straight to that page at the store. status \"built\": open url in place of outbound_url. status \"not_available\": no deep link for this store or page (reason says why); use outbound_url as usual. Store links from the coupon data partner are never changed, so its stores return not_available.",
+  "properties": {
+    "network": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "offer_id": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "reason": {
+      "enum": [
+        null,
+        "partner_link_unchanged",
+        "deep_link_not_allowed",
+        "no_tracked_link",
+        "no_offers"
+      ],
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "status": {
+      "enum": [
+        "built",
+        "not_available"
+      ],
+      "type": "string"
+    },
+    "url": {
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "type": "object"
+}

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: +{
+  "default": false,
+  "description": "Optional: true includes weapons, vape, tobacco, smoke shop, CBD/THC and adult stores, which are left out by default. Set it only when the shopper asked for those categories.",
+  "type": "boolean"
+}

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": "A short explanation, e.g. find_coupons with store_match none.",
+  "type": "string"
+}

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

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": "Optional: only deals from a store with this name or whose offer text names it, e.g. \"Dyson\".",
+  "maxLength": 100,
+  "minLength": 1,
+  "type": "string"
+}

Previous value: -"Number of deals, 1-10. Defaults to 5."New value: +"Number of deals, 1-20. Defaults to 5."

Previous value: -10New value: +20

Added value: +{
+  "description": "Optional: only deals from these stores, one name or up to 10 comma-separated, e.g. \"Tommy John, DHgate\".",
+  "maxLength": 500,
+  "minLength": 1,
+  "type": "string"
+}

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

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

Added value: +{
+  "description": "The product a scope \"product\" code is for; null otherwise.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

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

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