@waniwani/sdk 0.18.1 → 0.19.1

package/dist/chat/index.d.ts

@@ -361,6 +361,8 @@ type WidgetEventDetail = {
     properties: {
         text: string;
         index: number;
+        /** Which provider supplied the clicked pill: `"channel"` (starter prompts), `"page"` (per-URL starter prompts), `"flow"` (an MCP flow's `interrupt({ suggestions })`), or `"followup"` (generated from the conversation). */
+        origin: SuggestionOrigin;
     };
 } | {
     name: "link.clicked";
@@ -474,6 +476,15 @@ 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.
@@ -481,8 +492,14 @@ interface SuggestionsConfig {
      */
     initial?: string[];
     /**
-     * Enable AI-generated suggestions after each response.
-     * Defaults to `true` when suggestions config is provided.
+     * 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;
 }
@@ -564,8 +581,11 @@ interface ChatBaseProps {
     /** Callback fired when a response is received */
     onResponseReceived?: () => void;
     /**
-     * Enable AI-generated suggestions after each response.
-     * `true` enables with defaults (3 suggestions), object allows config, `false`/undefined disables.
+     * 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.
      */
     suggestions?: boolean | SuggestionsConfig;
     /**
@@ -903,6 +923,15 @@ 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;
     /**