travel-insurance

Previous value: -"Language the user is conversing in, as a BCP 47 tag or 2-letter code (e.g. \"fr\", \"pt-BR\"). The widget and all offer texts are localized with it; without it, the language the assistant app sends is used, then English."New value: +"Language the user is writing in, as a BCP 47 tag or 2-letter code (e.g. \"fr\", \"pt-BR\"): the widget and all offer texts are localized with it, so when it is set the quote follows the user's language even if it differs from the app UI. When it is absent, the host UI locale is used if the host provides one (not every host does), then English; the quote never depends on a host locale being present."

Previous value: -"Trip length in days. Use this instead of endDate when the user gave a duration (e.g. \"20 days\") — the server computes endDate = startDate + durationDays."New value: +"Trip length in whole days; the server computes endDate = startDate + durationDays. One of durationDays or endDate gives the trip length (not for an annual or expat cover). It is not defaulted: a wrong length gives a wrong price."

Previous value: -"Trip end date (YYYY-MM-DD). Either endDate or durationDays must be provided (or use intent=\"annual\"/\"expat\")."New value: +"Trip end date (YYYY-MM-DD). The quote needs the trip length: endDate or durationDays (not for an annual or expat cover, which runs a year). It comes from the dates or duration given and is not defaulted, because a wrong length gives a wrong price."

Previous value: -"Exact HelloSafe card ID from a previous call — use it to re-check a specific candidate instead of fuzzy matching."New value: +"Exact HelloSafe card ID from a previous call: it re-checks that card instead of matching by name."

Previous value: -"Card name as the user said it, expanded (\"American Express Platinum\", not \"Amex Plat\"). Include the bank when known (\"Chase Sapphire Reserve\"). Omit only when cardId is provided."New value: +"Card name as the user said it, expanded (\"American Express Platinum\", not \"Amex Plat\"), with the bank when known (\"Chase Sapphire Reserve\"). Not needed when cardId is given."

Previous value: -"Language the user is conversing in, as a BCP 47 tag or 2-letter code (e.g. \"fr\", \"pt-BR\"). ALWAYS pass it."New value: +"Language the user is conversing in, as a BCP 47 tag or 2-letter code (e.g. \"fr\", \"pt-BR\"). Guarantee labels are localized with it."

Previous value: -"Optional trip details — sharpen the gap analysis. Omit what you do not know."New value: +"Optional trip details; they sharpen the gap analysis."

Added value: +"Context of the result: what the widget shows and the facts behind the analysis."

Added value: +{
+  "description": "Facts behind the analysis: sources, what the widget shows, the travel gaps for the trip.",
+  "type": "string"
+}

Added value: +"Not sent (see context)."

Previous value: -"Other cards matching the query. If the analysed card is not the user's, ask which one and call again with its cardId."New value: +"Other cards matching the query; any of their ids can be passed back as cardId."

Previous value: -"HelloSafe card ID — pass to get_quote as `cardId` to get offers that complement this card, or back to this tool to re-check a specific candidate."New value: +"HelloSafe card ID: as `cardId`, get_quote ranks offers by how well they complement this card, and this tool re-checks it."

Previous value: -"True when cancellation is the ONLY gap — suggest a cancellation-only policy (intent \"cancellation\" in get_quote), usually much cheaper."New value: +"True when cancellation is the ONLY gap: a cancellation-only policy (get_quote intent \"cancellation\") is then usually much cheaper than full cover."

Previous value: -"HelloSafe card ID — pass to get_quote as `cardId` to get offers that complement this card, or back to this tool to re-check a specific candidate."New value: +"HelloSafe card ID: as `cardId`, get_quote ranks offers by how well they complement this card, and this tool re-checks it."

Previous value: -"Core guarantees with no data on this card — phrase as \"not documented, check your contract\", never as \"not covered\"."New value: +"Core guarantees with no data on this card: not documented in HelloSafe's data, which is not the same as not covered."

Previous value: -"Cancel For Any Reason option, like trip cancellation: an add-on bought with the policy (extra cost, a purchase window counted from the first trip payment, usually 75 % of prepaid costs refunded). Sold to US residents only, on a forTourism, cruise or cancellation trip; true keeps the offers that sell it. Set it only when the user asks for it."New value: +"Cancel For Any Reason option, like trip cancellation: an add-on bought with the policy (extra cost, a purchase window counted from the first trip payment, usually 75 % of prepaid costs refunded). Sold to US residents only, on a forTourism, cruise or cancellation trip; true keeps the offers that sell it. Defaults to false."

Previous value: -"HelloSafe card ID returned by check_card_coverage. Pass it when the user holds a credit card with travel cover: offers are then re-ranked by how well they fill that card's coverage gaps, and each offer lists what it adds over the card (complementsCard)."New value: +"HelloSafe card ID returned by check_card_coverage, for a user who holds a credit card with travel cover: offers are then re-ranked by how well they fill that card's coverage gaps, and each offer lists what it adds over the card (complementsCard)."

