@burdenoff/website-sdk 2026.829.8 → 2026.921.1

package/dist/{use-explore-chat-BzXCz2UM.d.mts → explore-types-CLw19R76.d.mts}

@@ -184,134 +184,4 @@ interface SendExploreMessageMutationData {
     sendExploreMessage: SendExploreMessageResult;
 }
 
-/** What travels on the wire — mirrors `ExploreAttachmentInput`. */
-interface ExploreAttachmentPayload {
-    name: string;
-    mimeType: string;
-    size: number;
-    textContent: string | null;
-}
-
-/**
- * Where the conversation is right now.
- *
- * - `loading`   — catalog request in flight (the fallback catalog is already
- *                 rendered, so this is a refinement, not a blank screen).
- * - `ready`     — idle; the composer accepts input.
- * - `sending`   — `sendExploreMessage` in flight.
- * - `streaming` — polling the assistant turn; `activity` is live.
- * - `error`     — the last turn failed; `retry()` is meaningful and the
- *                 composer stays usable.
- * - `limited`   — rate limited; the composer is disabled.
- * - `disabled`  — `exploreCatalog.enabled === false`.
- */
-type ExploreChatPhase = "loading" | "ready" | "sending" | "streaming" | "error" | "limited" | "disabled";
-/** Coarse bucket the UI switches its banner copy and affordances on. */
-type ExploreChatErrorKind = "rate-limit" | "captcha" | "timeout" | "network" | "disabled" | "validation" | "unknown";
-interface ExploreChatError {
-    /** UI bucket. */
-    kind: ExploreChatErrorKind;
-    /** Raw `extensions.code` (or a client-side code such as `TIMEOUT`). */
-    code: string;
-    /** Human-readable, safe to render. */
-    message: string;
-    /** Whether re-sending the same message could plausibly succeed. */
-    retryable: boolean;
-}
-interface UseExploreChatOptions {
-    /** Slug of the product site this page is on — a soft hint to the harness. */
-    productSlug?: string;
-    /** Full URL of the page, forwarded as `pageUrl`. */
-    pageUrl?: string;
-    /** BCP-47 locale, forwarded as `locale`. */
-    locale?: string;
-    /** Poll cadence in ms. Default 1500 (CONTRACT.md §1). */
-    pollIntervalMs?: number;
-    /** Give up on a turn after this long. Default 90000 (the edge poll timeout). */
-    pollTimeoutMs?: number;
-    /**
-     * Prompts to offer when `exploreCatalog` supplies none. Resolution order is
-     * catalog → this option → {@link DEFAULT_EXPLORE_EXAMPLE_PROMPTS}, so a site
-     * can ship product-specific prompts without waiting on the backend and still
-     * be overridden centrally once the catalog carries them.
-     */
-    examplePrompts?: string[];
-    /** localStorage key for the ACTIVE conversation. Default `boff.explore.v1`. */
-    storageKey?: string;
-    /** Persist the conversation across reloads within the tab. Default true. */
-    persist?: boolean;
-    /** Called with the message text each time a send is accepted locally. */
-    onSend?: (message: string) => void;
-}
-interface UseExploreChatResult {
-    phase: ExploreChatPhase;
-    /** Never null — starts as the static fallback, upgraded by the server. */
-    catalog: ExploreCatalog;
-    messages: ExploreMessage[];
-    /** Latest progress line of the in-flight turn, or null when idle. */
-    activity: string | null;
-    /** Messages left today for this visitor, when the server reports it. */
-    remainingToday: number | null;
-    error: ExploreChatError | null;
-    /** Product the visitor pinned the conversation to, or null for "all". */
-    focusProduct: string | null;
-    setFocusProduct: (slug: string | null) => void;
-    send: (message: string, attachments?: readonly ExploreAttachmentPayload[]) => Promise<void>;
-    /** Stop polling and keep whatever text has streamed so far. */
-    stop: () => void;
-    /** Re-send the last message after a failed turn. */
-    retry: () => void;
-    /** Clear the conversation and the persisted session. */
-    reset: () => void;
-    /** Past conversations held in THIS browser, newest first. */
-    history: ArchivedExploreConversation[];
-    /** Reopen a past conversation and continue it. */
-    openConversation: (token: string) => void;
-    /** Forget one past conversation (local only). */
-    deleteConversation: (token: string) => void;
-    /** Forget every past conversation held in this browser. */
-    clearHistory: () => void;
-    /**
-     * Record that the visitor followed a link this answer offered. Fire-and-forget — never
-     * awaited, never throws, and must never delay the navigation it is reporting on.
-     */
-    recordClick: (messageId: string, kind: "CTA" | "REFERENCE", url: string) => void;
-    /**
-     * Mint a read-only link to this conversation, or null when there is nothing to share yet.
-     * The secret returned is not the conversation token and cannot continue the thread.
-     */
-    createShareLink: () => Promise<string | null>;
-    /**
-     * True when the transcript on screen came from a shared link rather than this visitor's own
-     * conversation. A shared view is read-only: the share secret cannot continue the thread.
-     */
-    isSharedView: boolean;
-    canSend: boolean;
-}
-/** Fallback limits, mirroring the server defaults in CONTRACT.md §3. */
-declare const FALLBACK_EXPLORE_LIMITS: ExploreLimits;
-/**
- * Prompts shown when neither the catalog nor the consumer supplies any.
- * Deliberately product-agnostic — this SDK renders on 38 different sites.
- */
-declare const DEFAULT_EXPLORE_EXAMPLE_PROMPTS: string[];
-/**
- * Map a `extensions.code` (or a client-side transport code) onto the bucket the
- * UI renders. Unknown codes are treated as retryable — a transient backend
- * condition we have not enumerated is far more likely than a permanent one.
- */
-declare function classifyExploreError(code: string | null | undefined, serverMessage?: string | null): ExploreChatError;
-/** One past conversation, as shown in the history list and restored on click. */
-interface ArchivedExploreConversation {
-    token: string;
-    /** First thing the visitor asked — the human-readable label for the thread. */
-    title: string;
-    /** ISO timestamp of the last message in the thread. */
-    updatedAt: string;
-    messageCount: number;
-    focusProduct: string | null;
-    messages: ExploreMessage[];
-}
-declare function useExploreChat(options?: UseExploreChatOptions): UseExploreChatResult;
-
-export { DEFAULT_EXPLORE_EXAMPLE_PROMPTS as D, type ExploreChatError as E, FALLBACK_EXPLORE_LIMITS as F, SEND_EXPLORE_MESSAGE_MUTATION as S, type UseExploreChatOptions as U, type ExploreChatErrorKind as a, type ExploreChatPhase as b, type UseExploreChatResult as c, classifyExploreError as d, EXPLORE_CATALOG_QUERY as e, EXPLORE_MESSAGE_QUERY as f, type ExploreCatalog as g, type ExploreCatalogQueryData as h, type ExploreConversation as i, type ExploreCtaKind as j, type ExploreCtaLink as k, type ExploreErrorCode as l, type ExploreLimits as m, type ExploreMessage as n, type ExploreMessageQueryData as o, type ExploreMessageRole as p, type ExploreMessageStatus as q, type ExploreProduct as r, type ExploreReference as s, type SendExploreMessageInput as t, useExploreChat as u, type SendExploreMessageMutationData as v, type SendExploreMessageResult as w };
+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 };

