@waniwani/sdk 0.19.3 → 0.19.4

package/dist/chat/index.d.ts

@@ -322,6 +322,33 @@ type MessageOverrides = DeepPartial<Messages>;
  */
 type VisitorIdInput = string | (() => string | undefined | null | Promise<string | undefined | null>);
 
+/** Source of truth; {@link SuggestionOrigin} derives from it. */
+declare const SUGGESTION_ORIGINS: readonly ["channel", "page", "flow", "followup"];
+type SuggestionOrigin = (typeof SUGGESTION_ORIGINS)[number];
+/** One pill. `id` is null unless it came from an authored per-page prompt. */
+interface Suggestion {
+    id: string | null;
+    text: string;
+}
+/**
+ * One field per origin. `null` means the origin has nothing to say — no entry
+ * on this turn, or the rung no longer applies.
+ *
+ * `flow` alone treats `[]` as authoritative: it clears the row and suppresses
+ * every weaker rung. Elsewhere `[]` and `null` are the same.
+ */
+interface SuggestionCandidates {
+    flow: Suggestion[] | null;
+    followup: Suggestion[] | null;
+    page: Suggestion[] | null;
+    channel: Suggestion[] | null;
+}
+/**
+ * The rungs an embed host reads from `/config`. Grouped because they share a
+ * source and a lifetime: both stop applying at the visitor's first message.
+ */
+type PreChatSuggestions = Pick<SuggestionCandidates, "page" | "channel">;
+
 /** Surface the widget is mounted on. */
 type WidgetMode = "inline" | "floating";
 interface WidgetEventBase {
@@ -490,32 +517,12 @@ interface WelcomeConfig {
     /** Suggestion cards shown in the welcome screen. Disappear after the first message. */
     suggestions?: string[];
 }
-/** Where a suggestion pill came from. */
-/**
- * Every place a suggestion pill can come from. The single source of truth:
- * {@link SuggestionOrigin} derives from it, and runtime validation reads it,
- * so adding an origin is a one-line change.
- */
-declare const SUGGESTION_ORIGINS: readonly ["channel", "page", "flow", "followup"];
-/** Where a suggestion pill came from. */
-type SuggestionOrigin = (typeof SUGGESTION_ORIGINS)[number];
 interface SuggestionsConfig {
     /**
-     * Initial suggestions to show before the user sends their first message.
+     * Starter prompts shown before the user sends their first message.
      * Defaults to an empty array.
      */
     initial?: string[];
-    /**
-     * Which providers may fill the pill row. Omitted, this defaults to
-     * `["channel", "page", "followup"]`: starter prompts and generated
-     * follow-ups render, flow-driven pills stay opt-in.
-     */
-    origins?: SuggestionOrigin[];
-    /**
-     * @deprecated Use `origins`. `true` maps to every origin, `false` to none.
-     * Will be removed in a future minor release.
-     */
-    dynamic?: boolean;
 }
 /**
  * Per-slot class name overrides for the chat widget. Each string is appended
@@ -595,13 +602,15 @@ interface ChatBaseProps {
     /** Callback fired when a response is received */
     onResponseReceived?: () => void;
     /**
-     * Suggestion pill configuration. Unset: no suggestions. An object sets
-     * starter prompts (`initial`) and which origins may fill the per-turn
-     * pill row (`origins`); `origins: ["flow"]` (or any list including
-     * `"flow"`) opts into flow-driven pills. `true` enables every origin with
-     * defaults; `false` hides the pill row entirely.
+     * Suggestion pills. The row obeys a fixed hierarchy — flow > followup >
+     * page > channel — and every origin is always active.
+     *
+     * `false` hides the row; `true` / unset is the default. `{ initial: [...] }`
+     * sets starter prompts. Embed hosts pass the resolved
+     * {@link PreChatSuggestions} from `useSuggestions(config)` instead, which
+     * carries the prompt ids needed for click attribution.
      */
-    suggestions?: boolean | SuggestionsConfig;
+    suggestions?: boolean | SuggestionsConfig | PreChatSuggestions;
     /**
      * Handler for MCP tool calls from widgets.
      * Called when a widget uses `callServerTool` (MCP Apps standard).
@@ -937,15 +946,6 @@ interface WaniwaniChatOverrides {
     placeholder?: string;
     /** Initial suggestion chips. */
     suggestions?: string[];
-    /**
-     * Which providers may fill the per-turn pill row. Defaults to
-     * `["channel", "page", "followup"]` when unset: starter prompts and
-     * generated follow-ups render, flow-driven pills stay opt-in — include
-     * `"flow"` to render the pills a flow drives via
-     * `interrupt({ suggestions })`. Starter prompts (`suggestions`) are
-     * unaffected by this field and show either way.
-     */
-    suggestionOrigins?: SuggestionOrigin[];
     /** Persist conversations across reloads in IndexedDB. */
     enableThreadHistory?: boolean;
     /**