Previous value: -"ISO 4217 code to override the widget display currency. Omit unless the user explicitly asked for a different display currency than the trip-cost currency."New value: +"ISO 4217 code of a display currency other than the trip-cost currency. Without it, amounts are shown in the trip-cost currency."

Previous value: -"Language the user is conversing in, as a BCP 47 tag or 2-letter code (e.g. \"fr\", \"pt-BR\"). ALWAYS pass it — the widget and all offer texts are localized with it. Falls back to the ChatGPT account locale, then to English."New value: +"Language the user is conversing in, as a BCP 47 tag or 2-letter code (e.g. \"fr\", \"pt-BR\"). The widget and all offer texts are localized with it; without it, the language the assistant app sends is used, then English."

Previous value: -"Optional filter on policy features, the guarantee filters of the HelloSafe comparison site: only the offers whose contract includes every listed cover are returned, that cover listed first. maternityCover = covers pregnancy; preExistingConditionsCover = covers pre-existing medical conditions; personalLiability; baggage; travelDelay; directHospitalBilling = the insurer pays the hospital directly; disability; searchAndRescue; earlyReturn; tripInterruption; electronics = electronic devices; cashAdvance; expatMaternity, expatDental, expatOptical (expatriates). Each trip purpose has its own filters, as on the site; a cover that is not one of them is ignored and reported. Set it only when the user explicitly asks for a policy that includes this cover; the tool never asks the user about their health. It changes neither prices nor eligibility; health-related covers are not stored."New value: +"Optional filter on policy features, the guarantee filters of the HelloSafe comparison site: only the offers whose contract includes every listed cover are returned, that cover listed first. maternityCover = covers pregnancy; preExistingConditionsCover = covers pre-existing medical conditions; personalLiability; baggage; travelDelay; directHospitalBilling = the insurer pays the hospital directly; disability; searchAndRescue; earlyReturn; tripInterruption; electronics = electronic devices; cashAdvance; expatMaternity, expatDental, expatOptical (expatriates). Each trip purpose has its own filters, as on the site; a cover that is not one of them is ignored and reported. Used when the user asks for a policy that includes this cover; it changes neither prices nor eligibility, and health-related covers are not stored."

Previous value: -"Destination countries as ISO 3166-1 alpha-2 codes. Prefer an array ([\"TH\",\"VN\"]); a comma-separated string also works. \"WW\" = the whole world (intents forTourism, cruise, digitalNomad); \"SCH\" = the whole Schengen area (intent schengenArea). Required, EXCEPT for intent \"annual\": a yearly multi-trip cover is worldwide, so never ask for a destination then — omit it."New value: +"Destination countries as ISO 3166-1 alpha-2 codes, as an array ([\"TH\",\"VN\"]) or a comma-separated string. \"WW\" = the whole world (forTourism, cruise, digitalNomad); \"SCH\" = the whole Schengen area (schengenArea). Required, except for intent \"annual\": a yearly multi-trip cover is worldwide and uses no destination."

Previous value: -"User's country of residence as ISO 3166-1 alpha-2 code (e.g. \"FR\"). Ask the user if they did not state it — do not infer from destination or chat language."New value: +"User's country of residence as ISO 3166-1 alpha-2 code (e.g. \"FR\"). It decides which insurers can cover the traveller; it cannot be deduced from the destination or the conversation language."

Previous value: -"ISO 4217 code for tripPrice. Defaults to the currency of countryResidence. Only pass if the user gave an explicit amount in another currency."New value: +"ISO 4217 code for tripPrice. Defaults to the currency of countryResidence."

Previous value: -"Trip purpose. Map from the user message when clear: leisure / holidays / sightseeing → \"forTourism\"; study abroad, Erasmus, internship → \"studyInternship\"; working-holiday visa (PVT) → \"whv\"; yearly multi-trip cover → \"annual\"; long-term relocation → \"expat\"; cancellation-only (no medical) → \"cancellation\"; ski / trek / mountaineering → \"forTourism\" with the extreme sports option; cruise → \"cruise\"; remote-work nomading → \"digitalNomad\"; group of 10+ travellers → \"groupTravel\"; Schengen visa application → \"schengenArea\"; humanitarian mission or volunteering → \"humanitarian\"; au pair placement → \"auPair\"; a business trip, a visit back home or a rental stay → \"forTourism\". If you cannot confidently map the user's situation to one of these values, ASK THE USER which purpose fits best — do not guess. Note: \"annual\" and \"expat\" automatically force isAnnual=true."New value: +"Trip purpose. Leisure, holidays, sightseeing, a business trip, a visit back home or a rental stay → \"forTourism\"; study abroad, Erasmus, internship → \"studyInternship\"; working-holiday visa (PVT) → \"whv\"; yearly multi-trip cover → \"annual\"; long-term relocation → \"expat\"; cancellation-only (no medical) → \"cancellation\"; ski / trek / mountaineering → \"forTourism\" with the extreme sports option; cruise → \"cruise\"; remote-work nomading → \"digitalNomad\"; group of 10+ travellers → \"groupTravel\"; Schengen visa application → \"schengenArea\"; humanitarian mission or volunteering → \"humanitarian\"; au pair placement → \"auPair\". The purpose decides which policies are offered: a wrong one gives offers built for another trip. Defaults to \"forTourism\". \"annual\" and \"expat\" set isAnnual=true."

