@helpai/elements 0.58.2 → 0.59.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-BAOjO2dQ.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-Daefe1g1.js';
 import 'zod';
 
 /**

package/index.mjs

@@ -29,7 +29,7 @@ var BRAND = {
 };
 
 // src/core/version.ts
-var ELEMENTS_VERSION = true ? "0.58.2" : "0.0.0-dev";
+var ELEMENTS_VERSION = true ? "0.59.0" : "0.0.0-dev";
 var ELEMENTS_VERSION_PARAM = "_ev";
 
 // src/i18n/strings.ts
@@ -3208,6 +3208,8 @@ var StreamReducer = class {
         return;
       case "data-conversation-rebind":
         return;
+      case "data-suggestions":
+        return;
       default: {
         const _exhaustive = chunk;
         void _exhaustive;
@@ -6838,6 +6840,22 @@ function ConversationList({
 // src/ui/suggestions.tsx
 import { jsx as jsx22 } from "preact/jsx-runtime";
 var p19 = BRAND.cssPrefix;
+function parseSuggestions(data) {
+  const raw = data?.suggestions;
+  if (!Array.isArray(raw)) return [];
+  const out = [];
+  for (const item of raw) {
+    if (!item || typeof item !== "object") continue;
+    const { id, label, text } = item;
+    if (typeof label !== "string" || !label) continue;
+    out.push({
+      id: typeof id === "string" && id ? id : `s${out.length}`,
+      label,
+      text: typeof text === "string" && text ? text : label
+    });
+  }
+  return out;
+}
 function Suggestions({ suggestions, onPick }) {
   if (suggestions.length === 0) return null;
   return /* @__PURE__ */ jsx22("div", { class: `${p19}-suggestions`, role: "group", "aria-label": "Suggested replies", children: suggestions.map((s, i) => /* @__PURE__ */ jsx22(
@@ -8407,6 +8425,18 @@ function App({ options, hostElement, bus }) {
   useEffect16(() => {
     if (effectiveLocale !== activeLocale) setActiveLocale(effectiveLocale);
   }, [effectiveLocale, activeLocale]);
+  const pendingSuggestionsRef = useRef9(null);
+  const captureSuggestions = useCallback6((chunk) => {
+    if (chunk.type !== "data-suggestions") return false;
+    pendingSuggestionsRef.current = parseSuggestions(chunk.data);
+    return true;
+  }, []);
+  const flushSuggestions = useCallback6(() => {
+    if (pendingSuggestionsRef.current) {
+      setSuggestions(pendingSuggestionsRef.current);
+      pendingSuggestionsRef.current = null;
+    }
+  }, []);
   const adoptConversationRebind = useCallback6(
     (chunk) => {
       if (chunk.type !== "data-conversation-rebind") return false;
@@ -8426,9 +8456,10 @@ function App({ options, hostElement, bus }) {
   const runResume = useCallback6(
     async (handle) => {
       let bubble = null;
+      pendingSuggestionsRef.current = null;
       try {
         for await (const evt of handle.iter) {
-          if (adoptConversationRebind(evt.chunk)) continue;
+          if (adoptConversationRebind(evt.chunk) || captureSuggestions(evt.chunk)) continue;
           if (!bubble) {
             bubble = makeAssistantMessage();
             resumeBubbleRef.current = bubble;
@@ -8454,6 +8485,7 @@ function App({ options, hostElement, bus }) {
             bubble.status = "complete";
             feedback.play("messageReceived");
             emitMessage(bus, options, "assistant", assistantText(bubble));
+            flushSuggestions();
           }
         }
       } catch (err) {
@@ -8592,12 +8624,13 @@ function App({ options, hostElement, bus }) {
         userPrefs: persistence.loadUserPrefs()
       });
       setStreaming(true);
+      pendingSuggestionsRef.current = null;
       const handle = transport.sendMessage(body);
       setActiveCancel(() => handle.cancel);
       setActiveDetach(() => handle.detach);
       try {
         for await (const evt of handle.iter) {
-          if (adoptConversationRebind(evt.chunk)) continue;
+          if (adoptConversationRebind(evt.chunk) || captureSuggestions(evt.chunk)) continue;
           reducer.apply(evt.chunk);
           if (evt.chunk.type === "finish" && evt.chunk.canContinue === false) {
             setCanSend(false);
@@ -8616,6 +8649,7 @@ function App({ options, hostElement, bus }) {
           assistantMsg.status = "complete";
           feedback.play("messageReceived");
           emitMessage(bus, options, "assistant", assistantText(assistantMsg));
+          flushSuggestions();
         }
       } catch (error) {
         if (isAbortError(error)) {

package/package.json

@@ -80,5 +80,5 @@
   ],
   "type": "module",
   "types": "./index.d.ts",
-  "version": "0.58.2"
+  "version": "0.59.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-BAOjO2dQ.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-Daefe1g1.js';
 import { z } from 'zod';
 
 /**
@@ -56,9 +56,9 @@ declare const presentationSchema: z.ZodObject<{
         inset: z.ZodOptional<z.ZodString>;
         initialSize: z.ZodDefault<z.ZodEnum<{
             fullscreen: "fullscreen";
-            normal: "normal";
             expanded: "expanded";
             auto: "auto";
+            normal: "normal";
         }>>;
         autoSizeBreakpoint: z.ZodDefault<z.ZodNumber>;
     }, z.core.$loose>>;
@@ -242,9 +242,9 @@ type LauncherOptions = z.infer<typeof launcherOptionsSchema>;
 
 declare const initialSizeSchema: z.ZodEnum<{
     fullscreen: "fullscreen";
-    normal: "normal";
     expanded: "expanded";
     auto: "auto";
+    normal: "normal";
 }>;
 declare const resizeOptionsSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
@@ -271,9 +271,9 @@ declare const sizeOptionsSchema: z.ZodObject<{
     inset: z.ZodOptional<z.ZodString>;
     initialSize: z.ZodDefault<z.ZodEnum<{
         fullscreen: "fullscreen";
-        normal: "normal";
         expanded: "expanded";
         auto: "auto";
+        normal: "normal";
     }>>;
     autoSizeBreakpoint: z.ZodDefault<z.ZodNumber>;
 }, z.core.$loose>;
@@ -325,40 +325,40 @@ type FeatureFlags = z.infer<typeof featureFlagsSchema>;
  */
 
 declare const actionNameSchema: z.ZodEnum<{
+    close: "close";
     expand: "expand";
     fullscreen: "fullscreen";
-    close: "close";
-    language: "language";
+    clear: "clear";
     theme: "theme";
+    language: "language";
     textSize: "textSize";
     history: "history";
-    clear: "clear";
     sound: "sound";
 }>;
 type ActionName = z.infer<typeof actionNameSchema>;
 declare const headerActionsSchema: z.ZodArray<z.ZodEnum<{
+    close: "close";
     expand: "expand";
     fullscreen: "fullscreen";
-    close: "close";
-    language: "language";
+    clear: "clear";
     theme: "theme";
+    language: "language";
     textSize: "textSize";
     history: "history";
-    clear: "clear";
     sound: "sound";
 }>>;
 type HeaderActions = z.infer<typeof headerActionsSchema>;
 /** Section wrapper — `actions` list wrapped under `header` in the dashboard form. */
 declare const headerSchema: z.ZodObject<{
     actions: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        close: "close";
         expand: "expand";
         fullscreen: "fullscreen";
-        close: "close";
-        language: "language";
+        clear: "clear";
         theme: "theme";
+        language: "language";
         textSize: "textSize";
         history: "history";
-        clear: "clear";
         sound: "sound";
     }>>>;
 }, z.core.$loose>;
@@ -374,33 +374,33 @@ type HeaderOptions = z.infer<typeof headerSchema>;
  */
 
 declare const feedbackEventSchema: z.ZodEnum<{
+    voiceStart: "voiceStart";
+    voiceStop: "voiceStop";
     error: "error";
     messageReceived: "messageReceived";
     messageSent: "messageSent";
-    voiceStart: "voiceStart";
-    voiceStop: "voiceStop";
 }>;
 type FeedbackEvent = z.infer<typeof feedbackEventSchema>;
 declare const soundOptionsSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     volume: z.ZodDefault<z.ZodNumber>;
     events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        voiceStart: "voiceStart";
+        voiceStop: "voiceStop";
         error: "error";
         messageReceived: "messageReceived";
         messageSent: "messageSent";
-        voiceStart: "voiceStart";
-        voiceStop: "voiceStop";
     }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>>;
 }, z.core.$loose>;
 type SoundOptions = z.infer<typeof soundOptionsSchema>;
 declare const hapticsOptionsSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        voiceStart: "voiceStart";
+        voiceStop: "voiceStop";
         error: "error";
         messageReceived: "messageReceived";
         messageSent: "messageSent";
-        voiceStart: "voiceStart";
-        voiceStop: "voiceStop";
     }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodNumber, z.ZodArray<z.ZodNumber>]>>>;
 }, z.core.$loose>;
 type HapticsOptions = z.infer<typeof hapticsOptionsSchema>;
@@ -409,21 +409,21 @@ declare const feedbackSchema: z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         volume: z.ZodDefault<z.ZodNumber>;
         events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+            voiceStart: "voiceStart";
+            voiceStop: "voiceStop";
             error: "error";
             messageReceived: "messageReceived";
             messageSent: "messageSent";
-            voiceStart: "voiceStart";
-            voiceStop: "voiceStop";
         }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>>;
     }, z.core.$loose>>;
     haptics: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+            voiceStart: "voiceStart";
+            voiceStop: "voiceStop";
             error: "error";
             messageReceived: "messageReceived";
             messageSent: "messageSent";
-            voiceStart: "voiceStart";
-            voiceStop: "voiceStop";
         }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodNumber, z.ZodArray<z.ZodNumber>]>>>;
     }, z.core.$loose>>;
 }, z.core.$loose>;
@@ -858,18 +858,18 @@ type I18nOptions = z.infer<typeof i18nSchema>;
  */
 
 declare const moduleLayoutSchema: z.ZodEnum<{
+    home: "home";
     chat: "chat";
     help: "help";
-    home: "home";
     news: "news";
 }>;
 type ModuleLayout = z.infer<typeof moduleLayoutSchema>;
 declare const moduleSchema: z.ZodObject<{
     label: z.ZodString;
     layout: z.ZodEnum<{
+        home: "home";
         chat: "chat";
         help: "help";
-        home: "home";
         news: "news";
     }>;
     contentTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -895,9 +895,9 @@ type ModuleOptions = z.infer<typeof moduleSchema>;
 declare const modulesSchema: z.ZodArray<z.ZodObject<{
     label: z.ZodString;
     layout: z.ZodEnum<{
+        home: "home";
         chat: "chat";
         help: "help";
-        home: "home";
         news: "news";
     }>;
     contentTags: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/web-component.mjs

@@ -1934,7 +1934,7 @@ function createAuth(opts) {
 }
 
 // src/core/version.ts
-var ELEMENTS_VERSION = true ? "0.58.2" : "0.0.0-dev";
+var ELEMENTS_VERSION = true ? "0.59.0" : "0.0.0-dev";
 var ELEMENTS_VERSION_PARAM = "_ev";
 
 // src/stream/types.ts
@@ -3167,6 +3167,8 @@ var StreamReducer = class {
         return;
       case "data-conversation-rebind":
         return;
+      case "data-suggestions":
+        return;
       default: {
         const _exhaustive = chunk;
         void _exhaustive;
@@ -6797,6 +6799,22 @@ function ConversationList({
 // src/ui/suggestions.tsx
 import { jsx as jsx22 } from "preact/jsx-runtime";
 var p19 = BRAND.cssPrefix;
+function parseSuggestions(data) {
+  const raw = data?.suggestions;
+  if (!Array.isArray(raw)) return [];
+  const out = [];
+  for (const item of raw) {
+    if (!item || typeof item !== "object") continue;
+    const { id, label, text } = item;
+    if (typeof label !== "string" || !label) continue;
+    out.push({
+      id: typeof id === "string" && id ? id : `s${out.length}`,
+      label,
+      text: typeof text === "string" && text ? text : label
+    });
+  }
+  return out;
+}
 function Suggestions({ suggestions, onPick }) {
   if (suggestions.length === 0) return null;
   return /* @__PURE__ */ jsx22("div", { class: `${p19}-suggestions`, role: "group", "aria-label": "Suggested replies", children: suggestions.map((s, i) => /* @__PURE__ */ jsx22(
@@ -8366,6 +8384,18 @@ function App({ options, hostElement, bus }) {
   useEffect16(() => {
     if (effectiveLocale !== activeLocale) setActiveLocale(effectiveLocale);
   }, [effectiveLocale, activeLocale]);
+  const pendingSuggestionsRef = useRef9(null);
+  const captureSuggestions = useCallback6((chunk) => {
+    if (chunk.type !== "data-suggestions") return false;
+    pendingSuggestionsRef.current = parseSuggestions(chunk.data);
+    return true;
+  }, []);
+  const flushSuggestions = useCallback6(() => {
+    if (pendingSuggestionsRef.current) {
+      setSuggestions(pendingSuggestionsRef.current);
+      pendingSuggestionsRef.current = null;
+    }
+  }, []);
   const adoptConversationRebind = useCallback6(
     (chunk) => {
       if (chunk.type !== "data-conversation-rebind") return false;
@@ -8385,9 +8415,10 @@ function App({ options, hostElement, bus }) {
   const runResume = useCallback6(
     async (handle) => {
       let bubble = null;
+      pendingSuggestionsRef.current = null;
       try {
         for await (const evt of handle.iter) {
-          if (adoptConversationRebind(evt.chunk)) continue;
+          if (adoptConversationRebind(evt.chunk) || captureSuggestions(evt.chunk)) continue;
           if (!bubble) {
             bubble = makeAssistantMessage();
             resumeBubbleRef.current = bubble;
@@ -8413,6 +8444,7 @@ function App({ options, hostElement, bus }) {
             bubble.status = "complete";
             feedback.play("messageReceived");
             emitMessage(bus, options, "assistant", assistantText(bubble));
+            flushSuggestions();
           }
         }
       } catch (err) {
@@ -8551,12 +8583,13 @@ function App({ options, hostElement, bus }) {
         userPrefs: persistence.loadUserPrefs()
       });
       setStreaming(true);
+      pendingSuggestionsRef.current = null;
       const handle = transport.sendMessage(body);
       setActiveCancel(() => handle.cancel);
       setActiveDetach(() => handle.detach);
       try {
         for await (const evt of handle.iter) {
-          if (adoptConversationRebind(evt.chunk)) continue;
+          if (adoptConversationRebind(evt.chunk) || captureSuggestions(evt.chunk)) continue;
           reducer.apply(evt.chunk);
           if (evt.chunk.type === "finish" && evt.chunk.canContinue === false) {
             setCanSend(false);
@@ -8575,6 +8608,7 @@ function App({ options, hostElement, bus }) {
           assistantMsg.status = "complete";
           feedback.play("messageReceived");
           emitMessage(bus, options, "assistant", assistantText(assistantMsg));
+          flushSuggestions();
         }
       } catch (error) {
         if (isAbortError(error)) {