package/dist/{use-explore-chat-BzXCz2UM.d.ts → explore-types-CLw19R76.d.ts}

@@ -184,134 +184,4 @@ interface SendExploreMessageMutationData {
     sendExploreMessage: SendExploreMessageResult;
 }
 
-/** What travels on the wire — mirrors `ExploreAttachmentInput`. */
-interface ExploreAttachmentPayload {
-    name: string;
-    mimeType: string;
-    size: number;
-    textContent: string | null;
-}
-
-/**
- * Where the conversation is right now.
- *
- * - `loading`   — catalog request in flight (the fallback catalog is already
- *                 rendered, so this is a refinement, not a blank screen).
- * - `ready`     — idle; the composer accepts input.
- * - `sending`   — `sendExploreMessage` in flight.
- * - `streaming` — polling the assistant turn; `activity` is live.
- * - `error`     — the last turn failed; `retry()` is meaningful and the
- *                 composer stays usable.
- * - `limited`   — rate limited; the composer is disabled.
- * - `disabled`  — `exploreCatalog.enabled === false`.
- */
-type ExploreChatPhase = "loading" | "ready" | "sending" | "streaming" | "error" | "limited" | "disabled";
-/** Coarse bucket the UI switches its banner copy and affordances on. */
-type ExploreChatErrorKind = "rate-limit" | "captcha" | "timeout" | "network" | "disabled" | "validation" | "unknown";
-interface ExploreChatError {
-    /** UI bucket. */
-    kind: ExploreChatErrorKind;
-    /** Raw `extensions.code` (or a client-side code such as `TIMEOUT`). */
-    code: string;
-    /** Human-readable, safe to render. */
-    message: string;
-    /** Whether re-sending the same message could plausibly succeed. */
-    retryable: boolean;
-}
-interface UseExploreChatOptions {
-    /** Slug of the product site this page is on — a soft hint to the harness. */
-    productSlug?: string;
-    /** Full URL of the page, forwarded as `pageUrl`. */
-    pageUrl?: string;
-    /** BCP-47 locale, forwarded as `locale`. */
-    locale?: string;
-    /** Poll cadence in ms. Default 1500 (CONTRACT.md §1). */
-    pollIntervalMs?: number;
-    /** Give up on a turn after this long. Default 90000 (the edge poll timeout). */
-    pollTimeoutMs?: number;
-    /**
-     * Prompts to offer when `exploreCatalog` supplies none. Resolution order is
-     * catalog → this option → {@link DEFAULT_EXPLORE_EXAMPLE_PROMPTS}, so a site
-     * can ship product-specific prompts without waiting on the backend and still
-     * be overridden centrally once the catalog carries them.
-     */
-    examplePrompts?: string[];
-    /** localStorage key for the ACTIVE conversation. Default `boff.explore.v1`. */
-    storageKey?: string;
-    /** Persist the conversation across reloads within the tab. Default true. */
-    persist?: boolean;
-    /** Called with the message text each time a send is accepted locally. */
-    onSend?: (message: string) => void;
-}
-interface UseExploreChatResult {
-    phase: ExploreChatPhase;
-    /** Never null — starts as the static fallback, upgraded by the server. */
-    catalog: ExploreCatalog;
-    messages: ExploreMessage[];
-    /** Latest progress line of the in-flight turn, or null when idle. */
-    activity: string | null;
-    /** Messages left today for this visitor, when the server reports it. */
-    remainingToday: number | null;
-    error: ExploreChatError | null;
-    /** Product the visitor pinned the conversation to, or null for "all". */
-    focusProduct: string | null;
-    setFocusProduct: (slug: string | null) => void;
-    send: (message: string, attachments?: readonly ExploreAttachmentPayload[]) => Promise<void>;
-    /** Stop polling and keep whatever text has streamed so far. */
-    stop: () => void;
-    /** Re-send the last message after a failed turn. */
-    retry: () => void;
-    /** Clear the conversation and the persisted session. */
-    reset: () => void;
-    /** Past conversations held in THIS browser, newest first. */
-    history: ArchivedExploreConversation[];
-    /** Reopen a past conversation and continue it. */
-    openConversation: (token: string) => void;
-    /** Forget one past conversation (local only). */
-    deleteConversation: (token: string) => void;
-    /** Forget every past conversation held in this browser. */
-    clearHistory: () => void;
-    /**
-     * Record that the visitor followed a link this answer offered. Fire-and-forget — never
-     * awaited, never throws, and must never delay the navigation it is reporting on.
-     */
-    recordClick: (messageId: string, kind: "CTA" | "REFERENCE", url: string) => void;
-    /**
-     * Mint a read-only link to this conversation, or null when there is nothing to share yet.
-     * The secret returned is not the conversation token and cannot continue the thread.
-     */
-    createShareLink: () => Promise<string | null>;
-    /**
-     * True when the transcript on screen came from a shared link rather than this visitor's own
-     * conversation. A shared view is read-only: the share secret cannot continue the thread.
-     */
-    isSharedView: boolean;
-    canSend: boolean;
-}
-/** Fallback limits, mirroring the server defaults in CONTRACT.md §3. */
-declare const FALLBACK_EXPLORE_LIMITS: ExploreLimits;
-/**
- * Prompts shown when neither the catalog nor the consumer supplies any.
- * Deliberately product-agnostic — this SDK renders on 38 different sites.
- */
-declare const DEFAULT_EXPLORE_EXAMPLE_PROMPTS: string[];
-/**
- * Map a `extensions.code` (or a client-side transport code) onto the bucket the
- * UI renders. Unknown codes are treated as retryable — a transient backend
- * condition we have not enumerated is far more likely than a permanent one.
- */
-declare function classifyExploreError(code: string | null | undefined, serverMessage?: string | null): ExploreChatError;
-/** One past conversation, as shown in the history list and restored on click. */
-interface ArchivedExploreConversation {
-    token: string;
-    /** First thing the visitor asked — the human-readable label for the thread. */
-    title: string;
-    /** ISO timestamp of the last message in the thread. */
-    updatedAt: string;
-    messageCount: number;
-    focusProduct: string | null;
-    messages: ExploreMessage[];
-}
-declare function useExploreChat(options?: UseExploreChatOptions): UseExploreChatResult;
-
-export { DEFAULT_EXPLORE_EXAMPLE_PROMPTS as D, type ExploreChatError as E, FALLBACK_EXPLORE_LIMITS as F, SEND_EXPLORE_MESSAGE_MUTATION as S, type UseExploreChatOptions as U, type ExploreChatErrorKind as a, type ExploreChatPhase as b, type UseExploreChatResult as c, classifyExploreError as d, EXPLORE_CATALOG_QUERY as e, EXPLORE_MESSAGE_QUERY as f, type ExploreCatalog as g, type ExploreCatalogQueryData as h, type ExploreConversation as i, type ExploreCtaKind as j, type ExploreCtaLink as k, type ExploreErrorCode as l, type ExploreLimits as m, type ExploreMessage as n, type ExploreMessageQueryData as o, type ExploreMessageRole as p, type ExploreMessageStatus as q, type ExploreProduct as r, type ExploreReference as s, type SendExploreMessageInput as t, useExploreChat as u, type SendExploreMessageMutationData as v, type SendExploreMessageResult as w };
+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 };