Previous value: -"Cover extreme sports (mountaineering, off-piste skiing, diving, paragliding, climbing). Defaults to false; set true only if the user mentioned such activities."New value: +"Extreme sports option (mountaineering, off-piste skiing, diving, paragliding, climbing), added to the policy at extra cost like trip cancellation. Defaults to false; only relevant when the trip includes such activities."

Previous value: -"State of residence as its USPS 2-letter code (e.g. \"CA\", \"TX\") — for US residents only, ignored for every other country. US travel insurance is regulated state by state, so when countryResidence is \"US\" ASK THE USER which state they live in and pass it; never guess it from the destination or the chat language. No quote is computed without it. The US territories are countries here, not states (a Puerto Rico resident is countryResidence \"PR\", never \"US\" + \"PR\")."New value: +"State of residence as its USPS 2-letter code (e.g. \"CA\", \"TX\"). Required for a US resident: US travel insurance is regulated state by state, and no quote is computed without it. Ignored for every other country. The US territories are countries here, not states (a Puerto Rico resident is countryResidence \"PR\", never \"US\" + \"PR\")."

Previous value: -"TOTAL trip cost for ALL travellers (not per traveller). Omit unless the user explicitly asked for cancellation coverage."New value: +"TOTAL trip cost for ALL travellers (not per traveller). Only used by cancellation coverage."

Previous value: -"Guidance for the assistant reply — follow \"instruction\"."New value: +"Context of the result: what the widget already shows, how offers were ranked, and a summary of the recommended offer."

Added value: +{
+  "description": "Facts about what the widget shows and how the offers were ranked.",
+  "type": "string"
+}

Previous value: -"How the assistant should present the result to the user."New value: +"Not sent (see context)."

Previous value: -"HelloSafe comparator URL for this quote. The widget already renders it as a button — never paste it in the reply."New value: +"HelloSafe comparator URL for this quote, where the user compares and buys. The widget shows it as a button on each offer."

Previous value: -"HelloSafe comparator URL for this quote. The widget already renders clickable buttons — never paste it in the reply."New value: +"HelloSafe comparator URL for this quote, where the user compares and buys. The widget shows it as a button on each offer."

Previous value: -"Quote session ID — pass it back as `subscriptionId` to update this quote instead of creating a new one."New value: +"Quote session ID; sent back as `subscriptionId`, it updates this quote instead of creating a new one."

