@helpai/elements 0.59.0 → 0.59.2

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-Daefe1g1.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-BAOjO2dQ.js';
 import 'zod';
 
 /**

package/index.mjs

@@ -29,7 +29,7 @@ var BRAND = {
 };
 
 // src/core/version.ts
-var ELEMENTS_VERSION = true ? "0.59.0" : "0.0.0-dev";
+var ELEMENTS_VERSION = true ? "0.59.2" : "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)
@@ -2226,6 +2242,7 @@ function messageToWireParts(m) {
 var log6 = logger.scope("transport");
 var MAX_RESUME_ATTEMPTS = 3;
 var RESUME_BACKOFF_MS = 400;
+var POST_FINISH_DRAIN_MS = 5e3;
 var CONTENT_CACHE_TTL_MS = 6e4;
 var CONVERSATIONS_CACHE_TTL_MS = 1e4;
 var MAX_REQUEST_RETRIES = 3;
@@ -2240,6 +2257,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 +2512,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 +2755,8 @@ var AgentTransport = class {
    * (a drop), so the caller can attempt a resume.
    */
   async *drain(source, seenIds, ctrl) {
+    let terminal = false;
+    let watchdog;
     try {
       for await (const evt of source) {
         if (ctrl.signal.aborted) return true;
@@ -2734,14 +2765,19 @@ 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;
+          watchdog ?? (watchdog = setTimeout(() => ctrl.abort(), POST_FINISH_DRAIN_MS));
+        }
       }
     } catch (err) {
       if (ctrl.signal.aborted) return true;
       if (err instanceof StreamError && err.status !== void 0) throw err;
       log6.debug("stream segment dropped", { err });
+    } finally {
+      if (watchdog) clearTimeout(watchdog);
     }
-    return false;
+    return terminal;
   }
   /** Abort + fire-and-forget POST to `/pai/cancel-stream`. Idempotent. */
   cancelStream(ctrl, conversationId) {
@@ -2969,6 +3005,9 @@ function fromWireMessage(w) {
         mediaType: part.mediaType
       };
     }
+    if (part.type === "data-suggestions") {
+      return null;
+    }
     if (part.type.startsWith("tool-")) {
       return {
         kind: "tool",
@@ -6840,22 +6879,6 @@ 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(

package/package.json

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

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-Daefe1g1.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-BAOjO2dQ.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";
-    clear: "clear";
-    theme: "theme";
+    close: "close";
     language: "language";
+    theme: "theme";
     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";
-    clear: "clear";
-    theme: "theme";
+    close: "close";
     language: "language";
+    theme: "theme";
     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";
-        clear: "clear";
-        theme: "theme";
+        close: "close";
         language: "language";
+        theme: "theme";
         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.59.0" : "0.0.0-dev";
+var ELEMENTS_VERSION = true ? "0.59.2" : "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)
@@ -2185,6 +2201,7 @@ function messageToWireParts(m) {
 var log5 = logger.scope("transport");
 var MAX_RESUME_ATTEMPTS = 3;
 var RESUME_BACKOFF_MS = 400;
+var POST_FINISH_DRAIN_MS = 5e3;
 var CONTENT_CACHE_TTL_MS = 6e4;
 var CONVERSATIONS_CACHE_TTL_MS = 1e4;
 var MAX_REQUEST_RETRIES = 3;
@@ -2199,6 +2216,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 +2471,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 +2714,8 @@ var AgentTransport = class {
    * (a drop), so the caller can attempt a resume.
    */
   async *drain(source, seenIds, ctrl) {
+    let terminal = false;
+    let watchdog;
     try {
       for await (const evt of source) {
         if (ctrl.signal.aborted) return true;
@@ -2693,14 +2724,19 @@ 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;
+          watchdog ?? (watchdog = setTimeout(() => ctrl.abort(), POST_FINISH_DRAIN_MS));
+        }
       }
     } catch (err) {
       if (ctrl.signal.aborted) return true;
       if (err instanceof StreamError && err.status !== void 0) throw err;
       log5.debug("stream segment dropped", { err });
+    } finally {
+      if (watchdog) clearTimeout(watchdog);
     }
-    return false;
+    return terminal;
   }
   /** Abort + fire-and-forget POST to `/pai/cancel-stream`. Idempotent. */
   cancelStream(ctrl, conversationId) {
@@ -2928,6 +2964,9 @@ function fromWireMessage(w) {
         mediaType: part.mediaType
       };
     }
+    if (part.type === "data-suggestions") {
+      return null;
+    }
     if (part.type.startsWith("tool-")) {
       return {
         kind: "tool",
@@ -6799,22 +6838,6 @@ 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(