@helpai/elements 0.58.2 → 0.59.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-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.1" : "0.0.0-dev";
 var ELEMENTS_VERSION_PARAM = "_ev";
 
 // src/i18n/strings.ts
@@ -2149,6 +2149,22 @@ var DEFAULT_PATHS = {
   submitForm: "/pai/submit-form"
 };
 var CONTEXT_PARAM = "context";
+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 buildSendMessageRequest(params) {
   const wire = params.messages.map((m) => ({
     // Use the backend's id when known (adopted from the stream's `start` chunk)
@@ -2240,6 +2256,15 @@ 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();
@@ -2486,7 +2511,10 @@ var AgentTransport = class {
       canContinue: res.canContinue ?? true,
       messages,
       agent: res.agent,
-      suggestions: res.suggestions
+      // 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
     };
   }
   /**
@@ -2726,6 +2754,7 @@ var AgentTransport = class {
    * (a drop), so the caller can attempt a resume.
    */
   async *drain(source, seenIds, ctrl) {
+    let terminal = false;
     try {
       for await (const evt of source) {
         if (ctrl.signal.aborted) return true;
@@ -2734,14 +2763,14 @@ var AgentTransport = class {
           seenIds.add(evt.eventId);
         }
         yield evt;
-        if (evt.chunk.type === "finish" || evt.chunk.type === "error") return true;
+        if (evt.chunk.type === "finish" || evt.chunk.type === "error") terminal = true;
       }
     } catch (err) {
       if (ctrl.signal.aborted) return true;
       if (err instanceof StreamError && err.status !== void 0) throw err;
       log6.debug("stream segment dropped", { err });
     }
-    return false;
+    return terminal;
   }
   /** Abort + fire-and-forget POST to `/pai/cancel-stream`. Idempotent. */
   cancelStream(ctrl, conversationId) {
@@ -2969,6 +2998,9 @@ function fromWireMessage(w) {
         mediaType: part.mediaType
       };
     }
+    if (part.type === "data-suggestions") {
+      return null;
+    }
     if (part.type.startsWith("tool-")) {
       return {
         kind: "tool",
@@ -3208,6 +3240,8 @@ var StreamReducer = class {
         return;
       case "data-conversation-rebind":
         return;
+      case "data-suggestions":
+        return;
       default: {
         const _exhaustive = chunk;
         void _exhaustive;
@@ -8407,6 +8441,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 +8472,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 +8501,7 @@ function App({ options, hostElement, bus }) {
             bubble.status = "complete";
             feedback.play("messageReceived");
             emitMessage(bus, options, "assistant", assistantText(bubble));
+            flushSuggestions();
           }
         }
       } catch (err) {
@@ -8592,12 +8640,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 +8665,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.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-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.1" : "0.0.0-dev";
 var ELEMENTS_VERSION_PARAM = "_ev";
 
 // src/stream/types.ts
@@ -2108,6 +2108,22 @@ var DEFAULT_PATHS = {
   submitForm: "/pai/submit-form"
 };
 var CONTEXT_PARAM = "context";
+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 buildSendMessageRequest(params) {
   const wire = params.messages.map((m) => ({
     // Use the backend's id when known (adopted from the stream's `start` chunk)
@@ -2199,6 +2215,15 @@ 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();
@@ -2445,7 +2470,10 @@ var AgentTransport = class {
       canContinue: res.canContinue ?? true,
       messages,
       agent: res.agent,
-      suggestions: res.suggestions
+      // 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
     };
   }
   /**
@@ -2685,6 +2713,7 @@ var AgentTransport = class {
    * (a drop), so the caller can attempt a resume.
    */
   async *drain(source, seenIds, ctrl) {
+    let terminal = false;
     try {
       for await (const evt of source) {
         if (ctrl.signal.aborted) return true;
@@ -2693,14 +2722,14 @@ var AgentTransport = class {
           seenIds.add(evt.eventId);
         }
         yield evt;
-        if (evt.chunk.type === "finish" || evt.chunk.type === "error") return true;
+        if (evt.chunk.type === "finish" || evt.chunk.type === "error") terminal = true;
       }
     } catch (err) {
       if (ctrl.signal.aborted) return true;
       if (err instanceof StreamError && err.status !== void 0) throw err;
       log5.debug("stream segment dropped", { err });
     }
-    return false;
+    return terminal;
   }
   /** Abort + fire-and-forget POST to `/pai/cancel-stream`. Idempotent. */
   cancelStream(ctrl, conversationId) {
@@ -2928,6 +2957,9 @@ function fromWireMessage(w) {
         mediaType: part.mediaType
       };
     }
+    if (part.type === "data-suggestions") {
+      return null;
+    }
     if (part.type.startsWith("tool-")) {
       return {
         kind: "tool",
@@ -3167,6 +3199,8 @@ var StreamReducer = class {
         return;
       case "data-conversation-rebind":
         return;
+      case "data-suggestions":
+        return;
       default: {
         const _exhaustive = chunk;
         void _exhaustive;
@@ -8366,6 +8400,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 +8431,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 +8460,7 @@ function App({ options, hostElement, bus }) {
             bubble.status = "complete";
             feedback.play("messageReceived");
             emitMessage(bus, options, "assistant", assistantText(bubble));
+            flushSuggestions();
           }
         }
       } catch (err) {
@@ -8551,12 +8599,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 +8624,7 @@ function App({ options, hostElement, bus }) {
           assistantMsg.status = "complete";
           feedback.play("messageReceived");
           emitMessage(bus, options, "assistant", assistantText(assistantMsg));
+          flushSuggestions();
         }
       } catch (error) {
         if (isAbortError(error)) {