Added value: +{
+  "description": "Cancel For Any Reason option, like trip cancellation: an add-on bought with the policy (extra cost, a purchase window counted from the first trip payment, usually 75 % of prepaid costs refunded). Sold to US residents only, on a forTourism, cruise or cancellation trip; true keeps the offers that sell it. Set it only when the user asks for it.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Optional filter on policy features, the guarantee filters of the HelloSafe comparison site: only the offers whose contract includes every listed cover are returned, that cover listed first. maternityCover = covers pregnancy; preExistingConditionsCover = covers pre-existing medical conditions; personalLiability; baggage; travelDelay; directHospitalBilling = the insurer pays the hospital directly; disability; searchAndRescue; earlyReturn; tripInterruption; electronics = electronic devices; cashAdvance; expatMaternity, expatDental, expatOptical (expatriates). Each trip purpose has its own filters, as on the site; a cover that is not one of them is ignored and reported. Set it only when the user explicitly asks for a policy that includes this cover; the tool never asks the user about their health. It changes neither prices nor eligibility; health-related covers are not stored.",
+  "items": {
+    "enum": [
+      "maternityCover",
+      "preExistingConditionsCover",
+      "personalLiability",
+      "baggage",
+      "travelDelay",
+      "directHospitalBilling",
+      "disability",
+      "searchAndRescue",
+      "earlyReturn",
+      "tripInterruption",
+      "electronics",
+      "cashAdvance",
+      "expatMaternity",
+      "expatDental",
+      "expatOptical"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}

Previous value: -[
-  {
-    "items": {
-      "pattern": "^[A-Za-z]{2}$",
-      "type": "string"
-    },
-    "type": "array"
-  },
-  {
-    "type": "string"
-  }
-]New value: +[
+  {
+    "items": {
+      "pattern": "^([A-Za-z]{2}|SCH|sch)$",
+      "type": "string"
+    },
+    "type": "array"
+  },
+  {
+    "type": "string"
+  }
+]

Previous value: -"Destination countries as ISO 3166-1 alpha-2 codes. Prefer an array ([\"TH\",\"VN\"]); a comma-separated string also works. Required, EXCEPT for intent \"annual\": a yearly multi-trip cover is worldwide, so never ask for a destination then — omit it."New value: +"Destination countries as ISO 3166-1 alpha-2 codes. Prefer an array ([\"TH\",\"VN\"]); a comma-separated string also works. \"WW\" = the whole world (intents forTourism, cruise, digitalNomad); \"SCH\" = the whole Schengen area (intent schengenArea). Required, EXCEPT for intent \"annual\": a yearly multi-trip cover is worldwide, so never ask for a destination then — omit it."

Previous value: -"State of residence as its USPS 2-letter code (e.g. \"CA\", \"TX\") — for US residents only, ignored for every other country. US travel insurance is regulated state by state, so when countryResidence is \"US\" ASK THE USER which state they live in and pass it; never guess it from the destination or the chat language. The quote is still produced without it. The US territories are countries here, not states (a Puerto Rico resident is countryResidence \"PR\", never \"US\" + \"PR\")."New value: +"State of residence as its USPS 2-letter code (e.g. \"CA\", \"TX\") — for US residents only, ignored for every other country. US travel insurance is regulated state by state, so when countryResidence is \"US\" ASK THE USER which state they live in and pass it; never guess it from the destination or the chat language. No quote is computed without it. The US territories are countries here, not states (a Puerto Rico resident is countryResidence \"PR\", never \"US\" + \"PR\")."

Previous value: -"What the contract of each offer states on four guarantees, for every offer that documents them (contract facts, the same for every buyer): pregnancyCover (value = last covered week of pregnancy, e.g. \"35 wks\"), preExistingConditions (illnesses known before departure), seniorConditions (value = maximum age covered, in years), cancelAnyReason (Cancel For Any Reason, US residents only: value = share of prepaid non-refundable costs refunded; always an add-on bought with the policy at extra cost, not in priceFullText). covered=false means the offer does not cover it. description is HelloSafe's summary of the contract for this trip purpose."New value: +"What the contract of each offer states on four guarantees, for every offer that documents them (contract facts, the same for every buyer): pregnancyCover (value = last covered week of pregnancy, e.g. \"35 wks\"), preExistingConditions (illnesses known before departure), seniorConditions (value = maximum age covered, in years), cancelAnyReason (Cancel For Any Reason, US residents only: value = share of prepaid non-refundable costs refunded; always an add-on bought with the policy at extra cost, not in priceFullText). covered=false means the offer does not cover it. description is HelloSafe's summary of the contract for this trip purpose; exclusions is given for the covers asked with requiredCoverages or cancelForAnyReason."

Added value: +{
+  "additionalProperties": {
+    "additionalProperties": {},
+    "properties": {
+      "covered": {
+        "type": "boolean"
+      },
+      "description": {
+        "type": "string"
+      },
+      "exclusions": {
+        "type": "string"
+      },
+      "value": {
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "description": "What the contract of each offer states on four guarantees, for every offer that documents them (contract facts, the same for every buyer): pregnancyCover (value = last covered week of pregnancy, e.g. \"35 wks\"), preExistingConditions (illnesses known before departure), seniorConditions (value = maximum age covered, in years), cancelAnyReason (Cancel For Any Reason, US residents only: value = share of prepaid non-refundable costs refunded; always an add-on bought with the policy at extra cost, not in priceFullText). covered=false means the offer does not cover it. description is HelloSafe's summary of the contract for this trip purpose.",
+  "propertyNames": {
+    "type": "string"
+  },
+  "type": "object"
+}

Previous value: -"The card's FULL guarantee sheet, grouped by section (travel first) — render as one markdown table per section: Guarantee | Your card | Recommended | Verdict."New value: +"The card's FULL guarantee sheet, grouped by section (travel first). Shown in the widget."

Added value: +{
+  "additionalProperties": {},
+  "description": "Data rendered by the card widget (gaps, catches, full sheet) — not meant for the assistant.",
+  "properties": {},
+  "type": "object"
+}

Added value: +{
+  "additionalProperties": {},
+  "description": "Localized UI strings consumed by the widget — not meant for the assistant.",
+  "propertyNames": {
+    "type": "string"
+  },
+  "type": "object"
+}

Previous value: -"Destination countries as ISO 3166-1 alpha-2 codes. Prefer an array ([\"TH\",\"VN\"]); a comma-separated string also works."New value: +"Destination countries as ISO 3166-1 alpha-2 codes. Prefer an array ([\"TH\",\"VN\"]); a comma-separated string also works. Required, EXCEPT for intent \"annual\": a yearly multi-trip cover is worldwide, so never ask for a destination then — omit it."

Previous value: -[
-  "countryResidence",
-  "arrivalCountries",
-  "travellers"
-]New value: +[
+  "countryResidence",
+  "travellers"
+]

Previous value: -"Trip purpose when known — same values as get_quote (forTourism, mountainTrip, schengenArea…). Drives the thresholds (e.g. ski cover checked for mountainTrip)."New value: +"Trip purpose when known — same values as get_quote (forTourism, schengenArea, studyInternship…). Drives the thresholds."

Previous value: -"Trip purpose. Map from the user message when clear: leisure / holidays / sightseeing → \"forTourism\"; study abroad, Erasmus, internship → \"studyInternship\"; working-holiday visa (PVT) → \"whv\"; yearly multi-trip cover → \"annual\"; long-term relocation → \"expat\"; cancellation-only (no medical) → \"cancellation\"; ski / trek / mountaineering → \"mountainTrip\"; cruise → \"cruise\"; remote-work nomading → \"digitalNomad\"; group of 10+ travellers → \"groupTravel\"; Schengen visa application → \"schengenArea\"; humanitarian mission or volunteering → \"humanitarian\"; au pair placement → \"auPair\"; business / work trip → \"toWork\"; returning home for a visit → \"backToHome\"; rental / Airbnb stay focus → \"rentalStay\". If you cannot confidently map the user's situation to one of these values, ASK THE USER which purpose fits best — do not guess. Note: \"annual\" and \"expat\" automatically force isAnnual=true."New value: +"Trip purpose. Map from the user message when clear: leisure / holidays / sightseeing → \"forTourism\"; study abroad, Erasmus, internship → \"studyInternship\"; working-holiday visa (PVT) → \"whv\"; yearly multi-trip cover → \"annual\"; long-term relocation → \"expat\"; cancellation-only (no medical) → \"cancellation\"; ski / trek / mountaineering → \"forTourism\" with the extreme sports option; cruise → \"cruise\"; remote-work nomading → \"digitalNomad\"; group of 10+ travellers → \"groupTravel\"; Schengen visa application → \"schengenArea\"; humanitarian mission or volunteering → \"humanitarian\"; au pair placement → \"auPair\"; a business trip, a visit back home or a rental stay → \"forTourism\". If you cannot confidently map the user's situation to one of these values, ASK THE USER which purpose fits best — do not guess. Note: \"annual\" and \"expat\" automatically force isAnnual=true."

Previous value: -[
-  "forTourism",
-  "schengenArea",
-  "annual",
-  "studyInternship",
-  "whv",
-  "cruise",
-  "digitalNomad",
-  "expat",
-  "groupTravel",
-  "rentalStay",
-  "mountainTrip",
-  "backToHome",
-  "humanitarian",
-  "auPair",
-  "toWork",
-  "cancellation"
-]New value: +[
+  "forTourism",
+  "schengenArea",
+  "annual",
+  "studyInternship",
+  "whv",
+  "cruise",
+  "digitalNomad",
+  "expat",
+  "groupTravel",
+  "humanitarian",
+  "auPair",
+  "cancellation"
+]

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "coverages": {
-        "additionalProperties": {
-          "type": "string"
-        },
-        "description": "Coverage label → covered amount for the recommended offer.",
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "insurerName": {
-        "type": "string"
-      },
-      "name": {
-        "type": "string"
-      },
-      "price": {
-        "type": "string"
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "coverages": {
+        "additionalProperties": {
+          "type": "string"
+        },
+        "description": "Coverage label → covered amount for the recommended offer.",
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "insurerName": {
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      },
+      "optionsNotTaken": {
+        "additionalProperties": {
+          "type": "string"
+        },
+        "description": "Options available on the recommended offer that this quote does NOT include (not covered unless the user adds them).",
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "price": {
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Added value: +{
+  "additionalProperties": {
+    "type": "string"
+  },
+  "description": "Second line of a feature row, part of that guarantee: on cancelTrip, the covered cancellation reasons (e.g. \"Any justified reason\"). They share the verdict of cancelTrip — never a cover of their own.",
+  "propertyNames": {
+    "type": "string"
+  },
+  "type": "object"
+}

Previous value: -"Coverage feature slug → formatted covered amount, already filtered for the trip purpose and converted to the display currency."New value: +"Coverage feature slug → formatted covered amount, already filtered for the trip purpose and converted to the display currency. Slugs listed in optionalFeatures are NOT covered: they are options the traveller has not added (value \"Optional\"). When cancellation is an option, its covered reasons are in featureDetails.cancelTrip, part of that guarantee and never covered on their own; on a cancellation-only trip they are their own cancellationReasons entry."

Added value: +{
+  "description": "Feature slugs of `features` that this offer does NOT cover (value \"Not included\"), listed last like the results page's \"Not covered\" section.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Feature slugs of `features` that are options NOT taken on this quote (trip cancellation, studies interruption, extreme sports): available on the offer, not covered.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Feature slugs of the options the traveller added on this quote (trip cancellation, extreme sports, studies interruption): covered, and part of their quote.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "State of residence as its USPS 2-letter code (e.g. \"CA\", \"TX\") — for US residents only, ignored for every other country. US travel insurance is regulated state by state, so when countryResidence is \"US\" ASK THE USER which state they live in and pass it; never guess it from the destination or the chat language. The quote is still produced without it. The US territories are countries here, not states (a Puerto Rico resident is countryResidence \"PR\", never \"US\" + \"PR\").",
+  "pattern": "^[A-Za-z]{2}$",
+  "type": "string"
+}

Added value: +{
+  "description": "HelloSafe card ID returned by check_card_coverage. Pass it when the user holds a credit card with travel cover: offers are then re-ranked by how well they fill that card's coverage gaps, and each offer lists what it adds over the card (complementsCard).",
+  "type": "number"
+}

Previous value: -"Language of the user. Defaults to the host locale."New value: +"Language the user is conversing in, as a BCP 47 tag or 2-letter code (e.g. \"fr\", \"pt-BR\"). ALWAYS pass it — the widget and all offer texts are localized with it. Falls back to the ChatGPT account locale, then to English."

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "_assistantGuidance": {
+      "additionalProperties": {},
+      "description": "Guidance for the assistant reply — follow \"instruction\".",
+      "properties": {
+        "instruction": {
+          "description": "How the assistant should present the result to the user.",
+          "type": "string"
+        },
+        "recommendedOffer": {
+          "anyOf": [
+            {
+              "additionalProperties": {},
+              "properties": {
+                "coverages": {
+                  "additionalProperties": {
+                    "type": "string"
+                  },
+                  "description": "Coverage label → covered amount for the recommended offer.",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "type": "object"
+                },
+                "insurerName": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                },
+                "price": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Compact summary of the offer HelloSafe recommends for this trip."
+        }
+      },
+      "type": "object"
+    },
+    "cardContext": {
+      "additionalProperties": {},
+      "description": "Present only when the quote was computed against a card (cardId argument): the card and its gaps.",
+      "properties": {
+        "cancellationOnlyGap": {
+          "type": "boolean"
+        },
+        "cardId": {
+          "type": "number"
+        },
+        "cardName": {
+          "type": "string"
+        },
+        "gaps": {
+          "description": "The card coverage gaps that drove the offer ranking.",
+          "items": {},
+          "type": "array"
+        },
+        "unknown": {
+          "items": {},
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "displayOffers": {
+      "description": "Priced offers sorted by price, with the recommended offer (isBestScore=true) promoted first.",
+      "items": {
+        "additionalProperties": {},
+        "properties": {
+          "complementsCard": {
+            "description": "Only when the quote carries a cardId: labels of the card's coverage gaps this offer fills — what it adds over the user's card.",
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "faq": {
+            "description": "Frequently asked questions about this offer.",
+            "items": {},
+            "type": "array"
+          },
+          "features": {
+            "additionalProperties": {
+              "type": "string"
+            },
+            "description": "Coverage feature slug → formatted covered amount, already filtered for the trip purpose and converted to the display currency.",
+            "propertyNames": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "id": {
+            "description": "HelloSafe offer ID.",
+            "type": "number"
+          },
+          "insurerLogoUrl": {
+            "description": "Absolute URL of the insurer logo.",
+            "type": "string"
+          },
+          "insurerName": {
+            "description": "Insurer brand name.",
+            "type": "string"
+          },
+          "isBestScore": {
+            "description": "True for the single offer HelloSafe recommends for this trip (shown first).",
+            "type": "boolean"
+          },
+          "isStartingPrice": {
+            "description": "True when the price is a \"from\" price.",
+            "type": "boolean"
+          },
+          "name": {
+            "description": "Commercial name of the offer / formula.",
+            "type": "string"
+          },
+          "noList": {
+            "description": "Newline-separated list of exclusions.",
+            "type": "string"
+          },
+          "priceFullText": {
+            "description": "Total price for the whole trip and all travellers, formatted in the display currency (e.g. \"34,20 €\").",
+            "type": "string"
+          },
+          "priceParts": {
+            "additionalProperties": {},
+            "description": "Price split into rendering parts (used by the widget).",
+            "properties": {
+              "decimal": {
+                "type": "string"
+              },
+              "decimalSeparator": {
+                "type": "string"
+              },
+              "integer": {
+                "type": "string"
+              },
+              "symbol": {
+                "type": "string"
+              },
+              "symbolPosition": {
+                "description": "\"prefix\" or \"suffix\".",
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "subscribeUrl": {
+            "description": "HelloSafe comparator URL for this quote. The widget already renders it as a button — never paste it in the reply.",
+            "type": "string"
+          },
+          "suffix": {
+            "description": "Price period suffix key: \"perMonth\", \"perYear\", \"perDay\" or empty.",
+            "type": "string"
+          },
+          "topBanner": {
+            "description": "Short marketing highlight for this offer, if any.",
+            "type": "string"
+          },
+          "yesList": {
+            "description": "Newline-separated list of advantages.",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "error": {
+      "description": "Human-readable reason when the quote could not be generated. Absent on success.",
+      "type": "string"
+    },
+    "subscribeUrl": {
+      "description": "HelloSafe comparator URL for this quote. The widget already renders clickable buttons — never paste it in the reply.",
+      "type": "string"
+    },
+    "subscriptionId": {
+      "description": "Quote session ID — pass it back as `subscriptionId` to update this quote instead of creating a new one.",
+      "type": "string"
+    },
+    "translations": {
+      "additionalProperties": {},
+      "description": "Localized UI strings consumed by the widget — not meant for the assistant.",
+      "propertyNames": {
+        "type": "string"
+      },
+      "type": "object"
+    },
+    "tripInfo": {
+      "additionalProperties": {},
+      "description": "Normalized trip parameters the quote was computed with.",
+      "properties": {
+        "arrivalCountriesCodes": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "arrivalCountriesNames": {
+          "description": "Destination country names in the response locale.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "countryResidenceCode": {
+          "type": "string"
+        },
+        "countryResidenceName": {
+          "type": "string"
+        },
+        "currency": {
+          "description": "ISO 4217 currency the amounts are shown in.",
+          "type": "string"
+        },
+        "endDate": {
+          "type": "string"
+        },
+        "endDateLabel": {
+          "type": "string"
+        },
+        "intentName": {
+          "description": "Human-readable trip purpose.",
+          "type": "string"
+        },
+        "isAnnual": {
+          "type": "boolean"
+        },
+        "numberOfDays": {
+          "type": "number"
+        },
+        "shouldCoverCancellation": {
+          "type": "boolean"
+        },
+        "startDate": {
+          "type": "string"
+        },
+        "startDateLabel": {
+          "type": "string"
+        },
+        "travellers": {
+          "items": {
+            "additionalProperties": {},
+            "properties": {
+              "age": {
+                "type": "number"
+              }
+            },
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "tripBoughtDateLabel": {
+          "type": "string"
+        },
+        "tripPrice": {
+          "description": "Trip cost per traveller; -1 when not provided.",
+          "type": "number"
+        },
+        "tripPriceText": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    }
+  },
+  "type": "object"
+}

Previous value: -"Trip cost PER TRAVELLER (not the group total). Omit unless the user explicitly asked for cancellation coverage."New value: +"TOTAL trip cost for ALL travellers (not per traveller). Omit unless the user explicitly asked for cancellation coverage."

Previous value: -"Trip purpose. Map from the user message when clear: leisure / holidays / sightseeing → \"forTourism\"; study abroad, Erasmus, internship → \"studyInternship\"; working-holiday visa (PVT) → \"whv\"; yearly multi-trip cover → \"annual\"; long-term relocation → \"expat\"; cancellation-only (no medical) → \"cancellation\"; ski / trek / mountaineering → \"mountainTrip\"; cruise → \"cruise\"; remote-work nomading → \"digitalNomad\"; group of 10+ travellers → \"groupTravel\"; Schengen visa application → \"schengenArea\"; humanitarian mission or au pair → \"humanitarianAuPair\"; business / work trip → \"toWork\"; returning home for a visit → \"backToHome\"; rental / Airbnb stay focus → \"rentalStay\". If you cannot confidently map the user's situation to one of these values, ASK THE USER which purpose fits best — do not guess. Note: \"annual\" and \"expat\" automatically force isAnnual=true."New value: +"Trip purpose. Map from the user message when clear: leisure / holidays / sightseeing → \"forTourism\"; study abroad, Erasmus, internship → \"studyInternship\"; working-holiday visa (PVT) → \"whv\"; yearly multi-trip cover → \"annual\"; long-term relocation → \"expat\"; cancellation-only (no medical) → \"cancellation\"; ski / trek / mountaineering → \"mountainTrip\"; cruise → \"cruise\"; remote-work nomading → \"digitalNomad\"; group of 10+ travellers → \"groupTravel\"; Schengen visa application → \"schengenArea\"; humanitarian mission or volunteering → \"humanitarian\"; au pair placement → \"auPair\"; business / work trip → \"toWork\"; returning home for a visit → \"backToHome\"; rental / Airbnb stay focus → \"rentalStay\". If you cannot confidently map the user's situation to one of these values, ASK THE USER which purpose fits best — do not guess. Note: \"annual\" and \"expat\" automatically force isAnnual=true."

Previous value: -[
-  "forTourism",
-  "schengenArea",
-  "annual",
-  "studyInternship",
-  "whv",
-  "cruise",
-  "digitalNomad",
-  "expat",
-  "groupTravel",
-  "rentalStay",
-  "mountainTrip",
-  "backToHome",
-  "humanitarianAuPair",
-  "toWork",
-  "cancellation"
-]New value: +[
+  "forTourism",
+  "schengenArea",
+  "annual",
+  "studyInternship",
+  "whv",
+  "cruise",
+  "digitalNomad",
+  "expat",
+  "groupTravel",
+  "rentalStay",
+  "mountainTrip",
+  "backToHome",
+  "humanitarian",
+  "auPair",
+  "toWork",
+  "cancellation"
+]

Added value: +"ISO 4217 code to override the widget display currency. Omit unless the user explicitly asked for a different display currency than the trip-cost currency."

Added value: +"Language of the user. Defaults to the host locale."

Added value: +"Existing subscription ID to update instead of creating a new one."

Added value: +"Trip details."

Added value: +"Destination countries as ISO 3166-1 alpha-2 codes. Prefer an array ([\"TH\",\"VN\"]); a comma-separated string also works."

Added value: +"User's country of residence as ISO 3166-1 alpha-2 code (e.g. \"FR\"). Ask the user if they did not state it — do not infer from destination or chat language."

Added value: +"ISO 4217 code for tripPrice. Defaults to the currency of countryResidence. Only pass if the user gave an explicit amount in another currency."

Added value: +"Trip length in days. Use this instead of endDate when the user gave a duration (e.g. \"20 days\") — the server computes endDate = startDate + durationDays."

Added value: +"Trip end date (YYYY-MM-DD). Either endDate or durationDays must be provided (or use intent=\"annual\"/\"expat\")."

Added value: +"Trip purpose. Map from the user message when clear: leisure / holidays / sightseeing → \"forTourism\"; study abroad, Erasmus, internship → \"studyInternship\"; working-holiday visa (PVT) → \"whv\"; yearly multi-trip cover → \"annual\"; long-term relocation → \"expat\"; cancellation-only (no medical) → \"cancellation\"; ski / trek / mountaineering → \"mountainTrip\"; cruise → \"cruise\"; remote-work nomading → \"digitalNomad\"; group of 10+ travellers → \"groupTravel\"; Schengen visa application → \"schengenArea\"; humanitarian mission or au pair → \"humanitarianAuPair\"; business / work trip → \"toWork\"; returning home for a visit → \"backToHome\"; rental / Airbnb stay focus → \"rentalStay\". If you cannot confidently map the user's situation to one of these values, ASK THE USER which purpose fits best — do not guess. Note: \"annual\" and \"expat\" automatically force isAnnual=true."

Added value: +"Annual / multi-trip cover. Defaults to false (auto-true for intent=\"annual\" or \"expat\")."

Added value: +"Include trip cancellation coverage. Defaults to false."

Added value: +"Cover extreme sports (mountaineering, off-piste skiing, diving, paragliding, climbing). Defaults to false; set true only if the user mentioned such activities."

Added value: +"Trip start date (YYYY-MM-DD). Defaults to tomorrow when omitted."

Added value: +"Tuition fees to cover, in tripInfo.currency. Required when studiesInterruption=true."

Added value: +"Cover interrupted studies (intent=\"studyInternship\" only). Defaults to false. Requires studiesAmount when true."

Added value: +"All travellers covered by the policy, including children. Example: a couple aged 35 with a 5-year-old → [{age:35},{age:35},{age:5}]."

Added value: +"Age in years, 0–99."

Added value: +"Date the trip was booked (YYYY-MM-DD). Required when shouldCoverCancellation=true (most insurers require booking within ~30 days)."

Added value: +"Trip cost PER TRAVELLER (not the group total). Omit unless the user explicitly asked for cancellation coverage."

Added value: +{
+  "exclusiveMinimum": 0,
+  "maximum": 9007199254740991,
+  "type": "integer"
+}

Previous value: -[
-  "intent",
-  "startDate",
-  "endDate",
-  "countryResidence",
-  "arrivalCountries",
-  "tripPrice",
-  "currency",
-  "isAnnual",
-  "travellers"
-]New value: +[
+  "countryResidence",
+  "arrivalCountries",
+  "travellers"
+]

Previous value: -[
-  "locale",
-  "tripInfo"
-]New value: +[
+  "tripInfo"
+]

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