@helpai/elements 0.61.4 → 0.62.0

package/index.d.ts

@@ -1,4 +1,4 @@
-export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, H as HandshakeResponse, L as Link, S as ServerConfig, b as SiteConfig, W as WidgetConfig, c as WidgetConfigPartial, d as WidgetSettings, e as WidgetSettingsPartial } from './deployment-D9QqhMzi.js';
+export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, H as HandshakeResponse, L as Link, S as ServerConfig, b as SiteConfig, W as WidgetConfig, c as WidgetConfigPartial, d as WidgetSettings, e as WidgetSettingsPartial } from './deployment-i9cta98X.js';
 import 'zod';
 
 /**
@@ -871,6 +871,8 @@ interface BehaviorOptions {
     showSources?: boolean;
     /** Turn OFF the 👍/👎 feedback controls on assistant replies. Unset/`false` = shown (default). */
     disableMessageFeedback?: boolean;
+    /** Auto-send a suggestion chip's text on tap. Unset/`false` = fill the composer to edit (default). */
+    autoSendSuggestions?: boolean;
 }
 /**
  * Section: panel header actions — the enabled set (`history`/`close` buttons +
@@ -1187,6 +1189,8 @@ interface ResolvedOptions {
     showSources: boolean;
     /** Show 👍/👎 feedback controls on assistant replies. Default `true`. */
     enableMessageFeedback: boolean;
+    /** Auto-send a suggestion chip's text on tap (vs. filling the composer to edit). Default `false`. */
+    autoSendSuggestions: boolean;
     features: ResolvedFeatures;
     /** Resolved event-driven forms — ordered list + trigger index. */
     forms: ResolvedForms;

package/index.mjs

@@ -29,7 +29,7 @@ var BRAND = {
 };
 
 // src/core/version.ts
-var ELEMENTS_VERSION = true ? "0.61.4" : "0.0.0-dev";
+var ELEMENTS_VERSION = true ? "0.62.0" : "0.0.0-dev";
 var ELEMENTS_VERSION_PARAM = "_ev";
 
 // src/i18n/strings.ts
