@helpai/elements 0.61.5 → 0.62.1

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.5" : "0.0.0-dev";
+var ELEMENTS_VERSION = true ? "0.62.1" : "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);
@@ -4526,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 () => {
@@ -6890,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(
@@ -6913,7 +6925,7 @@ function Panel(props2) {
             ...props2,
             containerEl: containerRef.current,
             dragOver,
-            composerAttachApiRef
+            composerAttachApiRef: composerApiRef
           }
         ),
         /* @__PURE__ */ jsx23(PoweredByBar, { poweredBy: props2.options.poweredBy })
@@ -7894,10 +7906,13 @@ function MessengerHome({
       el.removeEventListener("keydown", onKey);
     };
   }, [panelProps.onClose]);
-  const composerAttachApiRef = useRef8(null);
-  const onDropItems = useCallback4((items) => {
-    composerAttachApiRef.current?.attachFromDrop(items);
-  }, []);
+  const composerApiRef = panelProps.composerApiRef;
+  const onDropItems = useCallback4(
+    (items) => {
+      composerApiRef.current?.attachFromDrop(items);
+    },
+    [composerApiRef]
+  );
   const { visible: dragOver } = useFileDrop({ containerRef, onDrop: onDropItems });
   useDragMove(containerRef.current, options.mode === "modal");
   const navState = useComputed8(() => nav.sig.value).value;
@@ -7948,7 +7963,7 @@ function MessengerHome({
           ...panelProps,
           containerEl: containerRef.current,
           dragOver,
-          composerAttachApiRef
+          composerAttachApiRef: composerApiRef
         }
       );
     }
@@ -8230,6 +8245,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), []);
@@ -9137,6 +9153,7 @@ function App({ options, hostElement, bus }) {
     feedback,
     bus,
     persistence,
+    composerApiRef,
     view,
     canSend,
     isStreaming: streaming,
@@ -9162,9 +9179,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.5"
+  "version": "0.62.1"
 }

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.5" : "0.0.0-dev";
+var ELEMENTS_VERSION = true ? "0.62.1" : "0.0.0-dev";
 var ELEMENTS_VERSION_PARAM = "_ev";
 
 // src/stream/types.ts
@@ -4485,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 () => {
@@ -6849,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(
@@ -6872,7 +6884,7 @@ function Panel(props2) {
             ...props2,
             containerEl: containerRef.current,
             dragOver,
-            composerAttachApiRef
+            composerAttachApiRef: composerApiRef
           }
         ),
         /* @__PURE__ */ jsx23(PoweredByBar, { poweredBy: props2.options.poweredBy })
@@ -7853,10 +7865,13 @@ function MessengerHome({
       el.removeEventListener("keydown", onKey);
     };
   }, [panelProps.onClose]);
-  const composerAttachApiRef = useRef8(null);
-  const onDropItems = useCallback4((items) => {
-    composerAttachApiRef.current?.attachFromDrop(items);
-  }, []);
+  const composerApiRef = panelProps.composerApiRef;
+  const onDropItems = useCallback4(
+    (items) => {
+      composerApiRef.current?.attachFromDrop(items);
+    },
+    [composerApiRef]
+  );
   const { visible: dragOver } = useFileDrop({ containerRef, onDrop: onDropItems });
   useDragMove(containerRef.current, options.mode === "modal");
   const navState = useComputed8(() => nav.sig.value).value;
@@ -7907,7 +7922,7 @@ function MessengerHome({
           ...panelProps,
           containerEl: containerRef.current,
           dragOver,
-          composerAttachApiRef
+          composerAttachApiRef: composerApiRef
         }
       );
     }
@@ -8189,6 +8204,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), []);
@@ -9096,6 +9112,7 @@ function App({ options, hostElement, bus }) {
     feedback,
     bus,
     persistence,
+    composerApiRef,
     view,
     canSend,
     isStreaming: streaming,
@@ -9121,9 +9138,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.