@burdenoff/website-sdk 2026.922.2 → 2026.922.4

package/dist/{explore-types-CLw19R76.d.mts → explore-types-DvQPiL1t.d.mts}

@@ -17,6 +17,18 @@
  */
 type ExploreMessageRole = "USER" | "ASSISTANT";
 type ExploreMessageStatus = "PENDING" | "RUNNING" | "COMPLETED" | "FAILED";
+/** `enum ExploreFeedbackRating` — the visitor's verdict on one answer. */
+type ExploreFeedbackRating = "HELPFUL" | "NOT_HELPFUL";
+/**
+ * The reasons offered alongside `NOT_HELPFUL`, in the order the chooser shows them.
+ *
+ * `reason` is `String` on the wire, not an enum, so this list is the SDK's half of the
+ * agreement rather than something the schema enforces — the same treatment
+ * {@link ExploreCtaKind} gets. Use the union when you are *producing* a reason; read one
+ * back as a plain string.
+ */
+declare const EXPLORE_FEEDBACK_REASONS: readonly ["INACCURATE", "INCOMPLETE", "OFF_TOPIC", "HARD_TO_FOLLOW", "OTHER"];
+type ExploreFeedbackReason = (typeof EXPLORE_FEEDBACK_REASONS)[number];
 /**
  * The `ExploreCta.kind` values enumerated in CONTRACT.md §1.
  *
@@ -56,6 +68,21 @@ interface ExploreCtaLink {
     url: string;
     product?: string | null;
 }
+/**
+ * `type ExploreFeedback` — what is on record for one answer, as the server holds it.
+ *
+ * A rating REPLACES the previous one (the server upserts on `messageId`), so this is the
+ * visitor's current opinion and never a history. `reason` is null for `HELPFUL` by
+ * definition, and typed `string` rather than the union because it is `String` on the wire —
+ * a reason added server-side must read back, not break the build of 38 websites.
+ */
+interface ExploreFeedback {
+    rating: ExploreFeedbackRating;
+    /** One of {@link EXPLORE_FEEDBACK_REASONS}. Null for `HELPFUL`. */
+    reason?: string | null;
+    comment?: string | null;
+    createdAt: string;
+}
 /** `type ExploreMessage`. `content` is `""` while the turn is PENDING. */
 interface ExploreMessage {
     id: string;
@@ -79,6 +106,16 @@ interface ExploreMessage {
     answered?: boolean | null;
     /** Files the visitor attached to this turn. Present on USER messages only. */
     attachments?: ExploreAttachment[] | null;
+    /**
+     * The rating this visitor already gave this answer, or null for an unrated one.
+     *
+     * Selected only by the reads scoped to a `conversationToken`, so a polled or restored
+     * transcript shows what was already rated instead of offering the row again. It is always
+     * null on a SHARED transcript — that read is performed by someone else, and the rater's
+     * verdict and free-text note are not theirs to receive. See
+     * `EXPLORE_OWN_MESSAGE_FIELDS`.
+     */
+    feedback?: ExploreFeedback | null;
     errorCode?: string | null;
     createdAt: string;
     completedAt?: string | null;
@@ -105,6 +142,27 @@ interface ExploreLimits {
     messagesPerDay: number;
     historyTurns: number;
 }
+/**
+ * `type ExploreConceptHighlight` — one published concept illustration, offered
+ * as a way into the conversation before the visitor has typed anything.
+ *
+ * Every field is non-null on the wire: a highlight with no picture or no
+ * destination is not a highlight, so the server drops it rather than sending a
+ * half-built one. `product` is the slug, `productName` the display casing the
+ * product's own pages use.
+ *
+ * The pictures are the published concept mockups — illustrations of an idea,
+ * not screenshots of shipping software — which is why every surface that shows
+ * one also labels it (`ExploreStrings.conceptIllustration`).
+ */
+interface ExploreConceptHighlight {
+    product: string;
+    productName: string;
+    title: string;
+    url: string;
+    imageUrl: string;
+    alt: string;
+}
 /**
  * `type ExploreCatalog` — everything the page needs before the first message.
  *
@@ -120,6 +178,18 @@ interface ExploreCatalog {
     limits: ExploreLimits;
     captchaRequired: boolean;
     recaptchaSiteKey?: string | null;
+    /**
+     * At most 8, the site's own product first. Non-null and non-nullable per the
+     * contract, so a gateway that knows the field always sends an array.
+     *
+     * A gateway that does NOT know it yet does not answer without it — it refuses
+     * the whole document (`GRAPHQL_VALIDATION_FAILED`), which is why the hook
+     * retries with `EXPLORE_CATALOG_QUERY_WITHOUT_HIGHLIGHTS` instead of falling
+     * back to the built-in catalog. That retry is the one response that reaches
+     * `normalizeCatalog` with this field absent, and the hardening there is what
+     * keeps `catalog.conceptHighlights.filter(...)` from throwing in render.
+     */
+    conceptHighlights: ExploreConceptHighlight[];
 }
 /** `input SendExploreMessageInput`. */
 interface SendExploreMessageInput {
@@ -165,15 +235,38 @@ interface SendExploreMessageResult {
     remainingToday?: number | null;
 }
 /** Loaded once per page. Safe to serve from the SDK's 5-minute query cache. */
-declare const EXPLORE_CATALOG_QUERY = "\n  query ExploreCatalog($productSlug: String) {\n    exploreCatalog(productSlug: $productSlug) {\n      enabled\n      products {\n        slug\n        name\n        tagline\n        website\n      }\n      examplePrompts\n      welcomeTitle\n      welcomeBody\n      limits {\n        maxMessageLength\n        maxTurnsPerConversation\n        messagesPerDay\n        historyTurns\n      }\n      captchaRequired\n      recaptchaSiteKey\n    }\n  }\n";
+declare const EXPLORE_CATALOG_QUERY: string;
+/**
+ * The same catalog WITHOUT `conceptHighlights`, for a gateway whose supergraph
+ * predates the field.
+ *
+ * This is not belt-and-braces. GraphQL validation is all-or-nothing: a gateway
+ * that does not know the field rejects the ENTIRE document and returns no
+ * `data` at all, so selecting `conceptHighlights` against an older supergraph
+ * costs the whole catalog — `enabled`, `captchaRequired`, `recaptchaSiteKey`,
+ * the welcome copy and `limits` included — and not merely the strip. Measured
+ * against production:
+ *
+ *     {"errors":[{"message":"Cannot query field \\"conceptHighlights\\" on type
+ *       \\"ExploreCatalog\\".","extensions":{"code":"GRAPHQL_VALIDATION_FAILED"}}]}
+ *
+ * That window is guaranteed even with perfect deploy ordering, because the prod
+ * gateway's CDN edge serves a stale supergraph for ~30-40 minutes after the
+ * subgraph publishes. `useExploreChat` therefore retries with this document
+ * (see `catalogRejectedTheHighlightField`) rather than dropping to the built-in
+ * fallback, whose hardcoded `enabled: true` would ignore the server-side kill
+ * switch and whose `captchaRequired: false` would let every send be rejected
+ * server-side while the composer looked fine.
+ */
+declare const EXPLORE_CATALOG_QUERY_WITHOUT_HIGHLIGHTS: string;
 /**
  * The poll. MUST be issued with `client.query(..., { cache: false })` — the
  * default 5-minute cache would return the first PENDING snapshot forever and
  * the answer would never appear.
  */
-declare const EXPLORE_MESSAGE_QUERY = "\n  query ExploreMessage($conversationToken: String!, $id: ID!) {\n    exploreMessage(conversationToken: $conversationToken, id: $id) {\n      \n  id\n  conversationId\n  role\n  status\n  content\n  partialContent\n  activity\n  references {\n    url\n    title\n    description\n    product\n    imageUrl\n    index\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  followUps\n  answered\n  attachments {\n    name\n    mimeType\n    size\n    textExtracted\n  }\n  errorCode\n  createdAt\n  completedAt\n\n    }\n  }\n";
+declare const EXPLORE_MESSAGE_QUERY = "\n  query ExploreMessage($conversationToken: String!, $id: ID!) {\n    exploreMessage(conversationToken: $conversationToken, id: $id) {\n      \n  \n  id\n  conversationId\n  role\n  status\n  content\n  partialContent\n  activity\n  references {\n    url\n    title\n    description\n    product\n    imageUrl\n    index\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  followUps\n  answered\n  attachments {\n    name\n    mimeType\n    size\n    textExtracted\n  }\n  errorCode\n  createdAt\n  completedAt\n\n  feedback {\n    rating\n    reason\n    comment\n    createdAt\n  }\n\n    }\n  }\n";
 /** Submit half of the submit + poll pair. */
-declare const SEND_EXPLORE_MESSAGE_MUTATION = "\n  mutation SendExploreMessage($input: SendExploreMessageInput!) {\n    sendExploreMessage(input: $input) {\n      conversation {\n        id\n        token\n        productSlug\n        turnCount\n        createdAt\n      }\n      userMessage {\n        \n  id\n  conversationId\n  role\n  status\n  content\n  partialContent\n  activity\n  references {\n    url\n    title\n    description\n    product\n    imageUrl\n    index\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  followUps\n  answered\n  attachments {\n    name\n    mimeType\n    size\n    textExtracted\n  }\n  errorCode\n  createdAt\n  completedAt\n\n      }\n      assistantMessage {\n        \n  id\n  conversationId\n  role\n  status\n  content\n  partialContent\n  activity\n  references {\n    url\n    title\n    description\n    product\n    imageUrl\n    index\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  followUps\n  answered\n  attachments {\n    name\n    mimeType\n    size\n    textExtracted\n  }\n  errorCode\n  createdAt\n  completedAt\n\n      }\n      remainingToday\n    }\n  }\n";
+declare const SEND_EXPLORE_MESSAGE_MUTATION = "\n  mutation SendExploreMessage($input: SendExploreMessageInput!) {\n    sendExploreMessage(input: $input) {\n      conversation {\n        id\n        token\n        productSlug\n        turnCount\n        createdAt\n      }\n      userMessage {\n        \n  \n  id\n  conversationId\n  role\n  status\n  content\n  partialContent\n  activity\n  references {\n    url\n    title\n    description\n    product\n    imageUrl\n    index\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  followUps\n  answered\n  attachments {\n    name\n    mimeType\n    size\n    textExtracted\n  }\n  errorCode\n  createdAt\n  completedAt\n\n  feedback {\n    rating\n    reason\n    comment\n    createdAt\n  }\n\n      }\n      assistantMessage {\n        \n  \n  id\n  conversationId\n  role\n  status\n  content\n  partialContent\n  activity\n  references {\n    url\n    title\n    description\n    product\n    imageUrl\n    index\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  followUps\n  answered\n  attachments {\n    name\n    mimeType\n    size\n    textExtracted\n  }\n  errorCode\n  createdAt\n  completedAt\n\n  feedback {\n    rating\n    reason\n    comment\n    createdAt\n  }\n\n      }\n      remainingToday\n    }\n  }\n";
 interface ExploreCatalogQueryData {
     exploreCatalog: ExploreCatalog;
 }
@@ -184,4 +277,4 @@ interface SendExploreMessageMutationData {
     sendExploreMessage: SendExploreMessageResult;
 }
 
-export { type ExploreProduct as E, SEND_EXPLORE_MESSAGE_MUTATION as S, type ExploreLimits as a, type ExploreCatalog as b, type ExploreMessage as c, EXPLORE_CATALOG_QUERY as d, EXPLORE_MESSAGE_QUERY as e, type ExploreCatalogQueryData as f, type ExploreConversation as g, type ExploreCtaKind as h, type ExploreCtaLink as i, type ExploreErrorCode as j, type ExploreMessageQueryData as k, type ExploreMessageRole as l, type ExploreMessageStatus as m, type ExploreReference as n, type SendExploreMessageInput as o, type SendExploreMessageMutationData as p, type SendExploreMessageResult as q };
+export { type ExploreProduct as E, SEND_EXPLORE_MESSAGE_MUTATION as S, type ExploreReference as a, type ExploreLimits as b, type ExploreCatalog as c, type ExploreMessage as d, type ExploreFeedbackRating as e, type ExploreFeedbackReason as f, EXPLORE_CATALOG_QUERY as g, EXPLORE_CATALOG_QUERY_WITHOUT_HIGHLIGHTS as h, EXPLORE_MESSAGE_QUERY as i, type ExploreCatalogQueryData as j, type ExploreConceptHighlight as k, type ExploreConversation as l, type ExploreCtaKind as m, type ExploreCtaLink as n, type ExploreErrorCode as o, type ExploreMessageQueryData as p, type ExploreMessageRole as q, type ExploreMessageStatus as r, type SendExploreMessageInput as s, type SendExploreMessageMutationData as t, type SendExploreMessageResult as u };

package/dist/{explore-types-CLw19R76.d.ts → explore-types-DvQPiL1t.d.ts}

@@ -17,6 +17,18 @@
  */
 type ExploreMessageRole = "USER" | "ASSISTANT";
 type ExploreMessageStatus = "PENDING" | "RUNNING" | "COMPLETED" | "FAILED";
+/** `enum ExploreFeedbackRating` — the visitor's verdict on one answer. */
+type ExploreFeedbackRating = "HELPFUL" | "NOT_HELPFUL";
+/**
+ * The reasons offered alongside `NOT_HELPFUL`, in the order the chooser shows them.
+ *
+ * `reason` is `String` on the wire, not an enum, so this list is the SDK's half of the
+ * agreement rather than something the schema enforces — the same treatment
+ * {@link ExploreCtaKind} gets. Use the union when you are *producing* a reason; read one
+ * back as a plain string.
+ */
+declare const EXPLORE_FEEDBACK_REASONS: readonly ["INACCURATE", "INCOMPLETE", "OFF_TOPIC", "HARD_TO_FOLLOW", "OTHER"];
+type ExploreFeedbackReason = (typeof EXPLORE_FEEDBACK_REASONS)[number];
 /**
  * The `ExploreCta.kind` values enumerated in CONTRACT.md §1.
  *
@@ -56,6 +68,21 @@ interface ExploreCtaLink {
     url: string;
     product?: string | null;
 }
+/**
+ * `type ExploreFeedback` — what is on record for one answer, as the server holds it.
+ *
+ * A rating REPLACES the previous one (the server upserts on `messageId`), so this is the
+ * visitor's current opinion and never a history. `reason` is null for `HELPFUL` by
+ * definition, and typed `string` rather than the union because it is `String` on the wire —
+ * a reason added server-side must read back, not break the build of 38 websites.
+ */
+interface ExploreFeedback {
+    rating: ExploreFeedbackRating;
+    /** One of {@link EXPLORE_FEEDBACK_REASONS}. Null for `HELPFUL`. */
+    reason?: string | null;
+    comment?: string | null;
+    createdAt: string;
+}
 /** `type ExploreMessage`. `content` is `""` while the turn is PENDING. */
 interface ExploreMessage {
     id: string;
@@ -79,6 +106,16 @@ interface ExploreMessage {
     answered?: boolean | null;
     /** Files the visitor attached to this turn. Present on USER messages only. */
     attachments?: ExploreAttachment[] | null;
+    /**
+     * The rating this visitor already gave this answer, or null for an unrated one.
+     *
+     * Selected only by the reads scoped to a `conversationToken`, so a polled or restored
+     * transcript shows what was already rated instead of offering the row again. It is always
+     * null on a SHARED transcript — that read is performed by someone else, and the rater's
+     * verdict and free-text note are not theirs to receive. See
+     * `EXPLORE_OWN_MESSAGE_FIELDS`.
+     */
+    feedback?: ExploreFeedback | null;
     errorCode?: string | null;
     createdAt: string;
     completedAt?: string | null;
@@ -105,6 +142,27 @@ interface ExploreLimits {
     messagesPerDay: number;
     historyTurns: number;
 }
+/**
+ * `type ExploreConceptHighlight` — one published concept illustration, offered
+ * as a way into the conversation before the visitor has typed anything.
+ *
+ * Every field is non-null on the wire: a highlight with no picture or no
+ * destination is not a highlight, so the server drops it rather than sending a
+ * half-built one. `product` is the slug, `productName` the display casing the
+ * product's own pages use.
+ *
+ * The pictures are the published concept mockups — illustrations of an idea,
+ * not screenshots of shipping software — which is why every surface that shows
+ * one also labels it (`ExploreStrings.conceptIllustration`).
+ */
+interface ExploreConceptHighlight {
+    product: string;
+    productName: string;
+    title: string;
+    url: string;
+    imageUrl: string;
+    alt: string;
+}
 /**
  * `type ExploreCatalog` — everything the page needs before the first message.
  *
@@ -120,6 +178,18 @@ interface ExploreCatalog {
     limits: ExploreLimits;
     captchaRequired: boolean;
     recaptchaSiteKey?: string | null;
+    /**
+     * At most 8, the site's own product first. Non-null and non-nullable per the
+     * contract, so a gateway that knows the field always sends an array.
+     *
+     * A gateway that does NOT know it yet does not answer without it — it refuses
+     * the whole document (`GRAPHQL_VALIDATION_FAILED`), which is why the hook
+     * retries with `EXPLORE_CATALOG_QUERY_WITHOUT_HIGHLIGHTS` instead of falling
+     * back to the built-in catalog. That retry is the one response that reaches
+     * `normalizeCatalog` with this field absent, and the hardening there is what
+     * keeps `catalog.conceptHighlights.filter(...)` from throwing in render.
+     */
+    conceptHighlights: ExploreConceptHighlight[];
 }
 /** `input SendExploreMessageInput`. */
 interface SendExploreMessageInput {
@@ -165,15 +235,38 @@ interface SendExploreMessageResult {
     remainingToday?: number | null;
 }
 /** Loaded once per page. Safe to serve from the SDK's 5-minute query cache. */
-declare const EXPLORE_CATALOG_QUERY = "\n  query ExploreCatalog($productSlug: String) {\n    exploreCatalog(productSlug: $productSlug) {\n      enabled\n      products {\n        slug\n        name\n        tagline\n        website\n      }\n      examplePrompts\n      welcomeTitle\n      welcomeBody\n      limits {\n        maxMessageLength\n        maxTurnsPerConversation\n        messagesPerDay\n        historyTurns\n      }\n      captchaRequired\n      recaptchaSiteKey\n    }\n  }\n";
+declare const EXPLORE_CATALOG_QUERY: string;
+/**
+ * The same catalog WITHOUT `conceptHighlights`, for a gateway whose supergraph
+ * predates the field.
+ *
+ * This is not belt-and-braces. GraphQL validation is all-or-nothing: a gateway
+ * that does not know the field rejects the ENTIRE document and returns no
+ * `data` at all, so selecting `conceptHighlights` against an older supergraph
+ * costs the whole catalog — `enabled`, `captchaRequired`, `recaptchaSiteKey`,
+ * the welcome copy and `limits` included — and not merely the strip. Measured
+ * against production:
+ *
+ *     {"errors":[{"message":"Cannot query field \\"conceptHighlights\\" on type
+ *       \\"ExploreCatalog\\".","extensions":{"code":"GRAPHQL_VALIDATION_FAILED"}}]}
+ *
+ * That window is guaranteed even with perfect deploy ordering, because the prod
+ * gateway's CDN edge serves a stale supergraph for ~30-40 minutes after the
+ * subgraph publishes. `useExploreChat` therefore retries with this document
+ * (see `catalogRejectedTheHighlightField`) rather than dropping to the built-in
+ * fallback, whose hardcoded `enabled: true` would ignore the server-side kill
+ * switch and whose `captchaRequired: false` would let every send be rejected
+ * server-side while the composer looked fine.
+ */
+declare const EXPLORE_CATALOG_QUERY_WITHOUT_HIGHLIGHTS: string;
 /**
  * The poll. MUST be issued with `client.query(..., { cache: false })` — the
  * default 5-minute cache would return the first PENDING snapshot forever and
  * the answer would never appear.
  */
-declare const EXPLORE_MESSAGE_QUERY = "\n  query ExploreMessage($conversationToken: String!, $id: ID!) {\n    exploreMessage(conversationToken: $conversationToken, id: $id) {\n      \n  id\n  conversationId\n  role\n  status\n  content\n  partialContent\n  activity\n  references {\n    url\n    title\n    description\n    product\n    imageUrl\n    index\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  followUps\n  answered\n  attachments {\n    name\n    mimeType\n    size\n    textExtracted\n  }\n  errorCode\n  createdAt\n  completedAt\n\n    }\n  }\n";
+declare const EXPLORE_MESSAGE_QUERY = "\n  query ExploreMessage($conversationToken: String!, $id: ID!) {\n    exploreMessage(conversationToken: $conversationToken, id: $id) {\n      \n  \n  id\n  conversationId\n  role\n  status\n  content\n  partialContent\n  activity\n  references {\n    url\n    title\n    description\n    product\n    imageUrl\n    index\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  followUps\n  answered\n  attachments {\n    name\n    mimeType\n    size\n    textExtracted\n  }\n  errorCode\n  createdAt\n  completedAt\n\n  feedback {\n    rating\n    reason\n    comment\n    createdAt\n  }\n\n    }\n  }\n";
 /** Submit half of the submit + poll pair. */
-declare const SEND_EXPLORE_MESSAGE_MUTATION = "\n  mutation SendExploreMessage($input: SendExploreMessageInput!) {\n    sendExploreMessage(input: $input) {\n      conversation {\n        id\n        token\n        productSlug\n        turnCount\n        createdAt\n      }\n      userMessage {\n        \n  id\n  conversationId\n  role\n  status\n  content\n  partialContent\n  activity\n  references {\n    url\n    title\n    description\n    product\n    imageUrl\n    index\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  followUps\n  answered\n  attachments {\n    name\n    mimeType\n    size\n    textExtracted\n  }\n  errorCode\n  createdAt\n  completedAt\n\n      }\n      assistantMessage {\n        \n  id\n  conversationId\n  role\n  status\n  content\n  partialContent\n  activity\n  references {\n    url\n    title\n    description\n    product\n    imageUrl\n    index\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  followUps\n  answered\n  attachments {\n    name\n    mimeType\n    size\n    textExtracted\n  }\n  errorCode\n  createdAt\n  completedAt\n\n      }\n      remainingToday\n    }\n  }\n";
+declare const SEND_EXPLORE_MESSAGE_MUTATION = "\n  mutation SendExploreMessage($input: SendExploreMessageInput!) {\n    sendExploreMessage(input: $input) {\n      conversation {\n        id\n        token\n        productSlug\n        turnCount\n        createdAt\n      }\n      userMessage {\n        \n  \n  id\n  conversationId\n  role\n  status\n  content\n  partialContent\n  activity\n  references {\n    url\n    title\n    description\n    product\n    imageUrl\n    index\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  followUps\n  answered\n  attachments {\n    name\n    mimeType\n    size\n    textExtracted\n  }\n  errorCode\n  createdAt\n  completedAt\n\n  feedback {\n    rating\n    reason\n    comment\n    createdAt\n  }\n\n      }\n      assistantMessage {\n        \n  \n  id\n  conversationId\n  role\n  status\n  content\n  partialContent\n  activity\n  references {\n    url\n    title\n    description\n    product\n    imageUrl\n    index\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  followUps\n  answered\n  attachments {\n    name\n    mimeType\n    size\n    textExtracted\n  }\n  errorCode\n  createdAt\n  completedAt\n\n  feedback {\n    rating\n    reason\n    comment\n    createdAt\n  }\n\n      }\n      remainingToday\n    }\n  }\n";
 interface ExploreCatalogQueryData {
     exploreCatalog: ExploreCatalog;
 }
@@ -184,4 +277,4 @@ interface SendExploreMessageMutationData {
     sendExploreMessage: SendExploreMessageResult;
 }
 
-export { type ExploreProduct as E, SEND_EXPLORE_MESSAGE_MUTATION as S, type ExploreLimits as a, type ExploreCatalog as b, type ExploreMessage as c, EXPLORE_CATALOG_QUERY as d, EXPLORE_MESSAGE_QUERY as e, type ExploreCatalogQueryData as f, type ExploreConversation as g, type ExploreCtaKind as h, type ExploreCtaLink as i, type ExploreErrorCode as j, type ExploreMessageQueryData as k, type ExploreMessageRole as l, type ExploreMessageStatus as m, type ExploreReference as n, type SendExploreMessageInput as o, type SendExploreMessageMutationData as p, type SendExploreMessageResult as q };
+export { type ExploreProduct as E, SEND_EXPLORE_MESSAGE_MUTATION as S, type ExploreReference as a, type ExploreLimits as b, type ExploreCatalog as c, type ExploreMessage as d, type ExploreFeedbackRating as e, type ExploreFeedbackReason as f, EXPLORE_CATALOG_QUERY as g, EXPLORE_CATALOG_QUERY_WITHOUT_HIGHLIGHTS as h, EXPLORE_MESSAGE_QUERY as i, type ExploreCatalogQueryData as j, type ExploreConceptHighlight as k, type ExploreConversation as l, type ExploreCtaKind as m, type ExploreCtaLink as n, type ExploreErrorCode as o, type ExploreMessageQueryData as p, type ExploreMessageRole as q, type ExploreMessageStatus as r, type SendExploreMessageInput as s, type SendExploreMessageMutationData as t, type SendExploreMessageResult as u };

package/dist/hooks/index.d.mts

@@ -1,5 +1,5 @@
-export { D as DEFAULT_EXPLORE_EXAMPLE_PROMPTS, E as ExploreChatError, a as ExploreChatErrorKind, b as ExploreChatPhase, F as FALLBACK_EXPLORE_LIMITS, U as UseExploreChatOptions, c as UseExploreChatResult, d as classifyExploreError, u as useExploreChat } from '../use-explore-chat-DC47G-C3.mjs';
-import '../explore-types-CLw19R76.mjs';
+export { D as DEFAULT_EXPLORE_EXAMPLE_PROMPTS, E as ExploreChatError, a as ExploreChatErrorKind, b as ExploreChatPhase, F as FALLBACK_EXPLORE_LIMITS, U as UseExploreChatOptions, c as UseExploreChatResult, d as classifyExploreError, u as useExploreChat } from '../use-explore-chat-Dgm-jf96.mjs';
+import '../explore-types-DvQPiL1t.mjs';
 
 interface UseSpeechInputOptions {
     /** Receives settled text as it is recognised. Append it to the draft. */

package/dist/hooks/index.d.ts

@@ -1,5 +1,5 @@
-export { D as DEFAULT_EXPLORE_EXAMPLE_PROMPTS, E as ExploreChatError, a as ExploreChatErrorKind, b as ExploreChatPhase, F as FALLBACK_EXPLORE_LIMITS, U as UseExploreChatOptions, c as UseExploreChatResult, d as classifyExploreError, u as useExploreChat } from '../use-explore-chat-DyPMkzXA.js';
-import '../explore-types-CLw19R76.js';
+export { D as DEFAULT_EXPLORE_EXAMPLE_PROMPTS, E as ExploreChatError, a as ExploreChatErrorKind, b as ExploreChatPhase, F as FALLBACK_EXPLORE_LIMITS, U as UseExploreChatOptions, c as UseExploreChatResult, d as classifyExploreError, u as useExploreChat } from '../use-explore-chat-CNEdKBc1.js';
+import '../explore-types-DvQPiL1t.js';
 
 interface UseSpeechInputOptions {
     /** Receives settled text as it is recognised. Append it to the draft. */

package/dist/hooks/index.js

@@ -265,11 +265,21 @@ var EXPLORE_MESSAGE_FIELDS = (
   completedAt
 `
 );
-var EXPLORE_CATALOG_QUERY = (
+var EXPLORE_OWN_MESSAGE_FIELDS = (
+  /* GraphQL */
+  `
+  ${EXPLORE_MESSAGE_FIELDS}
+  feedback {
+    rating
+    reason
+    comment
+    createdAt
+  }
+`
+);
+var EXPLORE_CATALOG_ESTABLISHED_FIELDS = (
   /* GraphQL */
   `
-  query ExploreCatalog($productSlug: String) {
-    exploreCatalog(productSlug: $productSlug) {
       enabled
       products {
         slug
@@ -287,17 +297,41 @@ var EXPLORE_CATALOG_QUERY = (
         historyTurns
       }
       captchaRequired
-      recaptchaSiteKey
+      recaptchaSiteKey`
+);
+var EXPLORE_CATALOG_HIGHLIGHT_FIELD = (
+  /* GraphQL */
+  `
+      conceptHighlights {
+        product
+        productName
+        title
+        url
+        imageUrl
+        alt
+      }`
+);
+function exploreCatalogDocument(extraFields) {
+  return (
+    /* GraphQL */
+    `
+  query ExploreCatalog($productSlug: String) {
+    exploreCatalog(productSlug: $productSlug) {${EXPLORE_CATALOG_ESTABLISHED_FIELDS}${extraFields}
     }
   }
 `
+  );
+}
+var EXPLORE_CATALOG_QUERY = exploreCatalogDocument(
+  EXPLORE_CATALOG_HIGHLIGHT_FIELD
 );
+var EXPLORE_CATALOG_QUERY_WITHOUT_HIGHLIGHTS = exploreCatalogDocument("");
 var EXPLORE_MESSAGE_QUERY = (
   /* GraphQL */
   `
   query ExploreMessage($conversationToken: String!, $id: ID!) {
     exploreMessage(conversationToken: $conversationToken, id: $id) {
-      ${EXPLORE_MESSAGE_FIELDS}
+      ${EXPLORE_OWN_MESSAGE_FIELDS}
     }
   }
 `
@@ -315,10 +349,10 @@ var SEND_EXPLORE_MESSAGE_MUTATION = (
         createdAt
       }
       userMessage {
-        ${EXPLORE_MESSAGE_FIELDS}
+        ${EXPLORE_OWN_MESSAGE_FIELDS}
       }
       assistantMessage {
-        ${EXPLORE_MESSAGE_FIELDS}
+        ${EXPLORE_OWN_MESSAGE_FIELDS}
       }
       remainingToday
     }
@@ -335,6 +369,22 @@ var RECORD_EXPLORE_CLICK_MUTATION = (
   }
 `
 );
+var SUBMIT_EXPLORE_FEEDBACK_MUTATION = (
+  /* GraphQL */
+  `
+  mutation SubmitExploreFeedback($input: SubmitExploreFeedbackInput!) {
+    submitExploreFeedback(input: $input) {
+      recorded
+      feedback {
+        rating
+        reason
+        comment
+        createdAt
+      }
+    }
+  }
+`
+);
 var CREATE_EXPLORE_SHARE_LINK_MUTATION = (
   /* GraphQL */
   `
@@ -639,7 +689,12 @@ function buildFallbackCatalog(examplePrompts, welcome) {
     welcomeBody: welcome?.body ?? FALLBACK_WELCOME_BODY,
     limits: FALLBACK_EXPLORE_LIMITS,
     captchaRequired: false,
-    recaptchaSiteKey: null
+    recaptchaSiteKey: null,
+    // Empty, and deliberately not synthesised from `ECOSYSTEM_PRODUCTS`: a concept highlight
+    // needs a real published illustration URL, and this SDK has no registry of them. An
+    // invented path would render 38 broken frames on the one screen every prerender captures.
+    // The strip renders nothing at all when the list is empty, which is the honest fallback.
+    conceptHighlights: []
   };
 }
 function normalizeCatalog(raw, fallback) {
@@ -656,9 +711,27 @@ function normalizeCatalog(raw, fallback) {
       historyTurns: raw.limits?.historyTurns || fallback.limits.historyTurns
     },
     captchaRequired: raw.captchaRequired === true,
-    recaptchaSiteKey: raw.recaptchaSiteKey ?? null
+    recaptchaSiteKey: raw.recaptchaSiteKey ?? null,
+    // `[ExploreConceptHighlight!]!` on the wire, so a gateway that KNOWS the field always
+    // sends an array. The one response that arrives without it is the retry against an older
+    // supergraph (`EXPLORE_CATALOG_QUERY_WITHOUT_HIGHLIGHTS`) — that gateway does not answer
+    // the full document at all, it refuses it. Either way
+    // `catalog.conceptHighlights.filter(...)` on `undefined` would throw inside render,
+    // blanking the welcome screen over a decorative strip.
+    conceptHighlights: raw.conceptHighlights?.length ? raw.conceptHighlights : fallback.conceptHighlights
   };
 }
+var CATALOG_DOCUMENT_REJECTED_CODES = /* @__PURE__ */ new Set([
+  "GRAPHQL_VALIDATION_FAILED",
+  "HTTP_400"
+]);
+function catalogRejectedTheHighlightField(res) {
+  if (res.data?.exploreCatalog) return false;
+  return (res.errors ?? []).some((error) => {
+    const code = error.extensions?.code;
+    return typeof code === "string" && CATALOG_DOCUMENT_REJECTED_CODES.has(code) || error.message.includes("conceptHighlights");
+  });
+}
 var RATE_LIMIT_CODES = /* @__PURE__ */ new Set([
   "RATE_LIMITED",
   "HTTP_429",
@@ -998,11 +1071,19 @@ function useExploreChat(options = {}) {
   react.useEffect(() => {
     let cancelled = false;
     const load = async () => {
-      const res = await client.query(
+      const variables = { productSlug: productSlug ?? null };
+      let res = await client.query(
         EXPLORE_CATALOG_QUERY,
-        { productSlug: productSlug ?? null }
+        variables
       );
       if (cancelled || !mountedRef.current) return;
+      if (catalogRejectedTheHighlightField(res)) {
+        res = await client.query(
+          EXPLORE_CATALOG_QUERY_WITHOUT_HIGHLIGHTS,
+          variables
+        );
+        if (cancelled || !mountedRef.current) return;
+      }
       const raw = res.data?.exploreCatalog;
       if (res.errors?.length || !raw) {
         console.warn(
@@ -1383,6 +1464,42 @@ function useExploreChat(options = {}) {
     },
     [client]
   );
+  const submitFeedback = react.useCallback(
+    async (messageId, rating, detail) => {
+      const token = conversationTokenRef.current;
+      if (!token) return false;
+      const comment = detail?.comment?.trim();
+      const input = {
+        conversationToken: token,
+        messageId,
+        rating,
+        // Only meaningful with NOT_HELPFUL. The server stores null for HELPFUL either
+        // way; sending it would just be noise the backend has to defend against.
+        reason: rating === "NOT_HELPFUL" ? detail?.reason ?? null : null,
+        comment: comment ? comment : null
+      };
+      try {
+        const res = await client.mutate(
+          SUBMIT_EXPLORE_FEEDBACK_MUTATION,
+          { input }
+        );
+        const result = res?.data?.submitExploreFeedback;
+        if (!result?.recorded) return false;
+        const recorded = result.feedback;
+        if (recorded && mountedRef.current) {
+          setMessages(
+            (current) => current.map(
+              (message) => message.id === messageId ? { ...message, feedback: recorded } : message
+            )
+          );
+        }
+        return true;
+      } catch {
+        return false;
+      }
+    },
+    [client]
+  );
   return {
     phase,
     catalog,
@@ -1402,6 +1519,7 @@ function useExploreChat(options = {}) {
     deleteConversation,
     clearHistory,
     recordClick,
+    submitFeedback,
     createShareLink,
     isSharedView
   };