package/dist/hooks/index.d.mts

@@ -1,4 +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-BzXCz2UM.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-CvW-kyIm.mjs';
+import '../explore-types-CLw19R76.mjs';
 
 interface UseSpeechInputOptions {
     /** Receives settled text as it is recognised. Append it to the draft. */

package/dist/hooks/index.d.ts

@@ -1,4 +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-BzXCz2UM.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-DdGBimiz.js';
+import '../explore-types-CLw19R76.js';
 
 interface UseSpeechInputOptions {
     /** Receives settled text as it is recognised. Append it to the draft. */

package/dist/hooks/index.js

@@ -368,10 +368,13 @@ var ECOSYSTEM_PRODUCTS = [
     name: "VibeControls",
     websiteUrl: "https://vibecontrols.com"
   },
+  // FluidGrids ships on www.fluidgrids.ai — fluidgrids.com only redirects there. The explore
+  // catalog and the site's own sitemap use this origin, and so must the fallback catalog
+  // built from this list, or /explore rejects FluidGrids concept images until it loads.
   {
     slug: "fluidgrids",
     name: "FluidGrids",
-    websiteUrl: "https://fluidgrids.com"
+    websiteUrl: "https://www.fluidgrids.ai"
   },
   // Botlit ships on botlit.ai — botlit.com does not resolve.
   { slug: "botlit", name: "Botlit", websiteUrl: "https://www.botlit.ai" },
@@ -622,7 +625,7 @@ var DEFAULT_EXPLORE_EXAMPLE_PROMPTS = [
 ];
 var FALLBACK_WELCOME_TITLE = "Ask anything about our products";
 var FALLBACK_WELCOME_BODY = "Get straight answers drawn from our product documentation and public pages \u2014 with links back to the exact page each answer came from.";
-function buildFallbackCatalog(examplePrompts) {
+function buildFallbackCatalog(examplePrompts, welcome) {
   return {
     enabled: true,
     products: ECOSYSTEM_PRODUCTS.map((p) => ({
@@ -632,8 +635,8 @@ function buildFallbackCatalog(examplePrompts) {
       website: p.websiteUrl
     })),
     examplePrompts: examplePrompts?.length ? examplePrompts : DEFAULT_EXPLORE_EXAMPLE_PROMPTS,
-    welcomeTitle: FALLBACK_WELCOME_TITLE,
-    welcomeBody: FALLBACK_WELCOME_BODY,
+    welcomeTitle: welcome?.title ?? FALLBACK_WELCOME_TITLE,
+    welcomeBody: welcome?.body ?? FALLBACK_WELCOME_BODY,
     limits: FALLBACK_EXPLORE_LIMITS,
     captchaRequired: false,
     recaptchaSiteKey: null
@@ -693,7 +696,15 @@ function classifyExploreError(code, serverMessage) {
       retryable: true
     };
   }
-  if (c === "TIMEOUT" || c === "TOOL_BUDGET") {
+  if (c === "TOOL_BUDGET") {
+    return {
+      kind: "scope",
+      code: c,
+      message: "That question spans more of our products than I can look through in one go. Try asking about two or three specific products.",
+      retryable: false
+    };
+  }
+  if (c === "TIMEOUT") {
     return {
       kind: "timeout",
       code: c,
@@ -825,6 +836,7 @@ function useExploreChat(options = {}) {
     pageUrl,
     locale,
     examplePrompts,
+    fallbackWelcome,
     pollIntervalMs = DEFAULT_POLL_INTERVAL_MS,
     pollTimeoutMs = DEFAULT_POLL_TIMEOUT_MS,
     storageKey = DEFAULT_STORAGE_KEY,
@@ -833,9 +845,13 @@ function useExploreChat(options = {}) {
   } = options;
   const client = useWebSDK();
   const promptKey = JSON.stringify(examplePrompts ?? []);
+  const welcomeKey = JSON.stringify(fallbackWelcome ?? null);
   const fallbackCatalog = react.useMemo(
-    () => buildFallbackCatalog(JSON.parse(promptKey)),
-    [promptKey]
+    () => buildFallbackCatalog(
+      JSON.parse(promptKey),
+      JSON.parse(welcomeKey) ?? void 0
+    ),
+    [promptKey, welcomeKey]
   );
   const [catalog, setCatalog] = react.useState(fallbackCatalog);
   const [messages, setMessages] = react.useState([]);