@helpai/elements 0.29.1 → 0.30.1

package/index.mjs

@@ -3,11 +3,7 @@ var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { en
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
 // src/index.ts
-import { h, render } from "preact";
-
-// src/ui/app.tsx
-import { useCallback as useCallback6, useEffect as useEffect17, useMemo as useMemo3, useRef as useRef9, useState as useState13 } from "preact/hooks";
-import { useComputed as useComputed7, useSignal as useSignal2 } from "@preact/signals";
+import { render } from "preact";
 
 // src/core/brand.ts
 var BRAND = {
@@ -524,8 +520,9 @@ function resolveOptions(rawOpts) {
   const header = opts.header ?? {};
   const { themeMode, themeOverrides } = parseTheme(opts.theme);
   const mode = presentation.mode ?? "floating";
-  const locale = i18n.locale ?? resolveDefaultLocale(i18n.defaultLocale);
-  const availableLocales = i18n.availableLocales ?? [locale];
+  const defaultLocale = resolveDefaultLocale(i18n.defaultLocale);
+  const availableLocales = i18n.availableLocales ?? [i18n.locale ?? defaultLocale];
+  const locale = clampLocale(i18n.locale ?? defaultLocale, availableLocales, defaultLocale);
   const baseUrl = (opts.baseUrl ?? BRAND.defaultBaseUrl).replace(/\/$/, "");
   const agentApiBaseUrl = (opts.agentApiBaseUrl ?? `${baseUrl}/api/agent`).replace(/\/$/, "");
   const dataApiBaseUrl = (opts.dataApiBaseUrl ?? `${baseUrl}/api/data`).replace(/\/$/, "");
@@ -567,6 +564,7 @@ function resolveOptions(rawOpts) {
       maxCount: opts.composer?.attachments?.maxCount ?? DEFAULT_ATTACHMENTS.maxCount
     },
     locale,
+    defaultLocale,
     availableLocales,
     startMinimized: behavior.startMinimized ?? true,
     actions: resolveActions(mode, header.actions),
@@ -597,6 +595,11 @@ function resolveDefaultLocale(input) {
   if (input && input !== "auto") return input;
   return typeof navigator !== "undefined" && navigator.language ? navigator.language : "en";
 }
+function clampLocale(desired, availableLocales, defaultLocale) {
+  if (availableLocales.length <= 1 || availableLocales.includes(desired)) return desired;
+  if (availableLocales.includes(defaultLocale)) return defaultLocale;
+  return availableLocales[0] ?? desired;
+}
 function resolveActions(mode, overrides) {
   return overrides ?? DEFAULT_ACTIONS_BY_MODE[mode];
 }
@@ -745,13 +748,14 @@ function resolveLauncher(overrides) {
 
 // src/core/config/overrides.ts
 function applyOptionOverrides(options, activeLocale, activeThemeMode, activeTextSize) {
-  if (activeLocale === options.locale && activeThemeMode === options.themeMode && activeTextSize === options.textSize) {
+  const locale = clampLocale(activeLocale, options.availableLocales, options.defaultLocale);
+  if (locale === options.locale && activeThemeMode === options.themeMode && activeTextSize === options.textSize) {
     return options;
   }
   const next = { ...options };
-  if (activeLocale !== options.locale) {
-    next.locale = activeLocale;
-    next.strings = resolveStrings(activeLocale, options.stringsOverride);
+  if (locale !== options.locale) {
+    next.locale = locale;
+    next.strings = resolveStrings(locale, options.stringsOverride);
   }
   if (activeThemeMode !== options.themeMode) next.themeMode = activeThemeMode;
   if (activeTextSize !== options.textSize) next.textSize = activeTextSize;
@@ -797,6 +801,8 @@ function mergeServerConfig(user, server) {
       serverI18n ?? {},
       userI18n
     );
+    if (serverI18n?.availableLocales !== void 0) merged.availableLocales = serverI18n.availableLocales;
+    if (serverI18n?.defaultLocale !== void 0) merged.defaultLocale = serverI18n.defaultLocale;
     const userStrings = userI18n?.strings;
     const serverStrings = serverI18n?.strings;
     if (userStrings || serverStrings) {
@@ -925,20 +931,6 @@ var REACTIVE_ATTRS = [
   ...SPECIAL_REACTIVE_ATTRS
 ];
 
-// src/core/handshake-shape.ts
-function isPlainObject(raw) {
-  return !!raw && typeof raw === "object" && !Array.isArray(raw);
-}
-function isSiteConfigShape(raw) {
-  return isPlainObject(raw);
-}
-function isBlocksConfigShape(raw) {
-  if (!isPlainObject(raw)) return false;
-  if (raw.navigation !== void 0 && !Array.isArray(raw.navigation)) return false;
-  if (raw.linkCards !== void 0 && !Array.isArray(raw.linkCards)) return false;
-  return true;
-}
-
 // src/core/host-commands.ts
 function commandEventName(cmd) {
   return `${BRAND.cssPrefix}:${cmd}`;
@@ -959,6 +951,155 @@ function bindHostCommands(host, handlers) {
   };
 }
 
+// src/core/ids.ts
+function uuid7() {
+  const ts = Date.now();
+  const bytes = new Uint8Array(16);
+  bytes[0] = Math.floor(ts / 2 ** 40) & 255;
+  bytes[1] = Math.floor(ts / 2 ** 32) & 255;
+  bytes[2] = ts >>> 24 & 255;
+  bytes[3] = ts >>> 16 & 255;
+  bytes[4] = ts >>> 8 & 255;
+  bytes[5] = ts & 255;
+  fillRandom(bytes.subarray(6));
+  bytes[6] = bytes[6] & 15 | 112;
+  bytes[8] = bytes[8] & 63 | 128;
+  const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+function fillRandom(view) {
+  if (typeof crypto !== "undefined" && typeof crypto.getRandomValues === "function") {
+    crypto.getRandomValues(view);
+    return;
+  }
+  for (let i = 0; i < view.length; i++) view[i] = Math.floor(Math.random() * 256);
+}
+
+// src/core/persistence.ts
+var log2 = logger.scope("persistence");
+function createPersistence(widgetId, storage = defaultStorage) {
+  const prefix = `${BRAND.cssPrefix}.${widgetId}`;
+  const KEY_VISITOR = `${prefix}.visitorId`;
+  const KEY_CONVERSATION = `${prefix}.conversationId`;
+  const KEY_USER_PREFS = `${prefix}.userPrefs`;
+  const KEY_PANEL_OPEN = `${prefix}.panelOpen`;
+  const KEY_PANEL_SIZE = `${prefix}.panelSize`;
+  const KEY_CALLOUT_DISMISSED = `${prefix}.calloutDismissed`;
+  const KEY_SIDEBAR_COLLAPSED = `${prefix}.sidebarCollapsed`;
+  const KEY_ACTIVE_MODULE = `${prefix}.activeModule`;
+  const KEY_FORMS_DONE = `${prefix}.formsDone`;
+  const persistence = {
+    getVisitorId() {
+      const existing = storage.get(KEY_VISITOR);
+      if (existing) return existing;
+      const minted = uuid7();
+      storage.set(KEY_VISITOR, minted);
+      return minted;
+    },
+    setVisitorId(id) {
+      log2.debug("setVisitorId (rebind)", { id, widgetId });
+      storage.set(KEY_VISITOR, id);
+    },
+    loadConversationId() {
+      return storage.get(KEY_CONVERSATION) ?? void 0;
+    },
+    saveConversationId(id) {
+      log2.trace("saveConversationId", { id, widgetId });
+      if (id) storage.set(KEY_CONVERSATION, id);
+      else storage.remove(KEY_CONVERSATION);
+    },
+    loadUserPrefs() {
+      const raw = storage.get(KEY_USER_PREFS);
+      if (!raw) return {};
+      try {
+        const parsed = JSON.parse(raw);
+        return isPlainObject(parsed) ? parsed : {};
+      } catch (error) {
+        log2.warn("loadUserPrefs parse failed", { error });
+        return {};
+      }
+    },
+    saveUserPrefs(s) {
+      try {
+        storage.set(KEY_USER_PREFS, JSON.stringify(s));
+      } catch (error) {
+        log2.warn("saveUserPrefs serialise failed", { error });
+      }
+    },
+    patchUserPrefs(patch) {
+      const current = persistence.loadUserPrefs();
+      persistence.saveUserPrefs({ ...current, ...patch });
+    },
+    loadPanelOpen() {
+      const raw = storage.get(KEY_PANEL_OPEN);
+      if (raw === "1") return true;
+      if (raw === "0") return false;
+      return null;
+    },
+    savePanelOpen(open) {
+      storage.set(KEY_PANEL_OPEN, open ? "1" : "0");
+    },
+    loadPanelSize() {
+      const raw = storage.get(KEY_PANEL_SIZE);
+      return raw === "normal" || raw === "expanded" || raw === "fullscreen" ? raw : null;
+    },
+    savePanelSize(size) {
+      storage.set(KEY_PANEL_SIZE, size);
+    },
+    loadCalloutDismissed(currentText) {
+      if (!currentText) return false;
+      const dismissedText = storage.get(KEY_CALLOUT_DISMISSED);
+      return !!dismissedText && dismissedText === currentText;
+    },
+    saveCalloutDismissed(currentText) {
+      if (currentText) storage.set(KEY_CALLOUT_DISMISSED, currentText);
+      else storage.remove(KEY_CALLOUT_DISMISSED);
+    },
+    loadSidebarCollapsed() {
+      const raw = storage.get(KEY_SIDEBAR_COLLAPSED);
+      if (raw === "1") return true;
+      if (raw === "0") return false;
+      return null;
+    },
+    saveSidebarCollapsed(collapsed) {
+      storage.set(KEY_SIDEBAR_COLLAPSED, collapsed ? "1" : "0");
+    },
+    loadActiveModule() {
+      return storage.get(KEY_ACTIVE_MODULE) || null;
+    },
+    saveActiveModule(id) {
+      storage.set(KEY_ACTIVE_MODULE, id);
+    },
+    loadFormsDone() {
+      const raw = storage.get(KEY_FORMS_DONE);
+      if (!raw) return {};
+      try {
+        const parsed = JSON.parse(raw);
+        return isPlainObject(parsed) ? parsed : {};
+      } catch (error) {
+        log2.warn("loadFormsDone parse failed", { error });
+        return {};
+      }
+    },
+    saveFormDone(id) {
+      try {
+        const done = persistence.loadFormsDone();
+        done[id] = Date.now();
+        storage.set(KEY_FORMS_DONE, JSON.stringify(done));
+      } catch (error) {
+        log2.warn("saveFormDone serialise failed", { error });
+      }
+    },
+    clearConversation() {
+      storage.remove(KEY_CONVERSATION);
+    }
+  };
+  return persistence;
+}
+function isPlainObject(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+
 // src/styles/tokens.css
 var tokens_default = ':host{--__P__-accent-user: __BRAND_ACCENT__;--__P__-accent: var(--__P__-accent-user);--__P__-accent-text-user: __BRAND_ACCENT_TEXT__;--__P__-accent-text: var(--__P__-accent-text-user);--__P__-radius: __BRAND_RADIUS__;--__P__-radius-sm: 8px;--__P__-radius-md: 10px;--__P__-radius-lg: 16px;--__P__-font: __BRAND_FONT__;--__P__-font-display: var(--__P__-font);--__P__-font-mono: ui-monospace, "SF Mono", Menlo, Consolas, monospace;--__P__-bg: oklch(1 0 0);--__P__-bg-elevated: oklch(.9789 .0029 278.3);--__P__-surface: var(--__P__-bg-elevated);--__P__-muted: var(--__P__-fg-muted);--__P__-hover: oklch(.1686 .011 278.3 / .06);--__P__-fg: oklch(.1686 .011 278.3);--__P__-fg-muted: oklch(.4932 .0301 278.3);--__P__-border: oklch(.9312 .0084 278.3);--__P__-border-strong: oklch(.8757 .0131 278.3);--__P__-bubble-user: var(--__P__-accent);--__P__-bubble-user-text: var(--__P__-accent-text);--__P__-bubble-assistant: oklch(.9638 .0058 278.3);--__P__-bubble-assistant-text: var(--__P__-fg);--__P__-on-accent: var(--__P__-accent-text);--__P__-success: oklch(.6456 .1654 151.53);--__P__-warning: oklch(.7135 .1494 74.05);--__P__-danger: oklch(.5966 .1818 24.51);--__P__-danger-text: oklch(.5054 .1905 27.52);--__P__-danger-bg: oklch(.5966 .1818 24.51 / .1);--__P__-neutral: oklch(.7137 .0192 278.3);--__P__-focus: var(--__P__-accent);--__P__-shadow-panel: 0 8px 24px -8px rgba(13, 15, 20, .18), 0 24px 64px -24px rgba(13, 15, 20, .24);--__P__-shadow-card: 0 1px 2px rgba(13, 15, 20, .06), 0 4px 12px -6px rgba(13, 15, 20, .12);--__P__-backdrop: oklch(.1686 .011 278.3 / .55);--__P__-shadow-fab: 0 6px 16px -4px color-mix(in oklch, var(--__P__-accent) 45%, transparent), 0 12px 32px -12px rgba(13, 15, 20, .25);--__P__-z-fab: 2147483600;--__P__-z-panel: 2147483601;--__P__-panel-w: 380px;--__P__-panel-h: 600px;--__P__-fab-size: 56px;--__P__-space-1: 4px;--__P__-space-2: 8px;--__P__-space-3: 12px;--__P__-space-4: 16px;--__P__-space-5: 20px;--__P__-space-6: 24px;--__P__-space-8: 32px;--__P__-text-scale: 1;--__P__-text-xs: calc(12px * var(--__P__-text-scale));--__P__-text-sm: calc(13px * var(--__P__-text-scale));--__P__-text-base: calc(15px * var(--__P__-text-scale));--__P__-text-md: calc(16px * var(--__P__-text-scale));--__P__-text-lg: calc(18px * var(--__P__-text-scale));--__P__-text-xl: calc(22px * var(--__P__-text-scale));--__P__-text-2xl: calc(30px * var(--__P__-text-scale))}:host([data-text-size="small"]){--__P__-text-scale: .9}:host([data-text-size="large"]){--__P__-text-scale: 1.15}:host{--__P__-ease: cubic-bezier(.2, .7, .2, 1);--__P__-ease-out: cubic-bezier(.2, .7, .2, 1);--__P__-ease-in: cubic-bezier(.4, 0, 1, 1);--__P__-ease-in-out: cubic-bezier(.65, 0, .35, 1);--__P__-dur-quick: .12s;--__P__-dur-base: .22s;--__P__-dur-slow: .32s;font-family:var(--__P__-font);color:var(--__P__-fg);color-scheme:light;--__P__-color-scheme: light}:host([data-theme="dark"]){--__P__-bg: oklch(.1783 .0128 278.3);--__P__-bg-elevated: oklch(.2232 .0182 278.3);--__P__-fg: oklch(.9368 .01 278.3);--__P__-fg-muted: oklch(.7048 .0296 278.3);--__P__-border: oklch(.2752 .0266 278.3);--__P__-border-strong: oklch(.335 .0291 278.3);--__P__-hover: oklch(.9368 .01 278.3 / .08);--__P__-bubble-assistant: oklch(.2474 .0311 278.3);--__P__-bubble-assistant-text: var(--__P__-fg);--__P__-danger-text: oklch(.8077 .1035 19.57);--__P__-danger-bg: oklch(.5966 .1818 24.51 / .18);--__P__-shadow-panel: 0 8px 24px -8px rgba(0, 0, 0, .6), 0 24px 64px -24px rgba(0, 0, 0, .7);--__P__-shadow-card: 0 1px 2px rgba(0, 0, 0, .4), 0 4px 12px -6px rgba(0, 0, 0, .5);--__P__-backdrop: rgba(0, 0, 0, .65);color-scheme:dark;--__P__-color-scheme: dark}@media(prefers-color-scheme:dark){:host([data-theme="auto"]){--__P__-bg: oklch(.1783 .0128 278.3);--__P__-bg-elevated: oklch(.2232 .0182 278.3);--__P__-fg: oklch(.9368 .01 278.3);--__P__-fg-muted: oklch(.7048 .0296 278.3);--__P__-border: oklch(.2752 .0266 278.3);--__P__-border-strong: oklch(.335 .0291 278.3);--__P__-hover: oklch(.9368 .01 278.3 / .08);--__P__-bubble-assistant: oklch(.2474 .0311 278.3);--__P__-bubble-assistant-text: var(--__P__-fg);--__P__-shadow-panel: 0 8px 24px -8px rgba(0, 0, 0, .6), 0 24px 64px -24px rgba(0, 0, 0, .7);color-scheme:dark;--__P__-color-scheme: dark}}@supports (color: oklch(from red l c h)){:host{--__P__-accent: oklch(from var(--__P__-accent-user) clamp(.3, l, .62) c h);--__P__-accent-text: oklch(from var(--__P__-accent) clamp(0, (l / .623 - 1) * -infinity, 1) 0 h)}:host([data-theme="dark"]){--__P__-accent: oklch(from var(--__P__-accent-user) clamp(.65, l, .85) c h)}@media(prefers-color-scheme:dark){:host([data-theme="auto"]){--__P__-accent: oklch(from var(--__P__-accent-user) clamp(.65, l, .85) c h)}}}@media(prefers-reduced-motion:reduce){:host{--__P__-dur-quick: 1ms;--__P__-dur-base: 1ms;--__P__-dur-slow: 1ms}}\n';
 
@@ -983,7 +1124,7 @@ var FONT = true ? "Inter, system-ui, -apple-system, 'Segoe UI', sans-serif" : "I
 var CSS_TEXT = [tokens_default, reset_default, panel_default, standalone_default, page_default].join("\n").replace(/__P__/g, PREFIX).replaceAll("__BRAND_ACCENT_TEXT__", ACCENT_TEXT).replaceAll("__BRAND_ACCENT__", ACCENT).replaceAll("__BRAND_RADIUS__", RADIUS).replaceAll("__BRAND_FONT__", FONT);
 
 // src/shadow/mount.ts
-var log2 = logger.scope("mount");
+var log3 = logger.scope("mount");
 var sheetsByDocument = /* @__PURE__ */ new WeakMap();
 var HOST_CSS = {
   floating: "all: initial; position: fixed; z-index: 2147483600;",
@@ -1000,7 +1141,7 @@ function hostPositionForMode(mode) {
 }
 function createShadowMount(opts = {}) {
   const position = opts.position ?? "flow";
-  log2.debug("createShadowMount", { position, hasTarget: !!opts.target, hasHost: !!opts.existingHost });
+  log3.debug("createShadowMount", { position, hasTarget: !!opts.target, hasHost: !!opts.existingHost });
   const tagName = `${BRAND.cssPrefix}-chat-host`;
   if (typeof customElements !== "undefined" && !customElements.get(tagName)) {
     customElements.define(tagName, class extends HTMLElement {
@@ -1084,6 +1225,123 @@ function applyHostAttributes(host, resolved) {
   applySize(host, resolved.size);
 }
 
+// src/shadow/iframe-mount.ts
+var log4 = logger.scope("iframe");
+var IFRAME_SRCDOC = '<!doctype html><html><head><meta charset="utf-8"><style>html,body{margin:0;padding:0;background:transparent;overflow:hidden}</style></head><body></body></html>';
+function createIframeMount(opts, position, initialMode = "closed", layoutMode = "floating", target = null) {
+  log4.debug("createIframeMount", { position, initialMode, layoutMode, hasTarget: !!target });
+  const iframe = document.createElement("iframe");
+  iframe.title = `${BRAND.name} chat`;
+  iframe.setAttribute("allow", "microphone; clipboard-write");
+  sizeIframe(iframe, position, initialMode, layoutMode);
+  const parent = layoutMode === "inline" && target ? target : document.body;
+  parent.appendChild(iframe);
+  const doc = iframe.contentDocument;
+  if (!doc) throw new Error("iframe contentDocument unavailable (cross-origin?)");
+  doc.open();
+  doc.write(IFRAME_SRCDOC);
+  doc.close();
+  const mount2 = createShadowMount({ ...opts, target: doc.body });
+  const mo = new MutationObserver(() => {
+    sizeIframe(iframe, position, mount2.hostElement.dataset.mode ?? "closed", layoutMode);
+  });
+  mo.observe(mount2.hostElement, { attributes: true, attributeFilter: ["data-mode"] });
+  return {
+    ...mount2,
+    iframeElement: iframe,
+    destroy() {
+      mo.disconnect();
+      mount2.destroy();
+      iframe.remove();
+    }
+  };
+}
+var BASE_CSS = "border:0;background:transparent;z-index:2147483647;pointer-events:auto;";
+var FLOATING_SIZE_BY_MODE = {
+  closed: { w: "88px", h: "88px" },
+  expanded: { w: "min(calc(100vw - 32px), 680px)", h: "min(calc(100vh - 32px), 860px)" },
+  // `open` (normal) — also the fallback for any other non-fullscreen state.
+  open: { w: "min(calc(100vw - 32px), 440px)", h: "min(calc(100vh - 32px), 700px)" }
+};
+function sizeIframe(iframe, position, mode, layoutMode) {
+  if (mode === "fullscreen" || layoutMode === "standalone") {
+    iframe.style.cssText = `${BASE_CSS}position:fixed;inset:0;width:100vw;height:100vh;`;
+    return;
+  }
+  if (layoutMode === "inline") {
+    iframe.style.cssText = `${BASE_CSS}position:static;display:block;width:100%;height:100%;`;
+    return;
+  }
+  const compact = typeof matchMedia === "function" && matchMedia("(max-width: 640px)").matches;
+  if (compact && (mode === "open" || mode === "expanded")) {
+    iframe.style.cssText = `${BASE_CSS}position:fixed;inset:0;width:100vw;height:100vh;`;
+    return;
+  }
+  const vKey = position.startsWith("top-") ? "top" : "bottom";
+  const hKey = position.endsWith("-left") ? "left" : "right";
+  const { w, h: h2 } = FLOATING_SIZE_BY_MODE[mode] ?? FLOATING_SIZE_BY_MODE.open;
+  iframe.style.cssText = `${BASE_CSS}position:fixed;${vKey}:16px;${hKey}:16px;width:${w};height:${h2};`;
+}
+
+// src/core/events.ts
+var EventBus = class {
+  constructor() {
+    __publicField(this, "handlers", /* @__PURE__ */ new Map());
+  }
+  /**
+   * Register a listener for `name`.
+   * @returns an `off` function that removes this listener.
+   */
+  on(name, fn) {
+    let set = this.handlers.get(name);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      this.handlers.set(name, set);
+    }
+    set.add(fn);
+    return () => this.handlers.get(name)?.delete(fn);
+  }
+  /**
+   * Dispatch an event synchronously to all listeners.
+   * Listener errors are swallowed — the widget must not crash on user callbacks.
+   */
+  emit(name, payload) {
+    const set = this.handlers.get(name);
+    if (!set) return;
+    for (const fn of set) {
+      try {
+        fn(payload);
+      } catch {
+      }
+    }
+  }
+  /** Remove every listener. Called by the instance `destroy()`. */
+  clear() {
+    this.handlers.clear();
+  }
+};
+
+// src/core/boot.ts
+import { h, render as renderPreact } from "preact";
+
+// src/ui/app.tsx
+import { useCallback as useCallback6, useEffect as useEffect17, useMemo as useMemo3, useRef as useRef9, useState as useState13 } from "preact/hooks";
+import { useComputed as useComputed7, useSignal as useSignal2 } from "@preact/signals";
+
+// src/core/handshake-shape.ts
+function isPlainObject2(raw) {
+  return !!raw && typeof raw === "object" && !Array.isArray(raw);
+}
+function isSiteConfigShape(raw) {
+  return isPlainObject2(raw);
+}
+function isBlocksConfigShape(raw) {
+  if (!isPlainObject2(raw)) return false;
+  if (raw.navigation !== void 0 && !Array.isArray(raw.navigation)) return false;
+  if (raw.linkCards !== void 0 && !Array.isArray(raw.linkCards)) return false;
+  return true;
+}
+
 // src/ui/host-mode.ts
 function computeHostMode(configured, panelSize, isOpen) {
   if (configured === "page") return "page";
@@ -1134,30 +1392,6 @@ function createAuth(opts) {
   };
 }
 
-// src/core/ids.ts
-function uuid7() {
-  const ts = Date.now();
-  const bytes = new Uint8Array(16);
-  bytes[0] = Math.floor(ts / 2 ** 40) & 255;
-  bytes[1] = Math.floor(ts / 2 ** 32) & 255;
-  bytes[2] = ts >>> 24 & 255;
-  bytes[3] = ts >>> 16 & 255;
-  bytes[4] = ts >>> 8 & 255;
-  bytes[5] = ts & 255;
-  fillRandom(bytes.subarray(6));
-  bytes[6] = bytes[6] & 15 | 112;
-  bytes[8] = bytes[8] & 63 | 128;
-  const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
-  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
-}
-function fillRandom(view) {
-  if (typeof crypto !== "undefined" && typeof crypto.getRandomValues === "function") {
-    crypto.getRandomValues(view);
-    return;
-  }
-  for (let i = 0; i < view.length; i++) view[i] = Math.floor(Math.random() * 256);
-}
-
 // src/stream/types.ts
 var StreamError = class extends Error {
   constructor(message, code, status, cause) {
@@ -1170,7 +1404,7 @@ var StreamError = class extends Error {
 };
 
 // src/stream/parser.ts
-var log3 = logger.scope("parser");
+var log5 = logger.scope("parser");
 async function* parseChatStream(response, signal7) {
   if (!response.ok) {
     const text = await response.text().catch(() => "");
@@ -1222,10 +1456,10 @@ ${part}` : part;
   if (!dataPayload || dataPayload === "[DONE]") return null;
   try {
     const chunk = JSON.parse(dataPayload);
-    log3.trace("chunk", { type: chunk.type, eventId });
+    log5.trace("chunk", { type: chunk.type, eventId });
     return { chunk, eventId };
   } catch (err) {
-    log3.trace("frame parse failed", { err, payload: dataPayload.slice(0, 200) });
+    log5.trace("frame parse failed", { err, payload: dataPayload.slice(0, 200) });
     return null;
   }
 }
@@ -1380,7 +1614,7 @@ function messageToWireParts(m) {
 }
 
 // src/stream/transport.ts
-var log4 = logger.scope("transport");
+var log6 = logger.scope("transport");
 var MAX_RESUME_ATTEMPTS = 3;
 var RESUME_BACKOFF_MS = 400;
 var CONTENT_CACHE_TTL_MS = 6e4;
@@ -1422,6 +1656,12 @@ var AgentTransport = class {
     // always sees the visitor's latest context as they navigate.
     __publicField(this, "userContext");
     __publicField(this, "pageContext");
+    // Active BCP-47 locale, carried as the envelope's `locale` on EVERY request
+    // so the backend can localize replies AND the data module can return
+    // localized content + forms. Refreshed via `setLocale` whenever the visitor
+    // switches (no re-handshake needed). Resolved + clamped to the deployment's
+    // availableLocales by `resolveOptions` before it reaches here.
+    __publicField(this, "locale");
     // ---- Data API (content / forms — module-help-ai-data-api) --------------
     //
     // The DATA surfaces live on `dataApiBaseUrl` (default `${baseUrl}/api/data`)
@@ -1447,6 +1687,15 @@ var AgentTransport = class {
     this.userContext = userContext;
     this.pageContext = pageContext;
   }
+  /**
+   * Update the active locale carried on every subsequent request. Call on
+   * mount (before the first handshake) and whenever the user picks a new
+   * locale — the next content / forms / message request reflects it with no
+   * extra round-trip.
+   */
+  setLocale(locale) {
+    this.locale = locale;
+  }
   /**
    * Seed the visitor + conversation identity from persistence BEFORE the first
    * `handshake` resolves. A mount-time `resumeStream()` runs in parallel
@@ -1463,6 +1712,7 @@ var AgentTransport = class {
     const out = {};
     if (this.visitorId) out.visitorId = this.visitorId;
     if (this.conversationId) out.conversationId = this.conversationId;
+    if (this.locale) out.locale = this.locale;
     const context = encodeContext(this.userContext, this.pageContext);
     if (context) out[CONTEXT_PARAM] = context;
     return out;
@@ -1490,13 +1740,13 @@ var AgentTransport = class {
   }
   /** One-shot runtime bootstrap. Called once after the widget mounts. */
   async handshake(body) {
-    log4.debug("handshake \u2192", {
+    log6.debug("handshake \u2192", {
       visitorId: body.visitorId,
       conversationId: body.conversationId,
       locale: body.locale
     });
     const res = await this.postJson(DEFAULT_PATHS.handshake, body, "handshake");
-    log4.debug("handshake \u2190", {
+    log6.debug("handshake \u2190", {
       visitorId: res.visitorId,
       conversationId: res.conversationId,
       hasWelcome: !!res.welcome,
@@ -1504,7 +1754,7 @@ var AgentTransport = class {
       rebind: res.rebind
     });
     if (!isHandshakeResponseShape(res)) {
-      log4.warn("handshake response did not match expected shape; using raw response", { response: res });
+      log6.warn("handshake response did not match expected shape; using raw response", { response: res });
     }
     this.visitorId = res.visitorId ?? body.visitorId;
     this.conversationId = res.conversationId;
@@ -1512,11 +1762,11 @@ var AgentTransport = class {
   }
   /** Upload a file attachment. Returns the `{id, url}` the backend assigns. */
   async uploadFile(file) {
-    log4.debug("uploadFile \u2192", { name: file.name, size: file.size, type: file.type });
+    log6.debug("uploadFile \u2192", { name: file.name, size: file.size, type: file.type });
     const fd = new FormData();
     fd.append("file", file, file.name);
     const res = await this.postForm(this.uploadPath, fd, "upload");
-    log4.debug("uploadFile \u2190", { id: res.id, url: res.url });
+    log6.debug("uploadFile \u2190", { id: res.id, url: res.url });
     return res;
   }
   /**
@@ -1524,12 +1774,12 @@ var AgentTransport = class {
    * Only used when `features.voice === 'server'`.
    */
   async transcribe(audio, mimeType = "audio/webm") {
-    log4.debug("transcribe \u2192", { size: audio.size, mimeType });
+    log6.debug("transcribe \u2192", { size: audio.size, mimeType });
     const fd = new FormData();
     fd.append("audio", audio, `voice.${extensionFor(mimeType)}`);
     fd.append("mimeType", mimeType);
     const res = await this.postForm(this.transcribePath, fd, "transcribe");
-    log4.debug("transcribe \u2190", { textLen: res.text.length });
+    log6.debug("transcribe \u2190", { textLen: res.text.length });
     return res;
   }
   async listConversations(params = {}) {
@@ -1537,14 +1787,14 @@ var AgentTransport = class {
     if (params.visitorId) url.searchParams.set("visitorId", params.visitorId);
     if (params.limit) url.searchParams.set("limit", String(params.limit));
     if (params.cursor) url.searchParams.set("cursor", params.cursor);
-    log4.debug("listConversations \u2192", {
+    log6.debug("listConversations \u2192", {
       visitorId: params.visitorId ?? this.visitorId,
       limit: params.limit,
       cursor: params.cursor
     });
     const res = await this.getJson(url.toString(), "listConversations");
     const conversations = res.conversations ?? [];
-    log4.debug("listConversations \u2190", { count: conversations.length, nextCursor: res.nextCursor });
+    log6.debug("listConversations \u2190", { count: conversations.length, nextCursor: res.nextCursor });
     return {
       conversations: conversations.map((conversation) => ({
         conversationId: conversation.conversationId,
@@ -1560,10 +1810,10 @@ var AgentTransport = class {
   async loadConversation(conversationId) {
     const url = new URL(this.url(DEFAULT_PATHS.listMessages));
     url.searchParams.set("conversationId", conversationId);
-    log4.debug("loadConversation \u2192", { conversationId, visitorId: this.visitorId });
+    log6.debug("loadConversation \u2192", { conversationId, visitorId: this.visitorId });
     const res = await this.getJson(url.toString(), "loadConversation");
     const messages = res.messages ?? [];
-    log4.debug("loadConversation \u2190", {
+    log6.debug("loadConversation \u2190", {
       conversationId: res.conversationId,
       canContinue: res.canContinue,
       messageCount: messages.length,
@@ -1585,11 +1835,11 @@ var AgentTransport = class {
    */
   async markRead(conversationId) {
     if (!this.visitorId || !conversationId) return;
-    log4.debug("markRead \u2192", { conversationId, visitorId: this.visitorId });
+    log6.debug("markRead \u2192", { conversationId, visitorId: this.visitorId });
     try {
       await this.postJson(DEFAULT_PATHS.markRead, { conversationId }, "markRead");
     } catch (err) {
-      log4.debug("markRead failed (non-fatal)", { err });
+      log6.debug("markRead failed (non-fatal)", { err });
     }
   }
   /** Fetch content rows by filter. `GET /pai/content` (data-API), TTL-cached. */
@@ -1597,7 +1847,7 @@ var AgentTransport = class {
     const key = JSON.stringify(query, Object.keys(query).toSorted());
     const cached = this.contentCache.get(key);
     if (cached && Date.now() - cached.at < CONTENT_CACHE_TTL_MS) {
-      log4.debug("listContent \u2192 cache", query);
+      log6.debug("listContent \u2192 cache", query);
       return cached.result;
     }
     const result = this.fetchContent(query).catch((err) => {
@@ -1613,10 +1863,10 @@ var AgentTransport = class {
       if (value === void 0) continue;
       url.searchParams.set(key, Array.isArray(value) ? value.join(",") : String(value));
     }
-    log4.debug("listContent \u2192", query);
+    log6.debug("listContent \u2192", query);
     const res = await this.getJson(url.toString(), "listContent");
     const items = res.items ?? [];
-    log4.debug("listContent \u2190", { count: items.length, total: res.pagination?.total });
+    log6.debug("listContent \u2190", { count: items.length, total: res.pagination?.total });
     return { ...res, items };
   }
   /**
@@ -1634,21 +1884,21 @@ var AgentTransport = class {
   async bootstrap(conversationId) {
     const url = new URL(this.dataUrl(DEFAULT_PATHS.bootstrap));
     if (conversationId) url.searchParams.set("conversationId", conversationId);
-    log4.debug("bootstrap \u2192", { conversationId: conversationId ?? this.conversationId });
+    log6.debug("bootstrap \u2192", { conversationId: conversationId ?? this.conversationId });
     const res = await this.getJson(url.toString(), "bootstrap");
     const forms = res.forms ?? [];
     const formSubmissions = res.formSubmissions ?? [];
-    log4.debug("bootstrap \u2190", { forms: forms.length, formSubmissions: formSubmissions.length });
+    log6.debug("bootstrap \u2190", { forms: forms.length, formSubmissions: formSubmissions.length });
     return { forms, formSubmissions };
   }
   async saveUserPrefs(userPrefs) {
-    log4.debug("saveUserPrefs \u2192", {
+    log6.debug("saveUserPrefs \u2192", {
       visitorId: this.visitorId,
       conversationId: this.conversationId,
       settingsKeys: Object.keys(userPrefs)
     });
     const res = await this.postJson(DEFAULT_PATHS.updateSettings, { userPrefs }, "saveUserPrefs");
-    log4.debug("saveUserPrefs \u2190", { ok: res.ok });
+    log6.debug("saveUserPrefs \u2190", { ok: res.ok });
     return res;
   }
   get uploadPath() {
@@ -1669,15 +1919,15 @@ var AgentTransport = class {
    * that doesn't implement the endpoint) is non-fatal, so callers don't await.
    */
   async submitForm(body) {
-    log4.debug("submitForm \u2192", { formId: body.formId, trigger: body.trigger, fields: Object.keys(body.values).length });
+    log6.debug("submitForm \u2192", { formId: body.formId, trigger: body.trigger, fields: Object.keys(body.values).length });
     try {
       await this.postJson(this.dataUrl(this.submitFormPath), body, "submitForm");
     } catch (err) {
-      log4.debug("submitForm failed (non-fatal)", { err });
+      log6.debug("submitForm failed (non-fatal)", { err });
     }
   }
   sendMessage(body) {
-    log4.debug("message \u2192", {
+    log6.debug("message \u2192", {
       conversationId: body.conversationId,
       visitorId: body.visitorId,
       messageCount: body.messages.length,
@@ -1757,17 +2007,17 @@ var AgentTransport = class {
         });
       } catch (err) {
         if (ctrl.signal.aborted) return;
-        log4.debug("resume fetch failed \u2014 retrying", { attempt, err });
+        log6.debug("resume fetch failed \u2014 retrying", { attempt, err });
         continue;
       }
       if (res.status === 204 || !res.ok) {
-        log4.debug("resume \u2192 no in-flight stream", { status: res.status });
+        log6.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");
+        log6.debug("resume \u2192 stream closed with no new events; nothing to resume");
         return;
       }
     }
@@ -1794,14 +2044,14 @@ var AgentTransport = class {
     } catch (err) {
       if (ctrl.signal.aborted) return true;
       if (err instanceof StreamError && err.status !== void 0) throw err;
-      log4.debug("stream segment dropped", { err });
+      log6.debug("stream segment dropped", { err });
     }
     return false;
   }
   /** Abort + fire-and-forget POST to `/pai/cancel-stream`. Idempotent. */
   cancelStream(ctrl, conversationId) {
     if (ctrl.signal.aborted) return;
-    log4.debug("cancel stream", { conversationId, visitorId: this.visitorId });
+    log6.debug("cancel stream", { conversationId, visitorId: this.visitorId });
     ctrl.abort();
     if (!this.visitorId || !conversationId) return;
     this.fetchImpl(this.url(DEFAULT_PATHS.cancelStream), {
@@ -1810,7 +2060,7 @@ var AgentTransport = class {
       headers: { "content-type": "application/json", ...this.opts.auth.headers() },
       body: JSON.stringify(this.withEnvelope({})),
       keepalive: true
-    }).catch((err) => log4.debug("cancel POST failed (non-fatal)", { err }));
+    }).catch((err) => log6.debug("cancel POST failed (non-fatal)", { err }));
   }
   // ---- Low-level fetch helpers ------------------------------------------
   async *openMessageStream(body, signal7) {
@@ -1892,13 +2142,13 @@ var AgentTransport = class {
         if (attempt >= MAX_REQUEST_RETRIES) {
           throw new StreamError(`${label} failed: network error`, "network", void 0, err);
         }
-        log4.debug("request network error \u2014 retrying", { label, attempt });
+        log6.debug("request network error \u2014 retrying", { label, attempt });
         await sleep(backoffMs(attempt));
         continue;
       }
       if (res.ok || !RETRYABLE_STATUS.has(res.status) || attempt >= MAX_REQUEST_RETRIES) return res;
       const wait = retryAfterMs(res.headers) ?? backoffMs(attempt);
-      log4.debug("request retryable status \u2014 retrying", { label, status: res.status, attempt, wait });
+      log6.debug("request retryable status \u2014 retrying", { label, status: res.status, attempt, wait });
       await sleep(wait);
     }
   }
@@ -2093,7 +2343,7 @@ var TRIGGER = {
 };
 
 // src/stream/reducer.ts
-var log5 = logger.scope("reducer");
+var log7 = logger.scope("reducer");
 var StreamReducer = class {
   constructor(messagesSig) {
     __publicField(this, "messagesSig", messagesSig);
@@ -2115,13 +2365,13 @@ var StreamReducer = class {
       case "finish-step":
         return;
       case "finish":
-        log5.debug("finish", { reason: chunk.finishReason, canContinue: chunk.canContinue });
+        log7.debug("finish", { reason: chunk.finishReason, canContinue: chunk.canContinue });
         m.status = "complete";
         if (chunk.finishReason) m.finishReason = chunk.finishReason;
         this.bumpDone(m);
         return;
       case "error":
-        log5.warn("stream error chunk", { errorText: chunk.errorText });
+        log7.warn("stream error chunk", { errorText: chunk.errorText });
         m.status = "error";
         m.errorText = chunk.errorText;
         this.bumpDone(m);
@@ -2160,226 +2410,101 @@ var StreamReducer = class {
         appendPart(m, { kind: "file", url: chunk.url, mediaType: chunk.mediaType });
         return;
       case "source-url": {
-        const parts = m.partsSig.value;
-        if (parts.some((p33) => p33.kind === "source" && p33.sourceId === chunk.sourceId)) return;
-        appendPart(m, { kind: "source", sourceId: chunk.sourceId, url: chunk.url, title: chunk.title });
-        return;
-      }
-      case "data-notification":
-        return;
-      default: {
-        const _exhaustive = chunk;
-        void _exhaustive;
-      }
-    }
-  }
-  /**
-   * Terminal-state bump (`finish`/`error`). Touches the message's own `partsSig`
-   * AND the list so subscribers re-render: a buffered bubble (subscribed to its
-   * parts) flips out of the loading indicator into the finished reply, and the
-   * list reflects the new `status`.
-   */
-  bumpDone(m) {
-    m.partsSig.value = [...m.partsSig.value];
-    this.messagesSig.value = [...this.messagesSig.value];
-  }
-};
-function ensureTextPart(m, kind, id) {
-  const existing = m.partsSig.value.find((p33) => p33.kind === kind && p33.id === id);
-  if (existing) return existing;
-  const part = { kind, id, textSig: signal2(""), doneSig: signal2(false) };
-  appendPart(m, part);
-  return part;
-}
-function ensureToolPart(m, toolCallId, toolName) {
-  const existing = m.partsSig.value.find((p33) => p33.kind === "tool" && p33.toolCallId === toolCallId);
-  if (existing) return existing;
-  const part = {
-    kind: "tool",
-    toolCallId,
-    toolName: toolName ?? "tool",
-    inputPartialSig: signal2(""),
-    inputSig: signal2(void 0),
-    outputSig: signal2(void 0),
-    errorSig: signal2(void 0),
-    stateSig: signal2("input"),
-    approvalSig: signal2(void 0)
-  };
-  appendPart(m, part);
-  return part;
-}
-function appendPart(m, part) {
-  m.partsSig.value = [...m.partsSig.value, part];
-}
-function applyTool(m, chunk) {
-  switch (chunk.type) {
-    case "tool-input-start":
-      ensureToolPart(m, chunk.toolCallId, chunk.toolName);
-      return;
-    case "tool-input-delta": {
-      const p33 = ensureToolPart(m, chunk.toolCallId);
-      p33.inputPartialSig.value += chunk.delta;
-      return;
-    }
-    case "tool-input-available": {
-      const p33 = ensureToolPart(m, chunk.toolCallId, chunk.toolName);
-      p33.inputSig.value = chunk.input;
-      p33.stateSig.value = isAskUserInputTool(p33.toolName) ? "awaiting-input" : "awaiting";
-      return;
-    }
-    case "tool-approval-request": {
-      const p33 = ensureToolPart(m, chunk.toolCallId, chunk.toolName);
-      p33.approvalSig.value = { id: chunk.approvalId };
-      p33.stateSig.value = "awaiting-approval";
-      return;
-    }
-    case "tool-output-available": {
-      const p33 = ensureToolPart(m, chunk.toolCallId);
-      p33.outputSig.value = chunk.output;
-      p33.stateSig.value = "output";
-      return;
-    }
-    case "tool-output-error": {
-      const p33 = ensureToolPart(m, chunk.toolCallId);
-      p33.errorSig.value = chunk.errorText;
-      p33.stateSig.value = "error";
-      return;
-    }
-    default:
-      return;
-  }
-}
-
-// src/core/persistence.ts
-var log6 = logger.scope("persistence");
-function createPersistence(widgetId, storage = defaultStorage) {
-  const prefix = `${BRAND.cssPrefix}.${widgetId}`;
-  const KEY_VISITOR = `${prefix}.visitorId`;
-  const KEY_CONVERSATION = `${prefix}.conversationId`;
-  const KEY_USER_PREFS = `${prefix}.userPrefs`;
-  const KEY_PANEL_OPEN = `${prefix}.panelOpen`;
-  const KEY_PANEL_SIZE = `${prefix}.panelSize`;
-  const KEY_CALLOUT_DISMISSED = `${prefix}.calloutDismissed`;
-  const KEY_SIDEBAR_COLLAPSED = `${prefix}.sidebarCollapsed`;
-  const KEY_ACTIVE_MODULE = `${prefix}.activeModule`;
-  const KEY_FORMS_DONE = `${prefix}.formsDone`;
-  const persistence = {
-    getVisitorId() {
-      const existing = storage.get(KEY_VISITOR);
-      if (existing) return existing;
-      const minted = uuid7();
-      storage.set(KEY_VISITOR, minted);
-      return minted;
-    },
-    setVisitorId(id) {
-      log6.debug("setVisitorId (rebind)", { id, widgetId });
-      storage.set(KEY_VISITOR, id);
-    },
-    loadConversationId() {
-      return storage.get(KEY_CONVERSATION) ?? void 0;
-    },
-    saveConversationId(id) {
-      log6.trace("saveConversationId", { id, widgetId });
-      if (id) storage.set(KEY_CONVERSATION, id);
-      else storage.remove(KEY_CONVERSATION);
-    },
-    loadUserPrefs() {
-      const raw = storage.get(KEY_USER_PREFS);
-      if (!raw) return {};
-      try {
-        const parsed = JSON.parse(raw);
-        return isPlainObject2(parsed) ? parsed : {};
-      } catch (error) {
-        log6.warn("loadUserPrefs parse failed", { error });
-        return {};
-      }
-    },
-    saveUserPrefs(s) {
-      try {
-        storage.set(KEY_USER_PREFS, JSON.stringify(s));
-      } catch (error) {
-        log6.warn("saveUserPrefs serialise failed", { error });
-      }
-    },
-    patchUserPrefs(patch) {
-      const current = persistence.loadUserPrefs();
-      persistence.saveUserPrefs({ ...current, ...patch });
-    },
-    loadPanelOpen() {
-      const raw = storage.get(KEY_PANEL_OPEN);
-      if (raw === "1") return true;
-      if (raw === "0") return false;
-      return null;
-    },
-    savePanelOpen(open) {
-      storage.set(KEY_PANEL_OPEN, open ? "1" : "0");
-    },
-    loadPanelSize() {
-      const raw = storage.get(KEY_PANEL_SIZE);
-      return raw === "normal" || raw === "expanded" || raw === "fullscreen" ? raw : null;
-    },
-    savePanelSize(size) {
-      storage.set(KEY_PANEL_SIZE, size);
-    },
-    loadCalloutDismissed(currentText) {
-      if (!currentText) return false;
-      const dismissedText = storage.get(KEY_CALLOUT_DISMISSED);
-      return !!dismissedText && dismissedText === currentText;
-    },
-    saveCalloutDismissed(currentText) {
-      if (currentText) storage.set(KEY_CALLOUT_DISMISSED, currentText);
-      else storage.remove(KEY_CALLOUT_DISMISSED);
-    },
-    loadSidebarCollapsed() {
-      const raw = storage.get(KEY_SIDEBAR_COLLAPSED);
-      if (raw === "1") return true;
-      if (raw === "0") return false;
-      return null;
-    },
-    saveSidebarCollapsed(collapsed) {
-      storage.set(KEY_SIDEBAR_COLLAPSED, collapsed ? "1" : "0");
-    },
-    loadActiveModule() {
-      return storage.get(KEY_ACTIVE_MODULE) || null;
-    },
-    saveActiveModule(id) {
-      storage.set(KEY_ACTIVE_MODULE, id);
-    },
-    loadFormsDone() {
-      const raw = storage.get(KEY_FORMS_DONE);
-      if (!raw) return {};
-      try {
-        const parsed = JSON.parse(raw);
-        return isPlainObject2(parsed) ? parsed : {};
-      } catch (error) {
-        log6.warn("loadFormsDone parse failed", { error });
-        return {};
+        const parts = m.partsSig.value;
+        if (parts.some((p33) => p33.kind === "source" && p33.sourceId === chunk.sourceId)) return;
+        appendPart(m, { kind: "source", sourceId: chunk.sourceId, url: chunk.url, title: chunk.title });
+        return;
       }
-    },
-    saveFormDone(id) {
-      try {
-        const done = persistence.loadFormsDone();
-        done[id] = Date.now();
-        storage.set(KEY_FORMS_DONE, JSON.stringify(done));
-      } catch (error) {
-        log6.warn("saveFormDone serialise failed", { error });
+      case "data-notification":
+        return;
+      default: {
+        const _exhaustive = chunk;
+        void _exhaustive;
       }
-    },
-    clearConversation() {
-      storage.remove(KEY_CONVERSATION);
     }
+  }
+  /**
+   * Terminal-state bump (`finish`/`error`). Touches the message's own `partsSig`
+   * AND the list so subscribers re-render: a buffered bubble (subscribed to its
+   * parts) flips out of the loading indicator into the finished reply, and the
+   * list reflects the new `status`.
+   */
+  bumpDone(m) {
+    m.partsSig.value = [...m.partsSig.value];
+    this.messagesSig.value = [...this.messagesSig.value];
+  }
+};
+function ensureTextPart(m, kind, id) {
+  const existing = m.partsSig.value.find((p33) => p33.kind === kind && p33.id === id);
+  if (existing) return existing;
+  const part = { kind, id, textSig: signal2(""), doneSig: signal2(false) };
+  appendPart(m, part);
+  return part;
+}
+function ensureToolPart(m, toolCallId, toolName) {
+  const existing = m.partsSig.value.find((p33) => p33.kind === "tool" && p33.toolCallId === toolCallId);
+  if (existing) return existing;
+  const part = {
+    kind: "tool",
+    toolCallId,
+    toolName: toolName ?? "tool",
+    inputPartialSig: signal2(""),
+    inputSig: signal2(void 0),
+    outputSig: signal2(void 0),
+    errorSig: signal2(void 0),
+    stateSig: signal2("input"),
+    approvalSig: signal2(void 0)
   };
-  return persistence;
+  appendPart(m, part);
+  return part;
 }
-function isPlainObject2(v) {
-  return typeof v === "object" && v !== null && !Array.isArray(v);
+function appendPart(m, part) {
+  m.partsSig.value = [...m.partsSig.value, part];
+}
+function applyTool(m, chunk) {
+  switch (chunk.type) {
+    case "tool-input-start":
+      ensureToolPart(m, chunk.toolCallId, chunk.toolName);
+      return;
+    case "tool-input-delta": {
+      const p33 = ensureToolPart(m, chunk.toolCallId);
+      p33.inputPartialSig.value += chunk.delta;
+      return;
+    }
+    case "tool-input-available": {
+      const p33 = ensureToolPart(m, chunk.toolCallId, chunk.toolName);
+      p33.inputSig.value = chunk.input;
+      p33.stateSig.value = isAskUserInputTool(p33.toolName) ? "awaiting-input" : "awaiting";
+      return;
+    }
+    case "tool-approval-request": {
+      const p33 = ensureToolPart(m, chunk.toolCallId, chunk.toolName);
+      p33.approvalSig.value = { id: chunk.approvalId };
+      p33.stateSig.value = "awaiting-approval";
+      return;
+    }
+    case "tool-output-available": {
+      const p33 = ensureToolPart(m, chunk.toolCallId);
+      p33.outputSig.value = chunk.output;
+      p33.stateSig.value = "output";
+      return;
+    }
+    case "tool-output-error": {
+      const p33 = ensureToolPart(m, chunk.toolCallId);
+      p33.errorSig.value = chunk.errorText;
+      p33.stateSig.value = "error";
+      return;
+    }
+    default:
+      return;
+  }
 }
 
 // src/core/feedback/index.ts
 import { signal as signal3 } from "@preact/signals";
 
 // src/core/feedback/audio.ts
-var log7 = logger.scope("feedback:audio");
+var log8 = logger.scope("feedback:audio");
 var AudioEngine = class {
   constructor() {
     __publicField(this, "ctx", null);
@@ -2400,7 +2525,7 @@ var AudioEngine = class {
       this.master.gain.value = 1;
       this.master.connect(this.ctx.destination);
     } catch (err) {
-      log7.warn("AudioContext init failed", { err });
+      log8.warn("AudioContext init failed", { err });
     }
   }
   /** Route all sounds through this multiplier. Call on volume change. */
@@ -2457,7 +2582,7 @@ var AudioEngine = class {
       this.buffers.set(url, buf);
       return buf;
     }).catch((err) => {
-      log7.warn("audio fetch/decode failed", { url, err });
+      log8.warn("audio fetch/decode failed", { url, err });
       this.buffers.delete(url);
       return null;
     });
@@ -2543,7 +2668,7 @@ function acquireHaptics() {
 }
 
 // src/core/feedback/index.ts
-var log8 = logger.scope("feedback");
+var log9 = logger.scope("feedback");
 var DEDUP_WINDOW_MS = 100;
 var FeedbackBus = class {
   constructor(sound, haptics) {
@@ -2621,7 +2746,7 @@ var FeedbackBus = class {
     const override = this.sound.events?.[event];
     if (override === false) return;
     if (typeof override === "string") {
-      this.audio.playUrl(override).catch((err) => log8.warn("audio play failed", { err, url: override }));
+      this.audio.playUrl(override).catch((err) => log9.warn("audio play failed", { err, url: override }));
       return;
     }
     const tone = DEFAULT_TONES[event];
@@ -3266,7 +3391,7 @@ function AgentBadge({ agent }) {
 import { useEffect as useEffect4, useRef as useRef2, useState as useState2 } from "preact/hooks";
 
 // src/core/attachments.ts
-var log9 = logger.scope("attachments");
+var log10 = logger.scope("attachments");
 function ingest(source, existing, limits) {
   const incoming = collectFiles(source);
   const accepted = [];
@@ -3285,7 +3410,7 @@ function ingest(source, existing, limits) {
     totalCount += 1;
   }
   if (accepted.length || rejected.length) {
-    log9.debug("ingest", {
+    log10.debug("ingest", {
       accepted: accepted.length,
       rejected: rejected.map((r) => ({ name: r.file.name, reason: r.reason }))
     });
@@ -3296,7 +3421,7 @@ function revoke(att) {
   try {
     URL.revokeObjectURL(att.previewUrl);
   } catch (error) {
-    log9.debug("revokeObjectURL failed", { error });
+    log10.debug("revokeObjectURL failed", { error });
   }
 }
 function reject(file, count, bytes, limits, accept) {
@@ -3472,7 +3597,7 @@ function pickSupportedMimeType() {
 // src/ui/composer.tsx
 import { jsx as jsx6, jsxs as jsxs5 } from "preact/jsx-runtime";
 var p7 = BRAND.cssPrefix;
-var log10 = logger.scope("composer");
+var log11 = logger.scope("composer");
 function totalBytes(items) {
   return items.reduce((acc, a) => acc + a.size, 0);
 }
@@ -3525,7 +3650,7 @@ function Composer({ options, transport, feedback, bus, isStreaming, onSend, onSt
       attachFromDrop: (items) => {
         const result = ingest(items, attsRef.current, options.attachments);
         if (result.accepted.length === 0) return;
-        log10.info("attach (drop)", { count: result.accepted.length, totalBytes: totalBytes(result.accepted) });
+        log11.info("attach (drop)", { count: result.accepted.length, totalBytes: totalBytes(result.accepted) });
         bus.emit("attach", { count: result.accepted.length, totalBytes: totalBytes(result.accepted) });
         setAtts((prev) => [...prev, ...result.accepted]);
       }
@@ -3546,7 +3671,7 @@ function Composer({ options, transport, feedback, bus, isStreaming, onSend, onSt
         const result = ingest(data.items, attsRef.current, options.attachments);
         if (result.accepted.length > 0) {
           e.preventDefault();
-          log10.info("attach (paste)", { count: result.accepted.length, totalBytes: totalBytes(result.accepted) });
+          log11.info("attach (paste)", { count: result.accepted.length, totalBytes: totalBytes(result.accepted) });
           bus.emit("attach", { count: result.accepted.length, totalBytes: totalBytes(result.accepted) });
           setAtts((prev) => [...prev, ...result.accepted]);
           return;
@@ -3580,14 +3705,14 @@ function Composer({ options, transport, feedback, bus, isStreaming, onSend, onSt
     const input = e.target;
     const result = ingest(input.files, atts, options.attachments);
     if (result.accepted.length > 0) {
-      log10.info("attach (file picker)", { count: result.accepted.length, totalBytes: totalBytes(result.accepted) });
+      log11.info("attach (file picker)", { count: result.accepted.length, totalBytes: totalBytes(result.accepted) });
       bus.emit("attach", { count: result.accepted.length, totalBytes: totalBytes(result.accepted) });
       setAtts((prev) => [...prev, ...result.accepted]);
     }
     input.value = "";
   };
   const removeAtt = (id) => {
-    log10.info("removeAttachment", { id });
+    log11.info("removeAttachment", { id });
     bus.emit("removeAttachment", { id });
     setAtts((prev) => {
       const target = prev.find((a) => a.id === id);
@@ -3600,7 +3725,7 @@ function Composer({ options, transport, feedback, bus, isStreaming, onSend, onSt
     if (!voice.isSupported) return;
     if (voiceOn) {
       const durationMs = voiceStartedAtRef.current ? Date.now() - voiceStartedAtRef.current : 0;
-      log10.info("voiceStop", { durationMs });
+      log11.info("voiceStop", { durationMs });
       bus.emit("voiceStop", { durationMs });
       voice.stop();
       setVoiceOn(false);
@@ -3609,7 +3734,7 @@ function Composer({ options, transport, feedback, bus, isStreaming, onSend, onSt
       return;
     }
     voiceStartedAtRef.current = Date.now();
-    log10.info("voiceStart");
+    log11.info("voiceStart");
     bus.emit("voiceStart", void 0);
     setVoiceOn(true);
     feedback.play("voiceStart");
@@ -3619,7 +3744,7 @@ function Composer({ options, transport, feedback, bus, isStreaming, onSend, onSt
         setVoiceOn(false);
         if (voiceStartedAtRef.current) {
           const durationMs = Date.now() - voiceStartedAtRef.current;
-          log10.debug("voiceStop (auto)", { durationMs });
+          log11.debug("voiceStop (auto)", { durationMs });
           bus.emit("voiceStop", { durationMs });
           voiceStartedAtRef.current = null;
         }
@@ -5180,7 +5305,7 @@ function startOfDay(ms) {
 
 // src/ui/conversation-list.tsx
 import { Fragment as Fragment3, jsx as jsx18, jsxs as jsxs15 } from "preact/jsx-runtime";
-var log11 = logger.scope("history");
+var log12 = logger.scope("history");
 var BUCKET_TO_STRING = {
   today: "dateToday",
   yesterday: "dateYesterday",
@@ -5213,7 +5338,7 @@ function ConversationList({
       setState("loaded");
     }).catch((err) => {
       if (cancelled) return;
-      log11.warn("listConversations failed", { err });
+      log12.warn("listConversations failed", { err });
       setState("error");
     });
     return () => {
@@ -5856,7 +5981,7 @@ function ModuleState({
 // src/ui/modules/help.tsx
 import { jsx as jsx27, jsxs as jsxs23 } from "preact/jsx-runtime";
 var p23 = BRAND.cssPrefix;
-var log12 = logger.scope("help");
+var log13 = logger.scope("help");
 var openArticle = (nav, a) => a.url ? nav.push({ kind: "iframe", url: a.url, title: a.title }) : nav.push({ kind: "content", id: a.id, title: a.title });
 function groupByCategory(items) {
   const groups = /* @__PURE__ */ new Map();
@@ -5910,7 +6035,7 @@ function HelpRoot({ transport, strings, config, nav, panelProps }) {
       setState("loaded");
     }).catch((err) => {
       if (cancelled) return;
-      log12.warn("listContent (help) failed", { err });
+      log13.warn("listContent (help) failed", { err });
       setErrorMsg(errorMessageFor(err, strings));
       setState("error");
     });
@@ -5961,7 +6086,7 @@ function HomeCard({ onClick, children, testid }) {
 // src/ui/modules/home.tsx
 import { Fragment as Fragment6, jsx as jsx29, jsxs as jsxs24 } from "preact/jsx-runtime";
 var p25 = BRAND.cssPrefix;
-var log13 = logger.scope("home");
+var log14 = logger.scope("home");
 function resolveGreeting(props2) {
   const name = props2.options.userContext?.name;
   const fromConfig = props2.config.greetingText;
@@ -5980,7 +6105,7 @@ function HomeRoot(props2) {
   useEffect12(() => {
     if (!config.showRecentConversations) return;
     let cancelled = false;
-    transport.listConversations({ limit: 1 }).then((res) => !cancelled && setRecent(res.conversations?.[0] ?? null)).catch((err) => !cancelled && log13.warn("listConversations (home) failed", { err }));
+    transport.listConversations({ limit: 1 }).then((res) => !cancelled && setRecent(res.conversations?.[0] ?? null)).catch((err) => !cancelled && log14.warn("listConversations (home) failed", { err }));
     return () => {
       cancelled = true;
     };
@@ -5988,7 +6113,7 @@ function HomeRoot(props2) {
   useEffect12(() => {
     if (!config.contentTags?.length) return;
     let cancelled = false;
-    transport.listContent({ tags: config.contentTags, limit: 6 }).then((res) => !cancelled && setContent(res.items ?? [])).catch((err) => !cancelled && log13.warn("listContent (home) failed", { err }));
+    transport.listContent({ tags: config.contentTags, limit: 6 }).then((res) => !cancelled && setContent(res.items ?? [])).catch((err) => !cancelled && log14.warn("listContent (home) failed", { err }));
     return () => {
       cancelled = true;
     };
@@ -6062,7 +6187,7 @@ var homeLayout = {
 import { useEffect as useEffect13, useState as useState10 } from "preact/hooks";
 import { jsx as jsx30, jsxs as jsxs25 } from "preact/jsx-runtime";
 var p26 = BRAND.cssPrefix;
-var log14 = logger.scope("news");
+var log15 = logger.scope("news");
 function NewsRoot({ transport, strings, config, nav, panelProps }) {
   const tags = config.contentTags;
   const [state, setState] = useState10("loading");
@@ -6078,7 +6203,7 @@ function NewsRoot({ transport, strings, config, nav, panelProps }) {
       setState("loaded");
     }).catch((err) => {
       if (cancelled) return;
-      log14.warn("listContent (news) failed", { err });
+      log15.warn("listContent (news) failed", { err });
       setErrorMsg(errorMessageFor(err, strings));
       setState("error");
     });
@@ -6193,7 +6318,7 @@ function IframeView({ url, title, strings, onBack, actions }) {
 import { useCallback as useCallback3, useEffect as useEffect14, useState as useState11 } from "preact/hooks";
 import { jsx as jsx33, jsxs as jsxs28 } from "preact/jsx-runtime";
 var p29 = BRAND.cssPrefix;
-var log15 = logger.scope("content");
+var log16 = logger.scope("content");
 function ContentView({ id, title, transport, strings, onBack, actions }) {
   const [item, setItem] = useState11(null);
   const [failed, setFailed] = useState11(false);
@@ -6212,7 +6337,7 @@ function ContentView({ id, title, transport, strings, onBack, actions }) {
       else setFailed(true);
     }).catch((err) => {
       if (cancelled) return;
-      log15.warn("listContent (reader) failed", { err });
+      log16.warn("listContent (reader) failed", { err });
       setFailed(true);
     });
     return () => {
@@ -6432,7 +6557,7 @@ function useLauncherCallout({ callout, persistence }) {
 
 // src/ui/app.tsx
 import { jsx as jsx36, jsxs as jsxs31 } from "preact/jsx-runtime";
-var log16 = logger.scope("app");
+var log17 = logger.scope("app");
 var p32 = BRAND.cssPrefix;
 function App({ options, hostElement, bus }) {
   const [persistence] = useState13(() => createPersistence(options.widgetId, options.storage));
@@ -6490,7 +6615,7 @@ function App({ options, hostElement, bus }) {
   });
   const calloutPersistent = options.launcher.callout?.persistent ?? true;
   const dismissCallout = useCallback6(() => {
-    log16.info("calloutDismiss");
+    log17.info("calloutDismiss");
     bus.emit("calloutDismiss", void 0);
     dismissCalloutRaw();
   }, [bus, dismissCalloutRaw]);
@@ -6524,7 +6649,7 @@ function App({ options, hostElement, bus }) {
     (patch) => {
       persistence.patchUserPrefs(patch);
       transport.saveUserPrefs(persistence.loadUserPrefs()).catch((err) => {
-        log16.warn("saveUserPrefs failed", { err });
+        log17.warn("saveUserPrefs failed", { err });
       });
     },
     [persistence, transport]
@@ -6605,7 +6730,7 @@ function App({ options, hostElement, bus }) {
           values: rec.values
         }));
       } catch (err) {
-        log16.debug("bootstrap failed \u2014 no form markers (non-fatal)", { err });
+        log17.debug("bootstrap failed \u2014 no form markers (non-fatal)", { err });
         return [];
       }
     },
@@ -6645,7 +6770,7 @@ function App({ options, hostElement, bus }) {
         }
       } catch (err) {
         if (isStale()) return;
-        log16.warn("loadThread failed; resetting conversationId", { err, conversationId });
+        log17.warn("loadThread failed; resetting conversationId", { err, conversationId });
         conversationIdSig.value = void 0;
         persistence.saveConversationId(void 0);
       } finally {
@@ -6670,7 +6795,10 @@ function App({ options, hostElement, bus }) {
           visitorId,
           conversationId,
           userPrefs: persistence.loadUserPrefs(),
-          locale: options.locale
+          // The visitor's ACTIVE locale (persisted pick, else auto-detected) —
+          // not the config baseline — so the handshake learns what the visitor
+          // wants. The response's availableLocales then clamps it for the rest.
+          locale: activeLocale
         });
       } catch (err) {
         if (isStale()) return;
@@ -6681,7 +6809,7 @@ function App({ options, hostElement, bus }) {
       }
       if (isStale()) return;
       if (res.visitorId && res.visitorId !== visitorId) {
-        log16.info("visitor rebound", { previous: visitorId, current: res.visitorId, reason: res.rebind?.visitorId });
+        log17.info("visitor rebound", { previous: visitorId, current: res.visitorId, reason: res.rebind?.visitorId });
         persistence.setVisitorId(res.visitorId);
         setVisitorId(res.visitorId);
         bus.emit("visitorRebound", {
@@ -6691,7 +6819,7 @@ function App({ options, hostElement, bus }) {
         });
       }
       if (res.conversationId && res.conversationId !== conversationId) {
-        log16.info("conversation rebound", {
+        log17.info("conversation rebound", {
           previous: conversationId,
           current: res.conversationId,
           reason: res.rebind?.conversationId
@@ -6706,9 +6834,9 @@ function App({ options, hostElement, bus }) {
       if (res.welcome?.suggestions) setSuggestions(res.welcome.suggestions);
       if (options.mode === "page") {
         if (res.site && isSiteConfigShape(res.site)) setParsedSite(res.site);
-        else if (res.site) log16.warn("invalid site config, using fallback", { site: res.site });
+        else if (res.site) log17.warn("invalid site config, using fallback", { site: res.site });
         if (res.blocks && isBlocksConfigShape(res.blocks)) setParsedBlocks(res.blocks);
-        else if (res.blocks) log16.warn("invalid blocks config, using fallback", { blocks: res.blocks });
+        else if (res.blocks) log17.warn("invalid blocks config, using fallback", { blocks: res.blocks });
       }
       if (res.userPrefs && !newConversation) {
         persistence.saveUserPrefs(res.userPrefs);
@@ -6732,7 +6860,18 @@ function App({ options, hostElement, bus }) {
         setConversationReady(true);
       }
     },
-    [transport, visitorId, persistence, options, bus, conversationIdSig, feedback, playWelcome, loadThread]
+    [
+      transport,
+      visitorId,
+      persistence,
+      options,
+      bus,
+      conversationIdSig,
+      feedback,
+      playWelcome,
+      loadThread,
+      activeLocale
+    ]
   );
   const userSig = JSON.stringify(options.userContext ?? null);
   const pageSig = JSON.stringify(options.pageContext ?? null);
@@ -6741,6 +6880,13 @@ function App({ options, hostElement, bus }) {
     const merged = Object.keys(formContext).length ? { ...formContext, ...options.userContext } : options.userContext;
     transport.setContext(merged, toWirePageContext(options.pageContext));
   }, [transport, userSig, pageSig, formCtxSig]);
+  const effectiveLocale = clampLocale(activeLocale, options.availableLocales, options.defaultLocale);
+  useEffect17(() => {
+    transport.setLocale(effectiveLocale);
+  }, [transport, effectiveLocale]);
+  useEffect17(() => {
+    if (effectiveLocale !== activeLocale) setActiveLocale(effectiveLocale);
+  }, [effectiveLocale, activeLocale]);
   const runResume = useCallback6(
     async (handle) => {
       let bubble = null;
@@ -6756,7 +6902,7 @@ function App({ options, hostElement, bus }) {
             resumeActiveRef.current = true;
             const chatTab = chatTabIdRef.current;
             if (chatTab) homeNav.switchTab(chatTab);
-            log16.info("resumed in-flight reply on mount");
+            log17.info("resumed in-flight reply on mount");
           }
           reducer.apply(evt.chunk);
           if (evt.chunk.type === "finish" && evt.chunk.canContinue === false) setCanSend(false);
@@ -6772,7 +6918,7 @@ function App({ options, hostElement, bus }) {
           bubble.errorText = errorMessageFor(err, options.strings);
           feedback.play("error");
         }
-        log16.debug("mount resume ended without completing", { err });
+        log17.debug("mount resume ended without completing", { err });
       } finally {
         resumeBubbleRef.current = null;
         if (bubble) {
@@ -6803,7 +6949,7 @@ function App({ options, hostElement, bus }) {
         const res = await dataBootRef.current;
         setRemoteForms(resolveForms((res ?? { forms: [] }).forms));
       } catch (err) {
-        log16.debug("bootstrap failed \u2014 treating as no forms", { err });
+        log17.debug("bootstrap failed \u2014 treating as no forms", { err });
       } finally {
         setFormsReady(true);
       }
@@ -6903,7 +7049,7 @@ function App({ options, hostElement, bus }) {
         (pt) => pt.kind === "tool" && pt.toolCallId === toolCallId
       );
       if (!part) {
-        log16.warn("resolveTool: tool part not found", { toolCallId });
+        log17.warn("resolveTool: tool part not found", { toolCallId });
         return;
       }
       mutate(part);
@@ -6917,7 +7063,7 @@ function App({ options, hostElement, bus }) {
   );
   const handleToolResult = useCallback6(
     (toolCallId, output) => {
-      log16.info("toolResult", { toolCallId });
+      log17.info("toolResult", { toolCallId });
       bus.emit("toolResult", { toolCallId });
       resolveTool(toolCallId, TRIGGER.toolResult, (part) => {
         part.outputSig.value = output;
@@ -6928,7 +7074,7 @@ function App({ options, hostElement, bus }) {
   );
   const handleToolDecision = useCallback6(
     (toolCallId, approved, reason) => {
-      log16.info("toolDecision", { toolCallId, approved });
+      log17.info("toolDecision", { toolCallId, approved });
       bus.emit("toolDecision", { toolCallId, approved });
       resolveTool(toolCallId, TRIGGER.toolApproval, (part) => {
         const id = part.approvalSig.value?.id ?? toolCallId;
@@ -6952,7 +7098,7 @@ function App({ options, hostElement, bus }) {
     pageArea: () => options.pageContext?.area ? String(options.pageContext.area) : void 0,
     conversationId: () => conversationIdSig.value,
     onComplete: (form, trigger, values, skipped) => {
-      log16.info("formSubmit", { formId: form.id, trigger, skipped });
+      log17.info("formSubmit", { formId: form.id, trigger, skipped });
       bus.emit("formSubmit", { formId: form.id, values, skipped });
       setFormMarkers((prev) => [
         ...prev.filter((m) => !(m.formId === form.id && m.outcome === "skipped")),
@@ -6997,12 +7143,12 @@ function App({ options, hostElement, bus }) {
   }, [idleMs, isOpen, forms, msgCount.value]);
   const handleSend = useCallback6(
     async (text, attachments) => {
-      log16.info("send", { textLen: text.length, attachments: attachments.length, streaming });
+      log17.info("send", { textLen: text.length, attachments: attachments.length, streaming });
       if (streaming) return;
       bus.emit("send", { text, attachmentCount: attachments.length });
       if (suggestions.length > 0) setSuggestions([]);
       const uploaded = await uploadAttachments(transport, attachments, (err) => {
-        log16.warn("upload failed", { err });
+        log17.warn("upload failed", { err });
         bus.emit("error", err);
         options.onError?.(err);
       });
@@ -7019,24 +7165,24 @@ function App({ options, hostElement, bus }) {
     [streaming, transport, bus, options, suggestions.length, messagesSig, reducer, streamAssistant, forms]
   );
   const handleStop = useCallback6(() => {
-    log16.info("stop");
+    log17.info("stop");
     bus.emit("stop", void 0);
     activeCancel?.();
   }, [activeCancel, bus]);
   const handleSoundToggle = useCallback6(() => {
     feedback.toggleMuted();
     const muted = feedback.mutedSig.value;
-    log16.info("soundToggle", { muted });
+    log17.info("soundToggle", { muted });
     bus.emit("soundToggle", { muted });
   }, [feedback, bus]);
   const handleClose = useCallback6(() => {
     if (resolveCloseAction(options.mode, panelSize) === "exit-fullscreen") {
-      log16.info("close \u2192 exit-fullscreen", { mode: options.mode });
+      log17.info("close \u2192 exit-fullscreen", { mode: options.mode });
       setPanelSize("normal");
       bus.emit("fullscreen", false);
       return;
     }
-    log16.info("close \u2192 panel closed", { mode: options.mode });
+    log17.info("close \u2192 panel closed", { mode: options.mode });
     forms.fire("panel-close");
     setIsOpen(false);
     persistence.savePanelOpen(false);
@@ -7047,7 +7193,7 @@ function App({ options, hostElement, bus }) {
     if (!options.modules.list.some((m) => m.layout === "chat")) return;
     transport.listConversations({ limit: 50 }).then((res) => {
       unreadCountSig.value = res.conversations.reduce((sum, c) => sum + (c.unreadCount ?? 0), 0);
-    }).catch((err) => log16.debug("refreshUnread failed (non-fatal)", { err }));
+    }).catch((err) => log17.debug("refreshUnread failed (non-fatal)", { err }));
   }, [transport, options.modules, unreadCountSig]);
   const unreadSeeded = useRef9(false);
   useEffect17(() => {
@@ -7056,7 +7202,7 @@ function App({ options, hostElement, bus }) {
     refreshUnread();
   }, [activated, conversationReady, refreshUnread]);
   const handleOpen = useCallback6(() => {
-    log16.info("open", { mode: options.mode });
+    log17.info("open", { mode: options.mode });
     feedback.unlock();
     setLauncherLeaving(true);
     setIsOpen(true);
@@ -7070,11 +7216,11 @@ function App({ options, hostElement, bus }) {
   const handleClear = useCallback6(() => {
     const hasUserMessages = messagesSig.value.some((m) => m.role === "user");
     if (!hasUserMessages && canSend && conversationIdSig.value) {
-      log16.info("clear \u2192 reusing empty conversation", { conversationId: conversationIdSig.value });
+      log17.info("clear \u2192 reusing empty conversation", { conversationId: conversationIdSig.value });
       if (messagesSig.value.length === 0) playWelcome(welcomeRef.current?.messages);
       return;
     }
-    log16.info("clear \u2192 new conversation", { wasStreaming: streaming });
+    log17.info("clear \u2192 new conversation", { wasStreaming: streaming });
     bus.emit("clear", void 0);
     if (streaming) activeCancel?.();
     messagesSig.value = [];
@@ -7092,14 +7238,14 @@ function App({ options, hostElement, bus }) {
   }, [handleClear, homeNav, options]);
   const handleExpand = useCallback6(() => {
     const nextSize = panelSize === "expanded" ? "normal" : "expanded";
-    log16.info("expand", { from: panelSize, expanded: nextSize === "expanded" });
+    log17.info("expand", { from: panelSize, expanded: nextSize === "expanded" });
     setPanelSize(nextSize);
     persistence.savePanelSize(nextSize);
     bus.emit("expand", nextSize === "expanded");
   }, [bus, panelSize, persistence]);
   const handleFullscreen = useCallback6(() => {
     const nextSize = panelSize === "fullscreen" ? "normal" : "fullscreen";
-    log16.info("fullscreen", { from: panelSize, fullscreen: nextSize === "fullscreen" });
+    log17.info("fullscreen", { from: panelSize, fullscreen: nextSize === "fullscreen" });
     setPanelSize(nextSize);
     persistence.savePanelSize(nextSize);
     bus.emit("fullscreen", nextSize === "fullscreen");
@@ -7109,21 +7255,21 @@ function App({ options, hostElement, bus }) {
     const url = new URL(options.popOutUrl);
     if (conversationIdSig.value) url.searchParams.set("conversation", conversationIdSig.value);
     if (options.widgetId !== "default") url.searchParams.set("widgetId", options.widgetId);
-    log16.info("popOut", { url: url.toString() });
+    log17.info("popOut", { url: url.toString() });
     window.open(url.toString(), "_blank", "noopener,noreferrer");
     bus.emit("popOut", void 0);
   }, [bus, conversationIdSig, options.popOutUrl, options.widgetId]);
   const handleToggleHistory = useCallback6(() => {
     setView((v) => {
       const next = v === "history" ? "chat" : "history";
-      log16.info("toggleHistory", { view: next });
+      log17.info("toggleHistory", { view: next });
       bus.emit("toggleHistory", { view: next });
       return next;
     });
   }, [bus]);
   const handleLocaleChange = useCallback6(
     (locale) => {
-      log16.info("localeChange", { locale });
+      log17.info("localeChange", { locale });
       setActiveLocale(locale);
       patchAndSync({ locale });
       bus.emit("localeChange", locale);
@@ -7132,7 +7278,7 @@ function App({ options, hostElement, bus }) {
   );
   const handleThemeChange = useCallback6(
     (mode) => {
-      log16.info("themeChange", { mode });
+      log17.info("themeChange", { mode });
       setActiveThemeMode(mode);
       hostElement.dataset.theme = mode;
       patchAndSync({ themeMode: mode });
@@ -7142,7 +7288,7 @@ function App({ options, hostElement, bus }) {
   );
   const handleTextSizeChange = useCallback6(
     (size) => {
-      log16.info("textSizeChange", { size });
+      log17.info("textSizeChange", { size });
       setActiveTextSize(size);
       hostElement.dataset.textSize = size;
       patchAndSync({ textSize: size });
@@ -7153,7 +7299,7 @@ function App({ options, hostElement, bus }) {
   const handleToggleSidebarCollapsed = useCallback6(() => {
     setSidebarCollapsed((prev) => {
       const next = !prev;
-      log16.info("sidebarToggle", { collapsed: next });
+      log17.info("sidebarToggle", { collapsed: next });
       persistence.saveSidebarCollapsed(next);
       bus.emit("sidebarToggle", { collapsed: next });
       return next;
@@ -7161,7 +7307,7 @@ function App({ options, hostElement, bus }) {
   }, [persistence, bus]);
   const handleWidgetSizeChange = useCallback6(
     (size) => {
-      log16.info("resize", size);
+      log17.info("resize", size);
       patchAndSync({ widgetSize: size });
       bus.emit("resize", size);
     },
@@ -7169,7 +7315,7 @@ function App({ options, hostElement, bus }) {
   );
   const handleSelectHistoryConversation = useCallback6(
     async (targetConversationId) => {
-      log16.info("selectConversation", { conversationId: targetConversationId });
+      log17.info("selectConversation", { conversationId: targetConversationId });
       bus.emit("selectConversation", { conversationId: targetConversationId });
       try {
         const [res, markers] = await Promise.all([
@@ -7271,7 +7417,7 @@ function App({ options, hostElement, bus }) {
     onStop: handleStop,
     onSuggestion: (s) => {
       const text = s.text ?? s.label;
-      log16.info("suggestion", { text });
+      log17.info("suggestion", { text });
       bus.emit("suggestion", { text });
       void handleSend(text, []);
     },
@@ -7393,14 +7539,14 @@ function emitMessage(bus, options, role, text) {
 
 // src/ui/error-boundary.tsx
 import { Component } from "preact";
-var log17 = logger.scope("error-boundary");
+var log18 = logger.scope("error-boundary");
 var ErrorBoundary = class extends Component {
   constructor() {
     super(...arguments);
     __publicField(this, "state", { crashed: false });
   }
   componentDidCatch(error, info) {
-    log17.error("widget render crashed", { error, componentStack: info?.componentStack });
+    log18.error("widget render crashed", { error, componentStack: info?.componentStack });
     this.setState({ crashed: true });
     this.props.onError(error, info?.componentStack);
   }
@@ -7409,102 +7555,6 @@ var ErrorBoundary = class extends Component {
   }
 };
 
-// src/shadow/iframe-mount.ts
-var log18 = logger.scope("iframe");
-var IFRAME_SRCDOC = '<!doctype html><html><head><meta charset="utf-8"><style>html,body{margin:0;padding:0;background:transparent;overflow:hidden}</style></head><body></body></html>';
-function createIframeMount(opts, position, initialMode = "closed", layoutMode = "floating", target = null) {
-  log18.debug("createIframeMount", { position, initialMode, layoutMode, hasTarget: !!target });
-  const iframe = document.createElement("iframe");
-  iframe.title = `${BRAND.name} chat`;
-  iframe.setAttribute("allow", "microphone; clipboard-write");
-  sizeIframe(iframe, position, initialMode, layoutMode);
-  const parent = layoutMode === "inline" && target ? target : document.body;
-  parent.appendChild(iframe);
-  const doc = iframe.contentDocument;
-  if (!doc) throw new Error("iframe contentDocument unavailable (cross-origin?)");
-  doc.open();
-  doc.write(IFRAME_SRCDOC);
-  doc.close();
-  const mount2 = createShadowMount({ ...opts, target: doc.body });
-  const mo = new MutationObserver(() => {
-    sizeIframe(iframe, position, mount2.hostElement.dataset.mode ?? "closed", layoutMode);
-  });
-  mo.observe(mount2.hostElement, { attributes: true, attributeFilter: ["data-mode"] });
-  return {
-    ...mount2,
-    iframeElement: iframe,
-    destroy() {
-      mo.disconnect();
-      mount2.destroy();
-      iframe.remove();
-    }
-  };
-}
-var BASE_CSS = "border:0;background:transparent;z-index:2147483647;pointer-events:auto;";
-var FLOATING_SIZE_BY_MODE = {
-  closed: { w: "88px", h: "88px" },
-  expanded: { w: "min(calc(100vw - 32px), 680px)", h: "min(calc(100vh - 32px), 860px)" },
-  // `open` (normal) — also the fallback for any other non-fullscreen state.
-  open: { w: "min(calc(100vw - 32px), 440px)", h: "min(calc(100vh - 32px), 700px)" }
-};
-function sizeIframe(iframe, position, mode, layoutMode) {
-  if (mode === "fullscreen" || layoutMode === "standalone") {
-    iframe.style.cssText = `${BASE_CSS}position:fixed;inset:0;width:100vw;height:100vh;`;
-    return;
-  }
-  if (layoutMode === "inline") {
-    iframe.style.cssText = `${BASE_CSS}position:static;display:block;width:100%;height:100%;`;
-    return;
-  }
-  const compact = typeof matchMedia === "function" && matchMedia("(max-width: 640px)").matches;
-  if (compact && (mode === "open" || mode === "expanded")) {
-    iframe.style.cssText = `${BASE_CSS}position:fixed;inset:0;width:100vw;height:100vh;`;
-    return;
-  }
-  const vKey = position.startsWith("top-") ? "top" : "bottom";
-  const hKey = position.endsWith("-left") ? "left" : "right";
-  const { w, h: h2 } = FLOATING_SIZE_BY_MODE[mode] ?? FLOATING_SIZE_BY_MODE.open;
-  iframe.style.cssText = `${BASE_CSS}position:fixed;${vKey}:16px;${hKey}:16px;width:${w};height:${h2};`;
-}
-
-// src/core/events.ts
-var EventBus = class {
-  constructor() {
-    __publicField(this, "handlers", /* @__PURE__ */ new Map());
-  }
-  /**
-   * Register a listener for `name`.
-   * @returns an `off` function that removes this listener.
-   */
-  on(name, fn) {
-    let set = this.handlers.get(name);
-    if (!set) {
-      set = /* @__PURE__ */ new Set();
-      this.handlers.set(name, set);
-    }
-    set.add(fn);
-    return () => this.handlers.get(name)?.delete(fn);
-  }
-  /**
-   * Dispatch an event synchronously to all listeners.
-   * Listener errors are swallowed — the widget must not crash on user callbacks.
-   */
-  emit(name, payload) {
-    const set = this.handlers.get(name);
-    if (!set) return;
-    for (const fn of set) {
-      try {
-        fn(payload);
-      } catch {
-      }
-    }
-  }
-  /** Remove every listener. Called by the instance `destroy()`. */
-  clear() {
-    this.handlers.clear();
-  }
-};
-
 // src/core/tracking.ts
 var PROTOCOL_VERSION = "1";
 var MAX_HITS_PER_MINUTE = 60;
@@ -7620,6 +7670,73 @@ function createTracker(bus, deps) {
   };
 }
 
+// src/core/boot.ts
+function createWidgetRuntime(params) {
+  const { bus, host, appRoot, persistence, reportError } = params;
+  let userRaw = params.initialRaw;
+  let serverConfig;
+  let currentOptions = resolveOptions(userRaw);
+  let firstRender = true;
+  const recompute = () => {
+    currentOptions = resolveOptions(serverConfig ? mergeServerConfig(userRaw, serverConfig) : userRaw);
+  };
+  const applyHostStyling = () => {
+    applyHostPosition(host, hostPositionForMode(currentOptions.mode));
+    const cachedThemeMode = persistence.loadUserPrefs().themeMode;
+    applyHostAttributes(host, cachedThemeMode ? { ...currentOptions, themeMode: cachedThemeMode } : currentOptions);
+    if (firstRender) {
+      applyMode(host, resolveInitialHostMode(currentOptions));
+      firstRender = false;
+    }
+  };
+  const render2 = () => {
+    applyHostStyling();
+    renderPreact(
+      h(ErrorBoundary, { onError: reportError }, h(App, { bus, hostElement: host, options: currentOptions })),
+      appRoot
+    );
+  };
+  bus.on("handshake", (response) => {
+    if (!response.config) return;
+    serverConfig = response.config;
+    recompute();
+    render2();
+  });
+  const untrack = createTracker(bus, {
+    getOptions: () => currentOptions,
+    getVisitorId: () => persistence.getVisitorId(),
+    getConversationId: () => persistence.loadConversationId()
+  });
+  return {
+    getOptions: () => currentOptions,
+    getUserOptions: () => userRaw,
+    render: render2,
+    setUserOptions: (raw) => {
+      userRaw = raw;
+      recompute();
+      render2();
+    },
+    patchUserOptions: (patch) => {
+      userRaw = { ...userRaw, ...patch };
+      recompute();
+      render2();
+    },
+    destroy: () => untrack()
+  };
+}
+function resolveInitialHostMode(options) {
+  if (options.mode === "standalone") return "standalone";
+  if (options.mode === "inline") return "inline";
+  const persistence = createPersistence(options.widgetId, options.storage);
+  const { panelOpen, panelSize } = resolveInitialPanelState(
+    options,
+    currentViewportWidth(),
+    persistence.loadPanelOpen(),
+    persistence.loadPanelSize()
+  );
+  return computeHostMode(options.mode, panelSize, panelOpen);
+}
+
 // src/core/hooks.ts
 var log19 = logger.scope("hooks");
 var HOOK_WILDCARD = "*";
@@ -7705,73 +7822,45 @@ function mount(opts) {
   if (opts.debug !== void 0) setLogLevel(opts.debug);
   const log20 = logger.scope("mount");
   log20.info("mount", { widgetId: opts.widgetId, publicKey: opts.publicKey, mode: opts.presentation?.mode });
-  let rawOptions = opts;
-  let currentOptions = resolveOptions(rawOptions);
-  const widgetId = currentOptions.widgetId;
+  const resolved = resolveOptions(opts);
+  const widgetId = resolved.widgetId;
   const existing = instances.get(widgetId);
   if (existing) {
     log20.debug("destroy existing instance at slot", { widgetId });
     existing.destroy();
   }
-  const initialHostMode = resolveInitialHostMode(currentOptions);
-  const mountResult = currentOptions.iframe ? createIframeMount(
-    { position: hostPositionForMode(currentOptions.mode) },
-    currentOptions.position,
+  const initialHostMode = resolveInitialHostMode(resolved);
+  const mountResult = resolved.iframe ? createIframeMount(
+    { position: hostPositionForMode(resolved.mode) },
+    resolved.position,
     initialHostMode,
-    currentOptions.mode,
+    resolved.mode,
     opts.target ?? null
   ) : createShadowMount({
-    position: hostPositionForMode(currentOptions.mode),
+    position: hostPositionForMode(resolved.mode),
     target: opts.target ?? null
   });
-  const persistence = createPersistence(currentOptions.widgetId, currentOptions.storage);
-  const applyResolvedHostAttributes = () => {
-    const cachedThemeMode = persistence.loadUserPrefs().themeMode;
-    applyHostAttributes(
-      mountResult.hostElement,
-      cachedThemeMode ? { ...currentOptions, themeMode: cachedThemeMode } : currentOptions
-    );
-  };
-  applyResolvedHostAttributes();
-  applyMode(mountResult.hostElement, initialHostMode);
   mountResult.hostElement.dataset.widgetId = widgetId;
   const bus = new EventBus();
+  const persistence = createPersistence(widgetId, resolved.storage);
   const reportError = (error) => {
     bus.emit("error", error);
-    currentOptions.onError?.(error);
-  };
-  const renderApp = () => {
-    render(
-      h(
-        ErrorBoundary,
-        { onError: reportError },
-        h(App, { bus, hostElement: mountResult.hostElement, options: currentOptions })
-      ),
-      mountResult.appRoot
-    );
+    runtime.getOptions().onError?.(error);
   };
-  renderApp();
-  bus.on("handshake", (response) => {
-    if (!response.config) return;
-    rawOptions = mergeServerConfig(rawOptions, response.config);
-    currentOptions = resolveOptions(rawOptions);
-    applyHostPosition(mountResult.hostElement, hostPositionForMode(currentOptions.mode));
-    applyResolvedHostAttributes();
-    renderApp();
-  });
-  const unsubscribeTracker = createTracker(bus, {
-    getOptions: () => currentOptions,
-    getVisitorId: () => persistence.getVisitorId(),
-    getConversationId: () => persistence.loadConversationId()
+  const runtime = createWidgetRuntime({
+    bus,
+    host: mountResult.hostElement,
+    appRoot: mountResult.appRoot,
+    persistence,
+    initialRaw: opts,
+    reportError
   });
+  runtime.render();
   const host = mountResult.hostElement;
   let unsubscribeHooks = null;
   const applyUpdate = (patch) => {
     if (patch.debug !== void 0) setLogLevel(patch.debug);
-    rawOptions = { ...rawOptions, ...patch };
-    currentOptions = resolveOptions(rawOptions);
-    applyResolvedHostAttributes();
-    renderApp();
+    runtime.patchUserOptions(patch);
   };
   const instance = {
     widgetId,
@@ -7790,7 +7879,7 @@ function mount(opts) {
     // context; App re-handshakes with the SAME visitor/conversation.
     setUserContext: (userContext) => {
       log20.debug("setUserContext", { keys: Object.keys(userContext) });
-      applyUpdate({ userContext: { ...rawOptions.userContext, ...userContext } });
+      applyUpdate({ userContext: { ...runtime.getUserOptions().userContext, ...userContext } });
     },
     clearUserContext: () => {
       log20.debug("clearUserContext");
@@ -7798,7 +7887,7 @@ function mount(opts) {
     },
     setPageContext: (pageContext) => {
       log20.debug("setPageContext", { keys: Object.keys(pageContext) });
-      applyUpdate({ pageContext: { ...rawOptions.pageContext, ...pageContext } });
+      applyUpdate({ pageContext: { ...runtime.getUserOptions().pageContext, ...pageContext } });
     },
     clearPageContext: () => {
       log20.debug("clearPageContext");
@@ -7813,7 +7902,7 @@ function mount(opts) {
     destroy: () => {
       log20.info("destroy", { widgetId });
       unsubscribeHooks?.();
-      unsubscribeTracker();
+      runtime.destroy();
       bus.clear();
       render(null, mountResult.appRoot);
       mountResult.destroy();
@@ -7852,18 +7941,6 @@ function hook(widgetId, event, listener) {
 }
 var version = "0.1.0";
 var brand = BRAND;
-function resolveInitialHostMode(options) {
-  if (options.mode === "standalone") return "standalone";
-  if (options.mode === "inline") return "inline";
-  const persistence = createPersistence(options.widgetId, options.storage);
-  const { panelOpen, panelSize } = resolveInitialPanelState(
-    options,
-    currentViewportWidth(),
-    persistence.loadPanelOpen(),
-    persistence.loadPanelSize()
-  );
-  return computeHostMode(options.mode, panelSize, panelOpen);
-}
 export {
   HOOK_WILDCARD,
   brand,