@@ -1105,6 +1105,7 @@ function resolveOptions(rawOpts) {
     showToolCalls: behavior.showToolCalls ?? false,
     showSources: behavior.showSources ?? false,
     enableMessageFeedback: !(behavior.disableMessageFeedback ?? false),
+    autoSendSuggestions: behavior.autoSendSuggestions ?? false,
     features: {
       voice: opts.features?.voice ?? DEFAULT_FEATURES.voice,
       fileUpload: !(opts.features?.disableFileUpload ?? false),
@@ -1433,7 +1434,8 @@ var BEHAVIOR_ATTRS = [
   ["show-reasoning", "showReasoning", boolAttr],
   ["show-tool-calls", "showToolCalls", boolAttr],
   ["show-sources", "showSources", boolAttr],
-  ["disable-message-feedback", "disableMessageFeedback", boolAttr]
+  ["disable-message-feedback", "disableMessageFeedback", boolAttr],
+  ["auto-send-suggestions", "autoSendSuggestions", boolAttr]
 ];
 var I18N_ATTRS = [["locale", "locale"]];
 var ACTION_NAMES = new Set(ACTION_NAME_LITERALS);
@@ -2254,15 +2256,6 @@ function retryAfterMs(headers) {
   const ms = Number.isFinite(secs) ? secs * 1e3 : Date.parse(raw) - Date.now();
   return Number.isFinite(ms) && ms >= 0 ? Math.min(ms, 3e4) : null;
 }
-function followupsFromMessages(messages) {
-  for (let i = messages.length - 1; i >= 0; i--) {
-    const m = messages[i];
-    if (!m || m.role !== "assistant") continue;
-    const part = m.parts.find((p36) => p36.type === "data-suggestions");
-    return part?.type === "data-suggestions" ? parseSuggestions(part.data) : void 0;
-  }
-  return void 0;
-}
 function sleep(ms, signal7) {
   return new Promise((resolve) => {
     if (signal7?.aborted) return resolve();
@@ -2509,10 +2502,10 @@ var AgentTransport = class {
       canContinue: res.canContinue ?? true,
       messages,
       agent: res.agent,
-      // The latest turn's model follow-ups are persisted ON the assistant message (a `data-suggestions`
-      // part), not in a top-level field — read them off there, falling back to any server-provided
-      // top-level `suggestions` (e.g. resume chips) when the last turn carried none.
-      suggestions: followupsFromMessages(messages) ?? res.suggestions
+      // Top-level STARTER chips (resume / new-chat), not turn-tied. A turn's own model follow-ups ride
+      // ON its assistant message (`data-suggestions` part), lifted onto `message.suggestions` by
+      // `fromWireMessage`; the App prefers the last turn's and falls back to these starters.
+      suggestions: res.suggestions
     };
   }
   /**
@@ -3014,9 +3007,11 @@ function fromWireMessage(w) {
     }
     return null;
   }).filter((p36) => p36 !== null);
+  const suggestionsPart = w.parts.find((p36) => p36.type === "data-suggestions");
   return {
     id: w.id,
     role: w.role,
+    suggestions: suggestionsPart?.type === "data-suggestions" ? parseSuggestions(suggestionsPart.data) : void 0,
     // On reload the wire `id` IS the backend's id — keep it as `serverMessageId`
     // too so a HITL re-POST after a reload still references the backend's message.
     serverMessageId: w.id,
@@ -3239,6 +3234,7 @@ var StreamReducer = class {
       case "data-conversation-rebind":
         return;
       case "data-suggestions":
+        m.suggestions = parseSuggestions(chunk.data);
         return;
       default: {
         const _exhaustive = chunk;
@@ -4532,6 +4528,13 @@ function Composer({ options, transport, feedback, bus, isStreaming, onSend, onSt
         log11.info("attach (drop)", { count: result.accepted.length, totalBytes: totalBytes(result.accepted) });
         bus.emit("attach", { count: result.accepted.length, totalBytes: totalBytes(result.accepted) });
         setAtts((prev) => [...prev, ...result.accepted]);
+      },
+      fill: (value) => {
+        setText(value);
+        const el = taRef.current;
+        if (!el) return;
+        el.focus({ preventScroll: true });
+        requestAnimationFrame(() => el.setSelectionRange(el.value.length, el.value.length));
       }
     };
     return () => {
@@ -6896,10 +6899,13 @@ function Panel(props2) {
       el.removeEventListener("keydown", onKey);
     };
   }, [onClose]);
-  const composerAttachApiRef = useRef6(null);
-  const onDropItems = useCallback2((items) => {
-    composerAttachApiRef.current?.attachFromDrop(items);
-  }, []);
+  const composerApiRef = props2.composerApiRef;
+  const onDropItems = useCallback2(
+    (items) => {
+      composerApiRef.current?.attachFromDrop(items);
+    },
+    [composerApiRef]
+  );
   const { visible: dragOver } = useFileDrop({ containerRef, onDrop: onDropItems });
   useDragMove(containerRef.current, options.mode === "modal");
   return /* @__PURE__ */ jsxs18(
@@ -6919,7 +6925,7 @@ function Panel(props2) {
             ...props2,
             containerEl: containerRef.current,
             dragOver,
-            composerAttachApiRef
+            composerAttachApiRef: composerApiRef
           }
         ),
         /* @__PURE__ */ jsx23(PoweredByBar, { poweredBy: props2.options.poweredBy })
@@ -8236,6 +8242,7 @@ function App({ options, hostElement, bus }) {
   const resumeBubbleRef = useRef9(null);
   const regenerateDanglingRef = useRef9(null);
   const regenInFlightRef = useRef9(false);
+  const composerApiRef = useRef9(null);
   const markActiveConversationReadRef = useRef9(null);
   const markReadTimerRef = useRef9();
   useEffect16(() => () => clearTimeout(markReadTimerRef.current), []);
@@ -8305,7 +8312,8 @@ function App({ options, hostElement, bus }) {
         if (loaded.length || tail.length) {
           messagesSig.value = [...withWelcomeRows(loaded, markers), ...tail];
           setCanSend(chat.canContinue ?? true);
-          setSuggestions(chat.suggestions ?? []);
+          const lastTurn = loaded.findLast((m) => m.role === "assistant" && !m.ephemeral);
+          setSuggestions(lastTurn?.suggestions ?? chat.suggestions ?? []);
         } else {
           messagesSig.value = withWelcomeRows([], markers);
         }
@@ -8439,11 +8447,10 @@ function App({ options, hostElement, bus }) {
   useEffect16(() => {
     if (effectiveLocale !== activeLocale) setActiveLocale(effectiveLocale);
   }, [effectiveLocale, activeLocale]);
-  const captureSuggestions = useCallback6((chunk) => {
-    if (chunk.type !== "data-suggestions") return false;
-    setSuggestions(parseSuggestions(chunk.data));
-    return true;
-  }, []);
+  const settleSuggestions = useCallback6(
+    (turn, starters = []) => setSuggestions(turn.suggestions ?? starters),
+    []
+  );
   const adoptConversationRebind = useCallback6(
     (chunk) => {
       if (chunk.type !== "data-conversation-rebind") return false;
@@ -8465,7 +8472,7 @@ function App({ options, hostElement, bus }) {
       let bubble = null;
       try {
         for await (const evt of handle.iter) {
-          if (adoptConversationRebind(evt.chunk) || captureSuggestions(evt.chunk)) continue;
+          if (adoptConversationRebind(evt.chunk)) continue;
           if (!bubble) {
             bubble = makeAssistantMessage();
             resumeBubbleRef.current = bubble;
@@ -8491,6 +8498,7 @@ function App({ options, hostElement, bus }) {
             bubble.status = "complete";
             feedback.play("messageReceived");
             emitMessage(bus, options, "assistant", assistantText(bubble));
+            settleSuggestions(bubble);
           }
         }
       } catch (err) {
@@ -8635,7 +8643,7 @@ function App({ options, hostElement, bus }) {
       setActiveDetach(() => handle.detach);
       try {
         for await (const evt of handle.iter) {
-          if (adoptConversationRebind(evt.chunk) || captureSuggestions(evt.chunk)) continue;
+          if (adoptConversationRebind(evt.chunk)) continue;
           reducer.apply(evt.chunk);
           if (evt.chunk.type === "finish" && evt.chunk.canContinue === false) {
             setCanSend(false);
@@ -8654,6 +8662,7 @@ function App({ options, hostElement, bus }) {
           assistantMsg.status = "complete";
           feedback.play("messageReceived");
           emitMessage(bus, options, "assistant", assistantText(assistantMsg));
+          settleSuggestions(assistantMsg);
         }
       } catch (error) {
         if (isAbortError(error)) {
@@ -9072,7 +9081,8 @@ function App({ options, hostElement, bus }) {
         transport.primeIdentity(visitorId, res.conversationId);
         if (res.agent) setAgent(res.agent);
         setCanSend(res.canContinue);
-        setSuggestions(res.suggestions ?? []);
+        const lastTurn = hydrated.findLast((m) => m.role === "assistant" && !m.ephemeral);
+        setSuggestions(lastTurn?.suggestions ?? res.suggestions ?? []);
         setView("chat");
         void resumeInFlight();
         await transport.markRead(targetConversationId);
@@ -9140,6 +9150,7 @@ function App({ options, hostElement, bus }) {
     feedback,
     bus,
     persistence,
+    composerApiRef,
     view,
     canSend,
     isStreaming: streaming,
@@ -9165,9 +9176,10 @@ function App({ options, hostElement, bus }) {
     onStop: handleStop,
     onSuggestion: (s) => {
       const text = s.text ?? s.label;
-      log17.info("suggestion", { text });
+      log17.info("suggestion", { text, autoSend: options.autoSendSuggestions });
       bus.emit("suggestion", { text });
-      void handleSend(text, []);
+      if (options.autoSendSuggestions) void handleSend(text, []);
+      else composerApiRef.current?.fill(text);
     },
     // Active form: replaces the composer as a gate and locks every chat action
     // until the visitor submits or (when skippable) skips.

package/package.json

@@ -80,5 +80,5 @@
   ],
   "type": "module",
   "types": "./index.d.ts",
-  "version": "0.61.4"
+  "version": "0.62.0"
 }

package/schema.d.ts

@@ -1,4 +1,4 @@
-export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, E as Endpoints, H as HandshakeResponse, L as Link, P as PAGE_AREA_SUGGESTIONS, f as PageContext, S as ServerConfig, b as SiteConfig, U as UserContext, W as WidgetConfig, c as WidgetConfigPartial, d as WidgetSettings, e as WidgetSettingsPartial, g as assetSchema, h as blocksConfigSchema, i as connectionConfigPartialSchema, j as connectionConfigSchema, k as cssColorSchema, l as cssLengthSchema, m as endpointsSchema, n as handshakeResponseSchema, o as linkSchema, p as localeSchema, q as pageContextSchema, s as serverConfigSchema, r as siteConfigSchema, u as userContextSchema, t as uuid7Schema, w as widgetConfigPartialSchema, v as widgetConfigSchema, x as widgetSettingsPartialSchema, y as widgetSettingsSchema } from './deployment-D9QqhMzi.js';
+export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, E as Endpoints, H as HandshakeResponse, L as Link, P as PAGE_AREA_SUGGESTIONS, f as PageContext, S as ServerConfig, b as SiteConfig, U as UserContext, W as WidgetConfig, c as WidgetConfigPartial, d as WidgetSettings, e as WidgetSettingsPartial, g as assetSchema, h as blocksConfigSchema, i as connectionConfigPartialSchema, j as connectionConfigSchema, k as cssColorSchema, l as cssLengthSchema, m as endpointsSchema, n as handshakeResponseSchema, o as linkSchema, p as localeSchema, q as pageContextSchema, s as serverConfigSchema, r as siteConfigSchema, u as userContextSchema, t as uuid7Schema, w as widgetConfigPartialSchema, v as widgetConfigSchema, x as widgetSettingsPartialSchema, y as widgetSettingsSchema } from './deployment-i9cta98X.js';
 import { z } from 'zod';
 
 /**
@@ -85,6 +85,7 @@ declare const behaviorSchema: z.ZodObject<{
     showToolCalls: z.ZodDefault<z.ZodBoolean>;
     showSources: z.ZodDefault<z.ZodBoolean>;
     disableMessageFeedback: z.ZodDefault<z.ZodBoolean>;
+    autoSendSuggestions: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$loose>;
 type Behavior = z.infer<typeof behaviorSchema>;
 

package/schema.json

@@ -489,6 +489,11 @@
               "default": false,
               "description": "Turn OFF the 👍/👎 feedback controls under each assistant reply. Unset/`false` = shown (default), `true` = hidden. A choice fires the `messageFeedback` event and is POSTed best-effort to `/pai/message-feedback`.",
               "type": "boolean"
+            },
+            "autoSendSuggestions": {
+              "default": false,
+              "description": "Auto-send a suggestion chip's text the moment it's tapped. `false` (default) fills the composer with the text so the visitor can edit before sending; `true` sends it immediately.",
+              "type": "boolean"
             }
           },
           "required": [
@@ -497,7 +502,8 @@
             "showReasoning",
             "showToolCalls",
             "showSources",
-            "disableMessageFeedback"
+            "disableMessageFeedback",
+            "autoSendSuggestions"
           ],
           "additionalProperties": {},
           "description": "Conversation behaviour — lifecycle, streaming, and the transcript surface (scroll, feedback).",
@@ -2360,6 +2366,11 @@
                   "default": false,
                   "description": "Turn OFF the 👍/👎 feedback controls under each assistant reply. Unset/`false` = shown (default), `true` = hidden. A choice fires the `messageFeedback` event and is POSTed best-effort to `/pai/message-feedback`.",
                   "type": "boolean"
+                },
+                "autoSendSuggestions": {
+                  "default": false,
+                  "description": "Auto-send a suggestion chip's text the moment it's tapped. `false` (default) fills the composer with the text so the visitor can edit before sending; `true` sends it immediately.",
+                  "type": "boolean"
                 }
               },
               "required": [
@@ -2368,7 +2379,8 @@
                 "showReasoning",
                 "showToolCalls",
                 "showSources",
-                "disableMessageFeedback"
+                "disableMessageFeedback",
+                "autoSendSuggestions"
               ],
               "additionalProperties": {},
               "description": "Conversation behaviour — lifecycle, streaming, and the transcript surface (scroll, feedback).",

package/schema.mjs

@@ -133,6 +133,9 @@ var behaviorSchema = z4.object({
   ),
   disableMessageFeedback: z4.boolean().default(false).describe(
     "Turn OFF the \u{1F44D}/\u{1F44E} feedback controls under each assistant reply. Unset/`false` = shown (default), `true` = hidden. A choice fires the `messageFeedback` event and is POSTed best-effort to `/pai/message-feedback`."
+  ),
+  autoSendSuggestions: z4.boolean().default(false).describe(
+    "Auto-send a suggestion chip's text the moment it's tapped. `false` (default) fills the composer with the text so the visitor can edit before sending; `true` sends it immediately."
   )
 }).loose().describe("Conversation behaviour \u2014 lifecycle, streaming, and the transcript surface (scroll, feedback).").meta({
   examples: [

package/web-component.mjs

@@ -1086,6 +1086,7 @@ function resolveOptions(rawOpts) {
     showToolCalls: behavior.showToolCalls ?? false,
     showSources: behavior.showSources ?? false,
     enableMessageFeedback: !(behavior.disableMessageFeedback ?? false),
+    autoSendSuggestions: behavior.autoSendSuggestions ?? false,
     features: {
       voice: opts.features?.voice ?? DEFAULT_FEATURES.voice,
       fileUpload: !(opts.features?.disableFileUpload ?? false),
@@ -1414,7 +1415,8 @@ var BEHAVIOR_ATTRS = [
   ["show-reasoning", "showReasoning", boolAttr],
   ["show-tool-calls", "showToolCalls", boolAttr],
   ["show-sources", "showSources", boolAttr],
-  ["disable-message-feedback", "disableMessageFeedback", boolAttr]
+  ["disable-message-feedback", "disableMessageFeedback", boolAttr],
+  ["auto-send-suggestions", "autoSendSuggestions", boolAttr]
 ];
 var I18N_ATTRS = [["locale", "locale"]];
 var ACTION_NAMES = new Set(ACTION_NAME_LITERALS);
@@ -1930,7 +1932,7 @@ function createAuth(opts) {
 }
 
 // src/core/version.ts
-var ELEMENTS_VERSION = true ? "0.61.4" : "0.0.0-dev";
+var ELEMENTS_VERSION = true ? "0.62.0" : "0.0.0-dev";
 var ELEMENTS_VERSION_PARAM = "_ev";
 
 // src/stream/types.ts
@@ -2213,15 +2215,6 @@ function retryAfterMs(headers) {
   const ms = Number.isFinite(secs) ? secs * 1e3 : Date.parse(raw) - Date.now();
   return Number.isFinite(ms) && ms >= 0 ? Math.min(ms, 3e4) : null;
 }
-function followupsFromMessages(messages) {
-  for (let i = messages.length - 1; i >= 0; i--) {
-    const m = messages[i];
-    if (!m || m.role !== "assistant") continue;
-    const part = m.parts.find((p36) => p36.type === "data-suggestions");
-    return part?.type === "data-suggestions" ? parseSuggestions(part.data) : void 0;
-  }
-  return void 0;
-}
 function sleep(ms, signal7) {
   return new Promise((resolve) => {
     if (signal7?.aborted) return resolve();
@@ -2468,10 +2461,10 @@ var AgentTransport = class {
       canContinue: res.canContinue ?? true,
       messages,
       agent: res.agent,
-      // The latest turn's model follow-ups are persisted ON the assistant message (a `data-suggestions`
-      // part), not in a top-level field — read them off there, falling back to any server-provided
-      // top-level `suggestions` (e.g. resume chips) when the last turn carried none.
-      suggestions: followupsFromMessages(messages) ?? res.suggestions
+      // Top-level STARTER chips (resume / new-chat), not turn-tied. A turn's own model follow-ups ride
+      // ON its assistant message (`data-suggestions` part), lifted onto `message.suggestions` by
+      // `fromWireMessage`; the App prefers the last turn's and falls back to these starters.
+      suggestions: res.suggestions
     };
   }
   /**
@@ -2973,9 +2966,11 @@ function fromWireMessage(w) {
     }
     return null;
   }).filter((p36) => p36 !== null);
+  const suggestionsPart = w.parts.find((p36) => p36.type === "data-suggestions");
   return {
     id: w.id,
     role: w.role,
+    suggestions: suggestionsPart?.type === "data-suggestions" ? parseSuggestions(suggestionsPart.data) : void 0,
     // On reload the wire `id` IS the backend's id — keep it as `serverMessageId`
     // too so a HITL re-POST after a reload still references the backend's message.
     serverMessageId: w.id,
@@ -3198,6 +3193,7 @@ var StreamReducer = class {
       case "data-conversation-rebind":
         return;
       case "data-suggestions":
+        m.suggestions = parseSuggestions(chunk.data);
         return;
       default: {
         const _exhaustive = chunk;
@@ -4491,6 +4487,13 @@ function Composer({ options, transport, feedback, bus, isStreaming, onSend, onSt
         log10.info("attach (drop)", { count: result.accepted.length, totalBytes: totalBytes(result.accepted) });
         bus.emit("attach", { count: result.accepted.length, totalBytes: totalBytes(result.accepted) });
         setAtts((prev) => [...prev, ...result.accepted]);
+      },
+      fill: (value) => {
+        setText(value);
+        const el = taRef.current;
+        if (!el) return;
+        el.focus({ preventScroll: true });
+        requestAnimationFrame(() => el.setSelectionRange(el.value.length, el.value.length));
       }
     };
     return () => {
@@ -6855,10 +6858,13 @@ function Panel(props2) {
       el.removeEventListener("keydown", onKey);
     };
   }, [onClose]);
-  const composerAttachApiRef = useRef6(null);
-  const onDropItems = useCallback2((items) => {
-    composerAttachApiRef.current?.attachFromDrop(items);
-  }, []);
+  const composerApiRef = props2.composerApiRef;
+  const onDropItems = useCallback2(
+    (items) => {
+      composerApiRef.current?.attachFromDrop(items);
+    },
+    [composerApiRef]
+  );
   const { visible: dragOver } = useFileDrop({ containerRef, onDrop: onDropItems });
   useDragMove(containerRef.current, options.mode === "modal");
   return /* @__PURE__ */ jsxs18(
@@ -6878,7 +6884,7 @@ function Panel(props2) {
             ...props2,
             containerEl: containerRef.current,
             dragOver,
-            composerAttachApiRef
+            composerAttachApiRef: composerApiRef
           }
         ),
         /* @__PURE__ */ jsx23(PoweredByBar, { poweredBy: props2.options.poweredBy })
@@ -8195,6 +8201,7 @@ function App({ options, hostElement, bus }) {
   const resumeBubbleRef = useRef9(null);
   const regenerateDanglingRef = useRef9(null);
   const regenInFlightRef = useRef9(false);
+  const composerApiRef = useRef9(null);
   const markActiveConversationReadRef = useRef9(null);
   const markReadTimerRef = useRef9();
   useEffect16(() => () => clearTimeout(markReadTimerRef.current), []);
@@ -8264,7 +8271,8 @@ function App({ options, hostElement, bus }) {
         if (loaded.length || tail.length) {
           messagesSig.value = [...withWelcomeRows(loaded, markers), ...tail];
           setCanSend(chat.canContinue ?? true);
-          setSuggestions(chat.suggestions ?? []);
+          const lastTurn = loaded.findLast((m) => m.role === "assistant" && !m.ephemeral);
+          setSuggestions(lastTurn?.suggestions ?? chat.suggestions ?? []);
         } else {
           messagesSig.value = withWelcomeRows([], markers);
         }
@@ -8398,11 +8406,10 @@ function App({ options, hostElement, bus }) {
   useEffect16(() => {
     if (effectiveLocale !== activeLocale) setActiveLocale(effectiveLocale);
   }, [effectiveLocale, activeLocale]);
-  const captureSuggestions = useCallback6((chunk) => {
-    if (chunk.type !== "data-suggestions") return false;
-    setSuggestions(parseSuggestions(chunk.data));
-    return true;
-  }, []);
+  const settleSuggestions = useCallback6(
+    (turn, starters = []) => setSuggestions(turn.suggestions ?? starters),
+    []
+  );
   const adoptConversationRebind = useCallback6(
     (chunk) => {
       if (chunk.type !== "data-conversation-rebind") return false;
@@ -8424,7 +8431,7 @@ function App({ options, hostElement, bus }) {
       let bubble = null;
       try {
         for await (const evt of handle.iter) {
-          if (adoptConversationRebind(evt.chunk) || captureSuggestions(evt.chunk)) continue;
+          if (adoptConversationRebind(evt.chunk)) continue;
           if (!bubble) {
             bubble = makeAssistantMessage();
             resumeBubbleRef.current = bubble;
@@ -8450,6 +8457,7 @@ function App({ options, hostElement, bus }) {
             bubble.status = "complete";
             feedback.play("messageReceived");
             emitMessage(bus, options, "assistant", assistantText(bubble));
+            settleSuggestions(bubble);
           }
         }
       } catch (err) {
@@ -8594,7 +8602,7 @@ function App({ options, hostElement, bus }) {
       setActiveDetach(() => handle.detach);
       try {
         for await (const evt of handle.iter) {
-          if (adoptConversationRebind(evt.chunk) || captureSuggestions(evt.chunk)) continue;
+          if (adoptConversationRebind(evt.chunk)) continue;
           reducer.apply(evt.chunk);
           if (evt.chunk.type === "finish" && evt.chunk.canContinue === false) {
             setCanSend(false);
@@ -8613,6 +8621,7 @@ function App({ options, hostElement, bus }) {
           assistantMsg.status = "complete";
           feedback.play("messageReceived");
           emitMessage(bus, options, "assistant", assistantText(assistantMsg));
+          settleSuggestions(assistantMsg);
         }
       } catch (error) {
         if (isAbortError(error)) {
@@ -9031,7 +9040,8 @@ function App({ options, hostElement, bus }) {
         transport.primeIdentity(visitorId, res.conversationId);
         if (res.agent) setAgent(res.agent);
         setCanSend(res.canContinue);
-        setSuggestions(res.suggestions ?? []);
+        const lastTurn = hydrated.findLast((m) => m.role === "assistant" && !m.ephemeral);
+        setSuggestions(lastTurn?.suggestions ?? res.suggestions ?? []);
         setView("chat");
         void resumeInFlight();
         await transport.markRead(targetConversationId);
@@ -9099,6 +9109,7 @@ function App({ options, hostElement, bus }) {
     feedback,
     bus,
     persistence,
+    composerApiRef,
     view,
     canSend,
     isStreaming: streaming,
@@ -9124,9 +9135,10 @@ function App({ options, hostElement, bus }) {
     onStop: handleStop,
     onSuggestion: (s) => {
       const text = s.text ?? s.label;
-      log16.info("suggestion", { text });
+      log16.info("suggestion", { text, autoSend: options.autoSendSuggestions });
       bus.emit("suggestion", { text });
-      void handleSend(text, []);
+      if (options.autoSendSuggestions) void handleSend(text, []);
+      else composerApiRef.current?.fill(text);
     },
     // Active form: replaces the composer as a gate and locks every chat action
     // until the visitor submits or (when skippable) skips.