@helpai/elements 0.8.0 → 0.9.0

package/index.d.ts

@@ -1,4 +1,4 @@
-export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, L as Link, S as ServerConfig, b as SiteConfig, c as StartSessionResponse, W as WidgetConfig, d as WidgetConfigPartial, e as WidgetSettings, f as WidgetSettingsPartial } from './deployment-Clv1qhOa.js';
+export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, L as Link, S as ServerConfig, b as SiteConfig, c as StartSessionResponse, W as WidgetConfig, d as WidgetConfigPartial, e as WidgetSettings, f as WidgetSettingsPartial } from './deployment-B4_b3Sjy.js';
 import 'zod';
 
 /**

package/index.mjs

@@ -1390,10 +1390,19 @@ var AgentTransport = class {
    *     parallel with start-session, so a reply that was streaming when the
    *     user reloaded keeps flowing).
    *
-   * Returns (no throw) on 204 / non-OK — nothing in flight (or a backend
-   * without the endpoint → graceful no-op) — or once a terminal chunk is
-   * drained. Throws only when every attempt produced a 200 that dropped before
-   * finishing: a genuinely incomplete reply the UI should flag with a retry.
+   * The endpoint ALWAYS opens a 200 SSE stream (mirrors the AI SDK
+   * resumable-stream lib): it replays the in-flight reply from the buffer, or —
+   * when nothing is in flight (reply finished + the buffer was flushed, or
+   * nothing ever started) — closes an EMPTY stream. So "nothing to resume" is
+   * signalled by a segment that ends without a terminal chunk AND surfaced no
+   * NEW events — not by a status code. We stop gracefully there; the completed
+   * turn comes from the DB via start-session / list-messages.
+   *
+   * Returns (no throw) on a terminal chunk, an empty/no-new-events segment, or
+   * a 204 / non-OK (a backend that signals "nothing" by status, or lacks the
+   * endpoint). Retries only a segment that yielded new events but no finish — a
+   * real mid-reply drop. Throws only if every attempt kept yielding new events
+   * yet never finished: a genuinely stuck, incomplete reply.
    */
   async *resumeStreamGen(ctrl, seenIds, immediate) {
     for (let attempt = 1; attempt <= MAX_RESUME_ATTEMPTS && !ctrl.signal.aborted; attempt++) {
@@ -1418,7 +1427,12 @@ var AgentTransport = class {
         log4.debug("resume \u2192 no in-flight stream", { status: res.status });
         return;
       }
+      const before = seenIds.size;
       if (yield* this.drain(parseChatStream(res, ctrl.signal), seenIds, ctrl)) return;
+      if (seenIds.size === before) {
+        log4.debug("resume \u2192 stream closed with no new events; nothing to resume");
+        return;
+      }
     }
     if (ctrl.signal.aborted) return;
     throw new StreamError("stream incomplete after resume attempts", "server");
@@ -5494,6 +5508,8 @@ function App({ options, hostElement, bus }) {
             messagesSig.value = [...messagesSig.value, bubble];
             setStreaming(true);
             setActiveCancel(() => handle.cancel);
+            const chatTab = chatTabId();
+            if (chatTab) homeNav.switchTab(chatTab);
             log16.info("resumed in-flight reply on mount");
           }
           reducer.apply(evt.chunk);
@@ -5520,7 +5536,7 @@ function App({ options, hostElement, bus }) {
         }
       }
     },
