@alxxsck/ai-assistant 2.13.0 → 2.15.0

package/README.md

@@ -161,6 +161,38 @@ productButton.addEventListener("click", () => widget.setOpen(true));
 Closing a hidden-launcher widget leaves it non-interactive until the product calls
 `setOpen(true)` again. The runtime and active interaction session remain mounted.
 
+## 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.
+
+```ts
+const widget = new ChatWidgetInstance({
+  customerInteractionSession: session,
+  attachments: { enabled: true },
+});
+```
+
+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.
+
+```ts
+attachments: {
+  enabled: true,
+  sendAttachmentIds: true, // enable once the receiving chat endpoint accepts them
+  transport: {
+    upload: async ({ file, onProgress, signal }) => {
+      // Create an upload session, PUT the file, then complete it.
+      // Return { id, fileName, mediaType, size, kind, downloadUrl, previewUrl }.
+    },
+  },
+}
+```
+
 ## Host handlers
 
 `handlers` is optional and is the only command integration surface. Use it when a

package/dist/{Avatar-C3jiPjI_.js → Avatar-CIVyo3Wu.js}

@@ -1,4 +1,4 @@
-import { I as $s } from "./index-C7FJIuWE.js";
+import { Q as $s } from "./index-KqyvPfgi.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) {