@helpai/elements 0.36.1 → 0.37.0

package/index.d.ts

@@ -70,9 +70,10 @@ type StringsOverride = LocaleStrings | Partial<Record<string, LocaleStrings>>;
  *
  * Storage holds three things, each under its own key:
  *
- * 1. **`visitorId`** — anonymous browser-level identifier, minted once per
- *    widget instance and reused forever. Sent on every backend request so
- *    the server can attach per-visitor settings, history, etc.
+ * 1. **`visitorId`** — anonymous browser-level identifier, minted once and
+ *    reused forever. **Brand-global** (NOT scoped to widget/deployment): one
+ *    anonymous "who is this browser" id, shared across every widget + deployment
+ *    of this brand. Sent on every backend request.
  * 2. **`conversationId`** — the active conversation thread. The backend is the
  *    source of truth for messages; we store only the id and re-fetch on
  *    reload via `transport.loadConversation()`.
@@ -80,8 +81,13 @@ type StringsOverride = LocaleStrings | Partial<Record<string, LocaleStrings>>;
  *    sound mute). Cached locally for instant render-before-network, then
  *    reconciled with the server's copy on each `connect()`.
  *
- * Keys are namespaced as `${brand.cssPrefix}.${widgetId}.${field}` so two
- * widgets on the same brand keep their state cleanly separated.
+ * Everything EXCEPT `visitorId` is namespaced as
+ * `${brand.cssPrefix}.${widgetId}.${deploymentId}.${field}` (the deployment id
+ * is dropped when absent) so two widgets — or two AI agent deployments — keep
+ * their state cleanly separated; pointing a widget at a different
+ * `aiAgentDeploymentId` starts from fresh conversation / prefs / panel state.
+ * `visitorId` is the deliberate exception: it stays global so the same browser
+ * is one anonymous visitor everywhere (`${brand.cssPrefix}.visitorId`).
  *
  * Storage is pluggable via {@link ClientStorage} — pass a custom adapter
  * to add encryption, logging, or use a non-localStorage backend.

package/index.mjs