-    [reducer, messagesSig, feedback, bus, options]
+    [reducer, messagesSig, feedback, bus, options, homeNav]
   );
   useEffect17(() => {
     void runStartSession({ newConversation: false });

package/package.json

@@ -80,5 +80,5 @@
   ],
   "type": "module",
   "types": "./index.d.ts",
-  "version": "0.8.0"
+  "version": "0.9.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, L as Link, P as PAGE_AREA_SUGGESTIONS, g as PageContext, S as ServerConfig, b as SiteConfig, c as StartSessionResponse, U as UserContext, W as WidgetConfig, d as WidgetConfigPartial, e as WidgetSettings, f as WidgetSettingsPartial, h as assetSchema, i as blocksConfigSchema, j as connectionConfigPartialSchema, k as connectionConfigSchema, l as cssColorSchema, m as cssLengthSchema, n as endpointsSchema, o as linkSchema, p as localeSchema, q as pageContextSchema, s as serverConfigSchema, r as siteConfigSchema, t as startSessionResponseSchema, u as userContextSchema, v as uuid7Schema, w as widgetConfigPartialSchema, x as widgetConfigSchema, y as widgetSettingsPartialSchema, z as widgetSettingsSchema } from './deployment-Clv1qhOa.js';
+export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, E as Endpoints, L as Link, P as PAGE_AREA_SUGGESTIONS, g as PageContext, S as ServerConfig, b as SiteConfig, c as StartSessionResponse, U as UserContext, W as WidgetConfig, d as WidgetConfigPartial, e as WidgetSettings, f as WidgetSettingsPartial, h as assetSchema, i as blocksConfigSchema, j as connectionConfigPartialSchema, k as connectionConfigSchema, l as cssColorSchema, m as cssLengthSchema, n as endpointsSchema, o as linkSchema, p as localeSchema, q as pageContextSchema, s as serverConfigSchema, r as siteConfigSchema, t as startSessionResponseSchema, u as userContextSchema, v as uuid7Schema, w as widgetConfigPartialSchema, x as widgetConfigSchema, y as widgetSettingsPartialSchema, z as widgetSettingsSchema } from './deployment-B4_b3Sjy.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>>;
@@ -148,9 +148,9 @@ declare const launcherSizeSchema: z.ZodEnum<{
 }>;
 type LauncherSize = z.infer<typeof launcherSizeSchema>;
 declare const calloutShapeSchema: z.ZodEnum<{
+    callout: "callout";
     pill: "pill";
     bubble: "bubble";
-    callout: "callout";
 }>;
 type CalloutShape = z.infer<typeof calloutShapeSchema>;
 declare const calloutPositionSchema: z.ZodEnum<{
@@ -162,9 +162,9 @@ type CalloutPosition = z.infer<typeof calloutPositionSchema>;
 declare const launcherCalloutSchema: z.ZodObject<{
     text: z.ZodDefault<z.ZodString>;
     shape: z.ZodDefault<z.ZodEnum<{
+        callout: "callout";
         pill: "pill";
         bubble: "bubble";
-        callout: "callout";
     }>>;
     position: z.ZodDefault<z.ZodEnum<{
         auto: "auto";
@@ -195,9 +195,9 @@ declare const launcherOptionsSchema: z.ZodObject<{
     callout: z.ZodOptional<z.ZodObject<{
         text: z.ZodDefault<z.ZodString>;
         shape: z.ZodDefault<z.ZodEnum<{
+            callout: "callout";
             pill: "pill";
             bubble: "bubble";
-            callout: "callout";
         }>>;
         position: z.ZodDefault<z.ZodEnum<{
             auto: "auto";
@@ -240,9 +240,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>;
@@ -269,9 +269,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>;
@@ -321,38 +321,38 @@ type FeatureFlags = z.infer<typeof featureFlagsSchema>;
  */
 
 declare const actionNameSchema: z.ZodEnum<{
+    close: "close";
     expand: "expand";
     fullscreen: "fullscreen";
     popOut: "popOut";
-    close: "close";
-    language: "language";
+    clear: "clear";
     theme: "theme";
+    language: "language";
     history: "history";
-    clear: "clear";
     sound: "sound";
 }>;
 type ActionName = z.infer<typeof actionNameSchema>;
 declare const headerActionsSchema: z.ZodObject<{
     main: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        close: "close";
         expand: "expand";
         fullscreen: "fullscreen";
         popOut: "popOut";
-        close: "close";
-        language: "language";
+        clear: "clear";
         theme: "theme";
+        language: "language";
         history: "history";
-        clear: "clear";
         sound: "sound";
     }>>>;
     overflow: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        close: "close";
         expand: "expand";
         fullscreen: "fullscreen";
         popOut: "popOut";
-        close: "close";
-        language: "language";
+        clear: "clear";
         theme: "theme";
+        language: "language";
         history: "history";
-        clear: "clear";
         sound: "sound";
     }>>>;
 }, z.core.$loose>;
@@ -361,25 +361,25 @@ type HeaderActions = z.infer<typeof headerActionsSchema>;
 declare const headerSchema: z.ZodObject<{
     actions: z.ZodOptional<z.ZodObject<{
         main: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            close: "close";
             expand: "expand";
             fullscreen: "fullscreen";
             popOut: "popOut";
-            close: "close";
-            language: "language";
+            clear: "clear";
             theme: "theme";
+            language: "language";
             history: "history";
-            clear: "clear";
             sound: "sound";
         }>>>;
         overflow: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            close: "close";
             expand: "expand";
             fullscreen: "fullscreen";
             popOut: "popOut";
-            close: "close";
-            language: "language";
+            clear: "clear";
             theme: "theme";
+            language: "language";
             history: "history";
-            clear: "clear";
             sound: "sound";
         }>>>;
     }, z.core.$loose>>;
@@ -396,33 +396,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>;
@@ -431,21 +431,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>;
@@ -607,18 +607,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>>;
@@ -644,9 +644,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

@@ -1454,10 +1454,19 @@ var AgentTransport = class {
    *     parallel with start-session, so a reply that was streaming when the
    *     user reloaded keeps flowing).
    *
-   * Returns (no throw) on 204 / non-OK — nothing in flight (or a backend
-   * without the endpoint → graceful no-op) — or once a terminal chunk is
-   * drained. Throws only when every attempt produced a 200 that dropped before
-   * finishing: a genuinely incomplete reply the UI should flag with a retry.
+   * The endpoint ALWAYS opens a 200 SSE stream (mirrors the AI SDK
+   * resumable-stream lib): it replays the in-flight reply from the buffer, or —
+   * when nothing is in flight (reply finished + the buffer was flushed, or
+   * nothing ever started) — closes an EMPTY stream. So "nothing to resume" is
+   * signalled by a segment that ends without a terminal chunk AND surfaced no
+   * NEW events — not by a status code. We stop gracefully there; the completed
+   * turn comes from the DB via start-session / list-messages.
+   *
+   * Returns (no throw) on a terminal chunk, an empty/no-new-events segment, or
+   * a 204 / non-OK (a backend that signals "nothing" by status, or lacks the
+   * endpoint). Retries only a segment that yielded new events but no finish — a
+   * real mid-reply drop. Throws only if every attempt kept yielding new events
+   * yet never finished: a genuinely stuck, incomplete reply.
    */
   async *resumeStreamGen(ctrl, seenIds, immediate) {
     for (let attempt = 1; attempt <= MAX_RESUME_ATTEMPTS && !ctrl.signal.aborted; attempt++) {
@@ -1482,7 +1491,12 @@ var AgentTransport = class {
         log4.debug("resume \u2192 no in-flight stream", { status: res.status });
         return;
       }
+      const before = seenIds.size;
       if (yield* this.drain(parseChatStream(res, ctrl.signal), seenIds, ctrl)) return;
+      if (seenIds.size === before) {
+        log4.debug("resume \u2192 stream closed with no new events; nothing to resume");
+        return;
+      }
     }
     if (ctrl.signal.aborted) return;
     throw new StreamError("stream incomplete after resume attempts", "server");
@@ -5558,6 +5572,8 @@ function App({ options, hostElement, bus }) {
             messagesSig.value = [...messagesSig.value, bubble];
             setStreaming(true);
             setActiveCancel(() => handle.cancel);
+            const chatTab = chatTabId();
+            if (chatTab) homeNav.switchTab(chatTab);
             log16.info("resumed in-flight reply on mount");
           }
           reducer.apply(evt.chunk);
@@ -5584,7 +5600,7 @@ function App({ options, hostElement, bus }) {
         }
       }
     },
-    [reducer, messagesSig, feedback, bus, options]
+    [reducer, messagesSig, feedback, bus, options, homeNav]
   );
   useEffect17(() => {
     void runStartSession({ newConversation: false });