@helpai/elements 0.50.8 → 0.51.1

package/index.mjs

@@ -29,7 +29,7 @@ var BRAND = {
 };
 
 // src/core/version.ts
-var ELEMENTS_VERSION = true ? "0.50.8" : "0.0.0-dev";
+var ELEMENTS_VERSION = true ? "0.51.1" : "0.0.0-dev";
 var ELEMENTS_VERSION_PARAM = "_ev";
 
 // src/i18n/strings.ts
@@ -2112,6 +2112,13 @@ var AgentTransport = class {
     // (visitor, conversation) pair.
     __publicField(this, "visitorId");
     __publicField(this, "conversationId");
+    /**
+     * Outcome of the most recent `resumeStream()` once it found NO replayable SSE — drives the App's
+     * dangling-turn recovery. `live` = a stream was replayed; otherwise the server's JSON recovery status.
+     * `needs-generation` means a durable user turn has no reply (e.g. a fast send→refresh aborted the
+     * deferred LLM run) → the App re-sends to generate it. Reset at the start of each `resumeStream()`.
+     */
+    __publicField(this, "resumeStatus");
     // Host-asserted context (sanitised `userContext` / `pageContext`), refreshed via
     // `setContext` and carried as the envelope's optional `context` so the backend
     // always sees the visitor's latest context as they navigate.
@@ -2447,7 +2454,7 @@ var AgentTransport = class {
     const seenIds = /* @__PURE__ */ new Set();
     const iter = this.runStream(body, ctrl, seenIds);
     const cancel = () => this.cancelStream(ctrl, body.conversationId);
-    return { iter, cancel };
+    return { iter, cancel, detach: () => ctrl.abort() };
   }
   /**
    * Re-attach to an in-flight reply on a cold page load / refresh.
@@ -2468,8 +2475,10 @@ var AgentTransport = class {
   resumeStream() {
     const ctrl = new AbortController();
     const seenIds = /* @__PURE__ */ new Set();
+    this.resumeStatus = void 0;
     const iter = this.resumeStreamGen(ctrl, seenIds, true);
-    return { iter, cancel: () => ctrl.abort() };
+    const stop = () => ctrl.abort();
+    return { iter, cancel: stop, detach: stop };
   }
   // ---- Stream orchestration ---------------------------------------------
   async *runStream(body, ctrl, seenIds) {
@@ -2522,6 +2531,15 @@ var AgentTransport = class {
         log6.debug("resume \u2192 no in-flight stream", { status: res.status });
         return;
       }
+      const contentType = res.headers.get("content-type") ?? "";
+      if (!contentType.includes("text/event-stream")) {
+        const status = await res.json().then((body) => body.status).catch(() => void 0);
+        log6.debug("resume \u2192 no live stream (status response)", { status, attempt });
+        if (status === "pending" && attempt < MAX_RESUME_ATTEMPTS) continue;
+        this.resumeStatus = status === "needs-generation" ? "needs-generation" : "completed";
+        return;
+      }
+      this.resumeStatus = "live";
       const before = seenIds.size;
       if (yield* this.drain(parseChatStream(res, ctrl.signal), seenIds, ctrl)) return;
       if (seenIds.size === before) {
@@ -2741,6 +2759,7 @@ function toReactive(m) {
     role: m.role,
     createdAt: m.createdAt,
     status: m.status,
+    canceled: m.canceled,
     errorText: m.errorText,
     finishReason: m.finishReason,
     serverMessageId: m.serverMessageId,
@@ -2804,7 +2823,11 @@ function fromWireMessage(w) {
     // Real send time when the backend provides it; otherwise fall back to now
     // (older backends) so the timestamp + day divider still render.
     createdAt: parseWireDate(w.createdAt) ?? Date.now(),
-    status: "complete",
+    // Map the persisted terminal status onto the bubble's render state: `failed` → an error bubble;
+    // `canceled` → `complete` + the `canceled` flag (an empty canceled turn is hidden on render — see
+    // `message-bubble`); everything else is a normal completed turn.
+    status: w.status === "failed" ? "error" : "complete",
+    canceled: w.status === "canceled",
     partsSig: signal(parts)
   };
 }
@@ -2814,6 +2837,7 @@ function fromReactive(m) {
     role: m.role,
     createdAt: m.createdAt,
     status: m.status,
+    canceled: m.canceled,
     errorText: m.errorText,
     finishReason: m.finishReason,
     serverMessageId: m.serverMessageId,
@@ -2836,6 +2860,9 @@ function hasNoVisibleAnswer(m) {
 function isEmptyAssistantReply(m) {
   return m.role === "assistant" && m.status !== "streaming" && hasNoVisibleAnswer(m);
 }
+function isHiddenCanceledTurn(m) {
+  return m.canceled === true && isEmptyAssistantReply(m);
+}
 function partToReactive(p36) {
   if (p36.kind === "text" || p36.kind === "reasoning") {
     return { kind: p36.kind, id: p36.id, textSig: signal(p36.text), doneSig: signal(p36.done) };
@@ -2995,6 +3022,8 @@ var StreamReducer = class {
         return;
       case "data-notification":
         return;
+      case "data-conversation-rebind":
+        return;
       default: {
         const _exhaustive = chunk;
         void _exhaustive;
@@ -5707,6 +5736,7 @@ function MessageBubble({
   const parts = useComputed5(() => message.partsSig.value);
   const partList = parts.value;
   const emptyReply = useComputed5(() => isEmptyAssistantReply(message));
+  const hideCanceledHusk = useComputed5(() => isHiddenCanceledTurn(message));
   const hasAnswerText = useComputed5(
     () => message.partsSig.value.some((part) => part.kind === "text" && part.textSig.value.length > 0)
   );
@@ -5717,6 +5747,7 @@ function MessageBubble({
   const bufferedHold = responseMode === "buffered" && streaming;
   const working = streaming && !hasAnswerText.value;
   const showStreamDots = streaming && !bufferedHold && !(reasoningVisible.value && working);
+  if (hideCanceledHusk.value) return null;
   const stamp = formatStamp(message.createdAt);
   return /* @__PURE__ */ jsx18("div", { class: `${p17}-bubble-row`, "data-role": message.role, "data-testid": tid(TID.messageBubble, message.id), children: /* @__PURE__ */ jsxs15("div", { class: `${p17}-bubble-col`, children: [
     /* @__PURE__ */ jsxs15("div", { class: `${p17}-bubble`, children: [
@@ -7590,6 +7621,7 @@ function App({ options, hostElement, bus }) {
   const [agent, setAgent] = useState14(null);
   const [suggestions, setSuggestions] = useState14([]);
   const [activeCancel, setActiveCancel] = useState14(null);
+  const [activeDetach, setActiveDetach] = useState14(null);
   const stringsRef = useRef9(options.strings);
   const [parsedSite, setParsedSite] = useState14(void 0);
   const [parsedBlocks, setParsedBlocks] = useState14(void 0);
@@ -7662,6 +7694,8 @@ function App({ options, hostElement, bus }) {
   const homeNavSeeded = useRef9(false);
   const resumeActiveRef = useRef9(false);
   const resumeBubbleRef = useRef9(null);
+  const regenerateDanglingRef = useRef9(null);
+  const regenInFlightRef = useRef9(false);
   useEffect16(() => {
     if (!conversationReady || homeNavSeeded.current) return;
     homeNavSeeded.current = true;
@@ -7731,6 +7765,7 @@ function App({ options, hostElement, bus }) {
         } else {
           messagesSig.value = withWelcomeRows([], markers);
         }
+        if (transport.resumeStatus === "needs-generation") regenerateDanglingRef.current?.();
       } catch (err) {
         if (isStale()) return;
         log17.warn("loadThread failed; resetting conversationId", { err, conversationId });
@@ -7860,11 +7895,28 @@ function App({ options, hostElement, bus }) {
   useEffect16(() => {
     if (effectiveLocale !== activeLocale) setActiveLocale(effectiveLocale);
   }, [effectiveLocale, activeLocale]);
+  const adoptConversationRebind = useCallback6(
+    (chunk) => {
+      if (chunk.type !== "data-conversation-rebind") return false;
+      const next = chunk.data?.conversationId;
+      if (next && next !== conversationIdSig.value) {
+        const previous = conversationIdSig.value;
+        conversationIdSig.value = next;
+        persistence.saveConversationId(next);
+        transport.primeIdentity(void 0, next);
+        log17.info("conversation rebound (in-stream)", { previous, current: next });
+        if (previous) bus.emit("conversationRebound", { previous, current: next, reason: next });
+      }
+      return true;
+    },
+    [conversationIdSig, persistence, transport, bus]
+  );
   const runResume = useCallback6(
     async (handle) => {
       let bubble = null;
       try {
         for await (const evt of handle.iter) {
+          if (adoptConversationRebind(evt.chunk)) continue;
           if (!bubble) {
             bubble = makeAssistantMessage();
             resumeBubbleRef.current = bubble;
@@ -7872,6 +7924,7 @@ function App({ options, hostElement, bus }) {
             messagesSig.value = [...messagesSig.value, bubble];
             setStreaming(true);
             setActiveCancel(() => handle.cancel);
+            setActiveDetach(() => handle.detach);
             resumeActiveRef.current = true;
             const chatTab = chatTabIdRef.current;
             if (chatTab) homeNav.switchTab(chatTab);
@@ -7893,24 +7946,39 @@ function App({ options, hostElement, bus }) {
         }
       } catch (err) {
         if (bubble) {
-          bubble.status = "error";
-          bubble.errorText = errorMessageFor(err, options.strings);
-          feedback.play("error");
+          if (isAbortError(err)) {
+            if (hasNoVisibleAnswer(bubble)) {
+              messagesSig.value = messagesSig.value.filter((m) => m !== bubble);
+            } else {
+              bubble.status = "complete";
+            }
+          } else {
+            bubble.status = "error";
+            bubble.errorText = errorMessageFor(err, options.strings);
+            feedback.play("error");
+          }
         }
-        log17.debug("mount resume ended without completing", { err });
+        log17.debug("resume ended without completing", { err });
       } finally {
         resumeBubbleRef.current = null;
         if (bubble) {
           reducer.detach();
           setStreaming(false);
           setActiveCancel(null);
+          setActiveDetach(null);
           messagesSig.value = [...messagesSig.value];
         }
       }
     },
-    [reducer, messagesSig, feedback, bus, options, homeNav]
+    [reducer, messagesSig, feedback, bus, options, homeNav, adoptConversationRebind]
   );
   const resumeHandleRef = useRef9(null);
+  const resumeInFlight = useCallback6(async () => {
+    const handle = transport.resumeStream();
+    resumeHandleRef.current = handle;
+    await runResume(handle);
+    if (transport.resumeStatus === "needs-generation") regenerateDanglingRef.current?.();
+  }, [transport, runResume]);
   useEffect16(() => {
     const persistedConversation = conversationIdSig.value;
     if (persistedConversation) transport.primeIdentity(visitorId, persistedConversation);
@@ -7933,16 +8001,17 @@ function App({ options, hostElement, bus }) {
         setFormsReady(true);
       }
     })();
-    if (pendingThreadRef.current) {
-      pendingThreadRef.current = false;
-      const persisted = conversationIdSig.value;
-      if (persisted) void loadThread(persisted);
-    }
-    if (conversationIdSig.value) {
-      const handle = transport.resumeStream();
-      resumeHandleRef.current = handle;
-      void runResume(handle);
-    }
+    void (async () => {
+      const tasks = [];
+      if (pendingThreadRef.current) {
+        pendingThreadRef.current = false;
+        const persisted = conversationIdSig.value;
+        if (persisted) tasks.push(loadThread(persisted));
+      }
+      if (conversationIdSig.value) tasks.push(resumeInFlight());
+      if (tasks.length === 0) return;
+      await Promise.allSettled(tasks);
+    })();
   }, [activated]);
   const formsLocaleRef = useRef9(null);
   useEffect16(() => {
@@ -8013,8 +8082,10 @@ function App({ options, hostElement, bus }) {
       setStreaming(true);
       const handle = transport.sendMessage(body);
       setActiveCancel(() => handle.cancel);
+      setActiveDetach(() => handle.detach);
       try {
         for await (const evt of handle.iter) {
+          if (adoptConversationRebind(evt.chunk)) continue;
           reducer.apply(evt.chunk);
           if (evt.chunk.type === "finish" && evt.chunk.canContinue === false) {
             setCanSend(false);
@@ -8052,11 +8123,39 @@ function App({ options, hostElement, bus }) {
         reducer.detach();
         setStreaming(false);
         setActiveCancel(null);
+        setActiveDetach(null);
         messagesSig.value = [...messagesSig.value];
       }
     },
-    [transport, reducer, messagesSig, conversationIdSig, options, bus, feedback, persistence, visitorId]
+    [
+      transport,
+      reducer,
+      messagesSig,
+      conversationIdSig,
+      options,
+      bus,
+      feedback,
+      persistence,
+      visitorId,
+      adoptConversationRebind
+    ]
   );
+  const regenerateDanglingTurn = useCallback6(() => {
+    if (streaming || regenInFlightRef.current || resumeBubbleRef.current) return;
+    const last = messagesSig.value.filter((m) => !m.ephemeral).at(-1);
+    if (last?.role !== "user") return;
+    regenInFlightRef.current = true;
+    log17.info("regenerating dangling user turn (needs-generation)");
+    const assistantMsg = makeAssistantMessage();
+    messagesSig.value = [...messagesSig.value, assistantMsg];
+    reducer.attach(assistantMsg);
+    void streamAssistant(assistantMsg, { continueExisting: false }).finally(() => {
+      regenInFlightRef.current = false;
+    });
+  }, [streaming, messagesSig, reducer, streamAssistant]);
+  useEffect16(() => {
+    regenerateDanglingRef.current = regenerateDanglingTurn;
+  }, [regenerateDanglingTurn]);
   const decideTool = useCallback6(
     (toolCallId, mutate) => {
       if (streaming) return;
@@ -8272,7 +8371,7 @@ function App({ options, hostElement, bus }) {
     }
     log17.info("clear \u2192 new conversation", { wasStreaming: streaming });
     bus.emit("clear", void 0);
-    if (streaming) activeCancel?.();
+    if (streaming) activeDetach?.();
     batch(() => {
       messagesSig.value = [];
       conversationIdSig.value = void 0;
@@ -8281,7 +8380,7 @@ function App({ options, hostElement, bus }) {
     setCanSend(true);
     setFormMarkers([]);
     void runHandshake({ newConversation: true });
-  }, [streaming, activeCancel, messagesSig, conversationIdSig, persistence, runHandshake, bus, canSend, playWelcome]);
+  }, [streaming, activeDetach, messagesSig, conversationIdSig, persistence, runHandshake, bus, canSend, playWelcome]);
   const handleNewChat = useCallback6(() => {
     handleClear();
     setView("chat");
@@ -8358,8 +8457,9 @@ function App({ options, hostElement, bus }) {
   );
   const handleSelectHistoryConversation = useCallback6(
     async (targetConversationId) => {
-      log17.info("selectConversation", { conversationId: targetConversationId });
+      log17.info("selectConversation", { conversationId: targetConversationId, wasStreaming: streaming });
       bus.emit("selectConversation", { conversationId: targetConversationId });
+      if (streaming) activeDetach?.();
       try {
         const [res, markers] = await Promise.all([
           transport.loadConversation(targetConversationId),
@@ -8372,10 +8472,12 @@ function App({ options, hostElement, bus }) {
         });
         setFormMarkers(markers);
         persistence.saveConversationId(res.conversationId);
+        transport.primeIdentity(visitorId, res.conversationId);
         if (res.agent) setAgent(res.agent);
         setCanSend(res.canContinue);
         setSuggestions(res.suggestions ?? []);
         setView("chat");
+        void resumeInFlight();
         await transport.markRead(targetConversationId);
         refreshUnread();
       } catch (err) {
@@ -8392,7 +8494,11 @@ function App({ options, hostElement, bus }) {
       persistence,
       refreshUnread,
       fetchFormMarkers,
-      withWelcomeRows
+      withWelcomeRows,
+      streaming,
+      activeDetach,
+      visitorId,
+      resumeInFlight
     ]
   );
   const pendingOpenFormRef = useRef9(null);

package/package.json

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