@alxxsck/ai-assistant 2.17.0 → 2.20.0

package/README.md

@@ -135,6 +135,13 @@ const widget = new ChatWidgetInstance({
 No event subscription or listener cleanup is required. Parallel renewal signals
 are debounced, and replacing the session cancels a pending duplicate callback.
 
+Scenario interaction observations never cross an `interactionSessionId`
+boundary. A token replacement for the same session retries the same observation
+IDs. Canonical renewal creates a new interaction session, so any unsent queue
+owned by the previous session is discarded and sequencing starts again. This is
+an intentional principal-isolation rule: old observations are never reauthenticated
+with a new session token.
+
 ## Support identities and avatars
 
 Version 2.12.0 understands Support Presentations contract v1. Message bubbles use
@@ -219,16 +226,34 @@ const widget = new ChatWidgetInstance({
   handlers: {
     openPage: ({ route }) => productRouter.push(route),
     openModal: ({ modalName }) => productModals.open(modalName),
-    highlight: ({ element, active }) => {
+    highlight: ({ element, active, reportActivation }) => {
       element?.classList.toggle("lola-highlight", active);
+      productHighlights.setAction(
+        element,
+        active
+          ? () => {
+              reportActivation();
+              productActions.openDeposit();
+            }
+          : null,
+      );
     },
   },
 });
 ```
 
+`reportActivation()` is the authoritative signal that the product accepted the
+user activation. Call it synchronously from the product-owned action handler,
+before navigation can unmount the widget. It records the activation, not the
+result of the product action. The attributed target remains observable until its
+highlight is removed or replaced, including after the Scenario closes the chat.
+The SDK observes target visibility, but never treats arbitrary host DOM clicks as
+activation. Existing highlight handlers may ignore this callback.
+
 Page and modal targets arrive in canonical Lola command envelopes. The built-in
-element fallback resolves stable `[data-lola="..."]` attributes. CTA display,
-chat open/close, speech, voice conversations, and avatar animation stay internal.
+element fallback resolves stable `[data-lola="..."]` attributes and reports only
+visibility because it does not own the product action. CTA display, chat
+open/close, speech, voice conversations, and avatar animation stay internal.
 
 Command lifecycle events are available as `command_received`,
 `command_succeeded`, `command_failed`, `command_expired`, and

package/dist/App.d.ts

@@ -3,6 +3,7 @@ import type { ExternallyAvailableActions } from "./avatar/Avatar";
 import type { WidgetConfig } from "./index.types";
 import type { CustomerInteractionSession } from "./types";
 import type { CommandRuntime } from "./domain/command/CommandRuntime";
+import type { ScenarioInteractionRuntime } from "./domain/scenario-interaction/ScenarioInteractionRuntime";
 export type AppApi = {
     onAvatarLoadStarted: () => {
         onAvatarReady: OnAvatarReady;
@@ -17,6 +18,7 @@ export type AppApi = {
     registerSetSession: (fn: ((session: CustomerInteractionSession) => void) | null) => void;
     registerSetLocale: (fn: ((locale: string) => void) | null) => void;
     commandRuntime: CommandRuntime;
+    scenarioInteractionRuntime: ScenarioInteractionRuntime;
 };
 type AppProps = {
     config: WidgetConfig;

package/dist/{Avatar-BfX6RMhc.js → Avatar-CVZ2cJ7u.js}

@@ -1,4 +1,4 @@
-import { $ as $s } from "./index-C9sJVi7P.js";
+import { a1 as $s } from "./index-BVQY-1rm.js";
 var Fr = typeof globalThis < "u" ? globalThis : typeof window < "u" ? window : typeof global < "u" ? global : typeof self < "u" ? self : {};
 const Ul = "182", Hf = 0, bc = 1, Wf = 2, js = 1, Ku = 2, Gr = 3, di = 0, jt = 1, Zn = 2, $n = 0, ur = 1, Ac = 2, Ec = 3, wc = 4, Xf = 5, Ci = 100, qf = 101, Yf = 102, Kf = 103, Zf = 104, $f = 200, jf = 201, Jf = 202, Qf = 203, wo = 204, Ro = 205, ed = 206, td = 207, nd = 208, id = 209, rd = 210, sd = 211, ad = 212, od = 213, ld = 214, Co = 0, Po = 1, Io = 2, dr = 3, Do = 4, Lo = 5, Fo = 6, Uo = 7, xa = 0, cd = 1, ud = 2, Un = 0, Zu = 1, $u = 2, ju = 3, Ju = 4, Qu = 5, eh = 6, th = 7, Rc = "attached", hd = "detached", nh = 300, Oi = 301, pr = 302, aa = 303, No = 304, ya = 306, wt = 1e3, En = 1001, Oo = 1002, Lt = 1003, fd = 1004, Ss = 1005, kt = 1006, La = 1007, Ii = 1008, sn = 1009, ih = 1010, rh = 1011, ts = 1012, Nl = 1013, Bn = 1014, wn = 1015, Jn = 1016, Ol = 1017, Bl = 1018, ns = 1020, sh = 35902, ah = 35899, oh = 1021, lh = 1022, mn = 1023, Qn = 1026, Di = 1027, ch = 1028, kl = 1029, mr = 1030, Vl = 1031, zl = 1033, Js = 33776, Qs = 33777, ea = 33778, ta = 33779, Bo = 35840, ko = 35841, Vo = 35842, zo = 35843, Go = 36196, Ho = 37492, Wo = 37496, Xo = 37488, qo = 37489, Yo = 37490, Ko = 37491, Zo = 37808, $o = 37809, jo = 37810, Jo = 37811, Qo = 37812, el = 37813, tl = 37814, nl = 37815, il = 37816, rl = 37817, sl = 37818, al = 37819, ol = 37820, ll = 37821, cl = 36492, ul = 36494, hl = 36495, fl = 36283, dl = 36284, pl = 36285, ml = 36286, uh = 2200, dd = 2201, pd = 2202, oa = 2300, _l = 2301, Fa = 2302, sr = 2400, ar = 2401, la = 2402, Gl = 2500, md = 2501, _d = 3200, Sa = 0, gd = 1, ci = "", Ue = "srgb", _r = "srgb-linear", ca = "linear", nt = "srgb", Gi = 7680, Cc = 519, vd = 512, xd = 513, yd = 514, Hl = 515, Sd = 516, Md = 517, Wl = 518, Td = 519, Pc = 35044, Ic = "300 es", Fn = 2e3, ua = 2001;
 function hh(s) {