@@ -1025,9 +1025,10 @@ function fillRandom(view) {
 
 // src/core/persistence.ts
 var log2 = logger.scope("persistence");
-function createPersistence(widgetId, storage = defaultStorage) {
-  const prefix = `${BRAND.cssPrefix}.${widgetId}`;
-  const KEY_VISITOR = `${prefix}.visitorId`;
+function createPersistence(widgetId, storage = defaultStorage, deploymentId) {
+  const scope = deploymentId ? `${widgetId}.${deploymentId}` : widgetId;
+  const prefix = `${BRAND.cssPrefix}.${scope}`;
+  const KEY_VISITOR = `${BRAND.cssPrefix}.visitorId`;
   const KEY_CONVERSATION = `${prefix}.conversationId`;
   const KEY_USER_PREFS = `${prefix}.userPrefs`;
   const KEY_PANEL_OPEN = `${prefix}.panelOpen`;
@@ -1045,14 +1046,14 @@ function createPersistence(widgetId, storage = defaultStorage) {
       return minted;
     },
     setVisitorId(id) {
-      log2.debug("setVisitorId (rebind)", { id, widgetId });
+      log2.debug("setVisitorId (rebind)", { id, scope });
       storage.set(KEY_VISITOR, id);
     },
     loadConversationId() {
       return storage.get(KEY_CONVERSATION) ?? void 0;
     },
     saveConversationId(id) {
-      log2.trace("saveConversationId", { id, widgetId });
+      log2.trace("saveConversationId", { id, scope });
       if (id) storage.set(KEY_CONVERSATION, id);
       else storage.remove(KEY_CONVERSATION);
     },
@@ -4163,7 +4164,7 @@ function themeIcon(mode) {
   return /* @__PURE__ */ jsx9(ThemeAutoIcon, {});
 }
 function localeCode(locale) {
-  return (locale.split("-")[0] || locale).toUpperCase();
+  return (locale.split("-")[0] ?? locale).toUpperCase();
 }
 function HeaderActions({ panelProps, variant }) {
   const { options, panelSize, feedback, onClose, onClear, onExpand, onFullscreen, onPopOut, onSoundToggle } = panelProps;
@@ -6715,7 +6716,9 @@ import { jsx as jsx36, jsxs as jsxs31 } from "preact/jsx-runtime";
 var log17 = logger.scope("app");
 var p32 = BRAND.cssPrefix;
 function App({ options, hostElement, bus }) {
-  const [persistence] = useState13(() => createPersistence(options.widgetId, options.storage));
+  const [persistence] = useState13(
+    () => createPersistence(options.widgetId, options.storage, options.aiAgentDeploymentId)
+  );
   const [visitorId, setVisitorId] = useState13(() => persistence.getVisitorId());
   const initialSettings = persistence.loadUserPrefs();
   const [activeLocale, setActiveLocale] = useState13(() => initialSettings.locale ?? options.locale);
@@ -7903,7 +7906,7 @@ function createWidgetRuntime(params) {
 function resolveInitialHostMode(options) {
   if (options.mode === "standalone") return "standalone";
   if (options.mode === "inline") return "inline";
-  const persistence = createPersistence(options.widgetId, options.storage);
+  const persistence = createPersistence(options.widgetId, options.storage, options.aiAgentDeploymentId);
   const { panelOpen, panelSize } = resolveInitialPanelState(
     options,
     currentViewportWidth(),
@@ -8018,7 +8021,7 @@ function mount(opts) {
   });
   mountResult.hostElement.dataset.widgetId = widgetId;
   const bus = new EventBus();
-  const persistence = createPersistence(widgetId, resolved.storage);
+  const persistence = createPersistence(widgetId, resolved.storage, resolved.aiAgentDeploymentId);
   const reportError = (error) => {
     bus.emit("error", error);
     runtime.getOptions().onError?.(error);

package/package.json

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

package/web-component.mjs

@@ -1063,9 +1063,10 @@ function fillRandom(view) {
 
 // src/core/persistence.ts
 var log2 = logger.scope("persistence");
-function createPersistence(widgetId, storage = defaultStorage) {
-  const prefix = `${BRAND.cssPrefix}.${widgetId}`;
-  const KEY_VISITOR = `${prefix}.visitorId`;
+function createPersistence(widgetId, storage = defaultStorage, deploymentId) {
+  const scope = deploymentId ? `${widgetId}.${deploymentId}` : widgetId;
+  const prefix = `${BRAND.cssPrefix}.${scope}`;
+  const KEY_VISITOR = `${BRAND.cssPrefix}.visitorId`;
   const KEY_CONVERSATION = `${prefix}.conversationId`;
   const KEY_USER_PREFS = `${prefix}.userPrefs`;
   const KEY_PANEL_OPEN = `${prefix}.panelOpen`;
@@ -1083,14 +1084,14 @@ function createPersistence(widgetId, storage = defaultStorage) {
       return minted;
     },
     setVisitorId(id) {
-      log2.debug("setVisitorId (rebind)", { id, widgetId });
+      log2.debug("setVisitorId (rebind)", { id, scope });
       storage.set(KEY_VISITOR, id);
     },
     loadConversationId() {
       return storage.get(KEY_CONVERSATION) ?? void 0;
     },
     saveConversationId(id) {
-      log2.trace("saveConversationId", { id, widgetId });
+      log2.trace("saveConversationId", { id, scope });
       if (id) storage.set(KEY_CONVERSATION, id);
       else storage.remove(KEY_CONVERSATION);
     },
@@ -4122,7 +4123,7 @@ function themeIcon(mode) {
   return /* @__PURE__ */ jsx9(ThemeAutoIcon, {});
 }
 function localeCode(locale) {
-  return (locale.split("-")[0] || locale).toUpperCase();
+  return (locale.split("-")[0] ?? locale).toUpperCase();
 }
 function HeaderActions({ panelProps, variant }) {
   const { options, panelSize, feedback, onClose, onClear, onExpand, onFullscreen, onPopOut, onSoundToggle } = panelProps;
@@ -6674,7 +6675,9 @@ import { jsx as jsx36, jsxs as jsxs31 } from "preact/jsx-runtime";
 var log16 = logger.scope("app");
 var p32 = BRAND.cssPrefix;
 function App({ options, hostElement, bus }) {
-  const [persistence] = useState13(() => createPersistence(options.widgetId, options.storage));
+  const [persistence] = useState13(
+    () => createPersistence(options.widgetId, options.storage, options.aiAgentDeploymentId)
+  );
   const [visitorId, setVisitorId] = useState13(() => persistence.getVisitorId());
   const initialSettings = persistence.loadUserPrefs();
   const [activeLocale, setActiveLocale] = useState13(() => initialSettings.locale ?? options.locale);
@@ -7862,7 +7865,7 @@ function createWidgetRuntime(params) {
 function resolveInitialHostMode(options) {
   if (options.mode === "standalone") return "standalone";
   if (options.mode === "inline") return "inline";
-  const persistence = createPersistence(options.widgetId, options.storage);
+  const persistence = createPersistence(options.widgetId, options.storage, options.aiAgentDeploymentId);
   const { panelOpen, panelSize } = resolveInitialPanelState(
     options,
     currentViewportWidth(),
@@ -7948,7 +7951,7 @@ var ChatElement = class extends HTMLElement {
         position: hostPositionForMode(resolved.mode)
       });
     }
-    const persistence = createPersistence(resolved.widgetId, resolved.storage);
+    const persistence = createPersistence(resolved.widgetId, resolved.storage, resolved.aiAgentDeploymentId);
     this.runtime = createWidgetRuntime({
       bus: this.bus,
       host: this.mountResult.hostElement,