@haikit/client 0.20.4 → 0.21.0

package/README.md

@@ -126,8 +126,8 @@ mountChat({
 If something on the network holds the stream back, as HTTPS-inspecting
 corporate proxies (Netskope, Zscaler) do, the chat polls instead. The server
 greets every stream with a comment the moment it opens. A stream that brings
-no bytes at all within `eventsFallbackMs` (default 8 s, a `createChat`
-option) is dropped for short polls, whose responses end and so get through.
+no bytes at all within `eventsFallbackMs` (default 8 s, an option of
+`createChat` and `mountChat`) is dropped for short polls, whose responses end and so get through.
 Notices, signals and wake turns all arrive by polling, a little later than
 they would stream. Each poll asks the server to hold for `pollHoldMs`
 (default 15 s, the server's maximum) when nothing is new; set it lower

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haikit/client",
-  "version": "0.20.4",
+  "version": "0.21.0",
   "description": "The haikit browser runtime: streams tool payloads into interactive UI surfaces. Plain ESM, no build step, no dependencies.",
   "keywords": [
     "haikit",

package/src/app.d.ts

@@ -7,7 +7,7 @@ export interface MountChatOptions {
   notices?: NoticeRegistry;
   /** Handlers for the signals the server sends, by signal name. */
   signals?: SignalRegistry;
-  /** Base path the server's two routes are mounted at. Default `/hai`. */
+  /** Where the server's routes are: `nodeHandler`'s base path. Default `/hai`. */
   endpoint?: string;
   title?: string;
   subtitle?: string;
@@ -27,6 +27,10 @@ export interface MountChatOptions {
    * dark setting, or a `data-hai-theme` already in the page's markup.
    */
   theme?: "light" | "dark";
+  /** Passed to `createChat`: how long the events stream may be silent before the chat polls. Default 8000 ms. */
+  eventsFallbackMs?: number;
+  /** Passed to `createChat`: how long each poll asks the server to hold. Default 15000 ms. */
+  pollHoldMs?: number;
 }
 
 /**

package/src/app.js

@@ -95,6 +95,8 @@ function dropFavicon() {
  *   placeholder?: string,
  *   emptyText?: string,
  *   theme?: "light" | "dark",
+ *   eventsFallbackMs?: number,
+ *   pollHoldMs?: number,
  * }} options
  */
 export function mountChat({
@@ -110,8 +112,11 @@ export function mountChat({
   placeholder = "message…",
   emptyText = "",
   theme,
+  eventsFallbackMs,
+  pollHoldMs,
 }) {
-  const chat = createChat({ endpoint, registry, notices, signals });
+  // undefined leaves createChat's defaults
+  const chat = createChat({ endpoint, registry, notices, signals, eventsFallbackMs, pollHoldMs });
   const id = `hai-${++shells}`;
 
   // Unset, the page follows the system. A pin goes on the root, where hai.css
@@ -250,6 +255,10 @@ export function mountChat({
   shell.append(top, main);
   root.replaceChildren(shell);
 
+  // A start that fails, such as the network being down, is reported, not
+  // left unhandled: the first message starts the conversation anyway.
+  const start = () => chat.start().catch((err) => console.error("[haikit] the conversation couldn't start:", err));
+
   // ── composer ───────────────────────────────────────────────────────
   // The input grows with what is typed, up to the height hai.css allows.
   const fit = () => {
@@ -270,12 +279,21 @@ export function mountChat({
     // A message queued behind a long turn can still be turned away later, if
     // the conversation goes out of date before its turn comes. Give the text
     // back then, unless something new has been typed since.
-    sending.then((sent) => {
-      if (!sent && !input.value) {
+    const giveBack = () => {
+      if (!input.value) {
         input.value = text;
         fit();
       }
-    });
+    };
+    sending.then(
+      (sent) => sent || giveBack(),
+      // the request itself failed, such as the network being down: the text
+      // goes back, and the error is reported rather than left unhandled
+      (err) => {
+        console.error("[haikit] the message wasn't sent:", err);
+        giveBack();
+      },
+    );
   };
 
   // ── empty state ────────────────────────────────────────────────────
@@ -342,7 +360,7 @@ export function mountChat({
 
     // A new conversation starts at once, so the server's init tool — if it
     // has one — runs before anything is typed.
-    if (event.type === "reset") chat.start();
+    if (event.type === "reset") start();
 
     render();
 
@@ -378,7 +396,7 @@ export function mountChat({
   render();
   // a server without an init tool sends nothing until the first message
   if (inspectorBody) renderInspector(inspectorBody, chat.state.context);
-  chat.start();
+  start();
   return chat;
 }