@alxxsck/ai-assistant 2.22.3 → 2.24.0

package/README.md

@@ -89,6 +89,33 @@ latest requested state is applied when the UI is ready. Session replacement upda
 authenticated HTTP, realtime, message, voice, and command dependencies without
 recreating the public widget instance.
 
+## Compact scenario preview
+
+Compact scenario previews are opt-in. Provide a stable, non-empty namespace that
+identifies the host project and widget placement:
+
+```ts
+const widget = new ChatWidgetInstance({
+  customerInteractionSession: session,
+  compactScenarioPreview: {
+    enabled: true,
+    storageNamespace: "casino-web/lola-main",
+  },
+});
+```
+
+The namespace scopes the persisted launcher dock and panel geometry, so two
+widgets on the same origin never inherit each other's placement. TypeScript
+requires it when the feature is enabled; JavaScript callers that omit it or pass
+only whitespace still get the preview, but layout persistence is disabled. With
+the option omitted or `enabled: false`, scenario messages retain their existing
+in-chat behavior and the legacy origin-wide layout persistence remains unchanged.
+When compact preview is first enabled, the first stable namespace on the origin
+claims and copies the legacy layout once; other namespaces start from defaults.
+The synchronous migration marker is deterministic within one document and
+best-effort if separate tabs initialize different namespaces at exactly the same
+time; persisted scoped layouts remain isolated in either case.
+
 ## Localization
 
 Pass the product's current locale directly to the widget. English is used when
@@ -186,32 +213,43 @@ Closing a hidden-launcher widget leaves it non-interactive until the product cal
 
 ## Attachments
 
-The composer is opt-in. Enable it with one option; without a transport it uses a
-local mock for visual QA and staged integration. The mock supports image previews,
-document cards, retry UI and downloads, but is never durable storage.
+Attachment support is enabled by default and uses Lola Backend's
+quarantine-and-scan pipeline. The picker and drag-and-drop target appear only when
+the current server-authoritative responder presentation is `CURRENT` and human
+support is `ASSIGNED`; they stay unavailable before a current human-support
+assignment exists, including `NONE` and `ROUTING`. If that assignment is released
+after a file was selected, the draft remains removable but is not sent while the
+assignment is absent. The SDK sends only attachments that reach `READY`; uploaded
+bytes never become durable message URLs. Set `attachments.enabled` to `false` only
+when embedding against a legacy backend.
 
 ```ts
 const widget = new ChatWidgetInstance({
   customerInteractionSession: session,
-  attachments: { enabled: true },
+  // Optional: attachments: { enabled: false },
 });
 ```
 
-For production, pass the signed-upload adapter owned by the product/backend. It
-returns a permanent attachment id and download URL. Enable `sendAttachmentIds`
-when the receiving endpoint has been rolled out; the SDK then includes the returned
-ids in the next message command and renders attachments from history and realtime
-frames.
+The default adapter hashes the file, creates an upload intent, streams the bytes to
+the presigned storage URL with progress, completes the upload, and waits for the
+malware scan. Download and image/PDF preview grants are fetched only when the user
+asks for them. Signed URLs are never retained in chat history.
+
+For controlled demos or tests, a custom transport can replace that adapter. READY
+attachment ids are sent by default; `sendAttachmentIds: false` is a temporary
+legacy-backend escape hatch.
 
 ```ts
 attachments: {
   enabled: true,
-  sendAttachmentIds: true, // enable once the receiving chat endpoint accepts them
+  sendAttachmentIds: true,
   transport: {
-    upload: async ({ file, onProgress, signal }) => {
+    upload: async ({ file, conversationId, onProgress, onStage, signal }) => {
       // Create an upload session, PUT the file, then complete it.
-      // Return { id, fileName, mediaType, size, kind, downloadUrl, previewUrl }.
+      // Return durable metadata: { id, fileName, mediaType, size, kind }.
     },
+    grant: async ({ attachmentId, conversationId }) => ({ url, expiresAt }),
+    revoke: async ({ attachmentId, conversationId }) => {},
   },
 }
 ```

package/dist/App.d.ts

@@ -1,3 +1,4 @@
+import { type CableServiceFactory } from "./domain/message/cable/CableContext";
 import type { OnAvatarReady } from "./types";
 import type { ExternallyAvailableActions } from "./avatar/Avatar";
 import type { WidgetConfig } from "./index.types";
@@ -24,5 +25,9 @@ type AppProps = {
     config: WidgetConfig;
     api: AppApi;
 };
+export declare function ChatWidgetCableProvider({ config, api, children, createCableService, }: AppProps & {
+    children: React.ReactNode;
+    createCableService?: CableServiceFactory;
+}): import("react/jsx-runtime").JSX.Element;
 export declare function App({ config, api }: AppProps): import("react/jsx-runtime").JSX.Element;
 export default App;

package/dist/{Avatar-QuPBAhUu.js → Avatar-C6dvOio6.js}

@@ -1,4 +1,4 @@
-import { a0 as $s } from "./index-BBsPIKJB.js";
+import { l as $s } from "./index-WDFSbfaV.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) {