@epam/ai-dial-chat-hooks 1.3.0-dev.29 → 1.3.0-dev.294

package/conversation/useConversationComposerDraft/useConversationComposerDraft.js

@@ -0,0 +1,128 @@
+import { useCallback as e, useEffect as t, useRef as n } from "react";
+//#region src/conversation/useConversationComposerDraft/useConversationComposerDraft.ts
+var r = 300, i = {
+	text: "",
+	skills: [],
+	updatedAt: 0
+}, a = (e) => ({
+	conversationId: e,
+	text: "",
+	skills: [],
+	hasUserInput: !1,
+	isRestored: !1,
+	isSendingCleared: !1,
+	editRevision: 0
+}), o = (e, t) => e.length === t.length && e.every((e, n) => e.url === t[n].url), s = ({ store: s, conversationId: c, restoreDraft: l, isRestoreReady: u = !0, shouldSkipRestore: d = !1, debounceMs: f = r }) => {
+	let p = n(null), m = n(!1), h = n(null), g = n(l), _ = n(f);
+	g.current = l, _.current = f;
+	let v = e((e) => {
+		let t = p.current;
+		if (t?.conversationId === e) return t;
+		t && (m.current = !0);
+		let n = a(e);
+		return p.current = n, n;
+	}, []), y = e(() => {
+		let e = h.current;
+		e && (clearTimeout(e.handle), h.current = null);
+	}, []), b = e(() => {
+		let e = h.current;
+		e && (clearTimeout(e.handle), e.run());
+	}, []), x = e((e, t) => {
+		y();
+		let n = () => {
+			h.current = null, e.write(t.conversationId, {
+				text: t.text,
+				skills: t.skills,
+				updatedAt: Date.now()
+			});
+		};
+		h.current = {
+			handle: setTimeout(n, _.current),
+			run: n
+		};
+	}, [y]);
+	return t(() => b, [
+		s,
+		c,
+		b
+	]), t(() => (window.addEventListener("pagehide", b), () => window.removeEventListener("pagehide", b)), [b]), t(() => {
+		let e = v(c);
+		if (e.isRestored) return;
+		if (d) {
+			e.isRestored = !0;
+			return;
+		}
+		if (!u || !s || (e.isRestored = !0, e.hasUserInput)) return;
+		let t = s.read(c);
+		t ? (e.text = t.text, e.skills = t.skills, g.current(t)) : m.current && g.current(i);
+	}, [
+		s,
+		c,
+		u,
+		d,
+		v
+	]), {
+		handleTextChange: e((e) => {
+			let t = v(c);
+			t.text = e, t.hasUserInput = !0, t.editRevision += 1, t.isSendingCleared = !1, s && x(s, t);
+		}, [
+			s,
+			c,
+			v,
+			x
+		]),
+		handleSkillsChange: e((e) => {
+			let t = v(c);
+			o(t.skills, e) || (t.skills = e, !(t.isSendingCleared && t.text === "") && (t.hasUserInput = !0, t.editRevision += 1, s && x(s, t)));
+		}, [
+			s,
+			c,
+			v,
+			x
+		]),
+		handleExternalContent: e((e) => {
+			let t = v(c);
+			t.text = e, t.skills = [], t.hasUserInput = !0, t.editRevision += 1, t.isSendingCleared = !1, s && x(s, t);
+		}, [
+			s,
+			c,
+			v,
+			x
+		]),
+		sendWithDraft: e(async (e, t) => {
+			if (!s) {
+				await t();
+				return;
+			}
+			let n = v(c);
+			y(), n.text = "", n.isSendingCleared = !0;
+			let r = n.editRevision;
+			try {
+				await t();
+			} catch (t) {
+				throw n.text = e, n.isSendingCleared = !1, s.write(c, {
+					text: e,
+					skills: n.skills,
+					updatedAt: Date.now()
+				}), t;
+			}
+			n.editRevision === r && s.remove(c);
+		}, [
+			s,
+			c,
+			v,
+			y
+		]),
+		clearDraft: e(() => {
+			let e = v(c);
+			y(), e.text = "", e.skills = [], s?.remove(c);
+		}, [
+			s,
+			c,
+			v,
+			y
+		])
+	};
+};
+//#endregion
+export { s as useConversationComposerDraft };

package/conversation/useConversationDiscovery/useConversationDiscovery.d.ts

@@ -0,0 +1,22 @@
+/** Inputs for a session-scoped discovery retry loop. */
+export interface UseConversationDiscoveryOptions {
+    /** Current complete listing. */
+    items: readonly {
+        id: string;
+    }[];
+    /** Refreshes the listing. Initial failures propagate to the caller. */
+    refresh: () => Promise<void>;
+    /** Opaque identity; changing it retires all previous work. */
+    sessionKey: unknown;
+    /** Converts host IDs to a comparable identity. */
+    normalizeId: (id: string) => string;
+    /** Receives retry failures for the current session. */
+    onError?: (error: unknown) => void;
+    /** Additional retries per missing ID. Defaults to five. */
+    retryCount?: number;
+    /** Delay after settlement, in milliseconds. Defaults to 2000. */
+    retryDelayMs?: number;
+}
+/** Refreshes expected conversations using one bounded retry loop per session. */
+export declare const useConversationDiscovery: ({ items: conversations, refresh, sessionKey, normalizeId, onError, retryCount, retryDelayMs, }: UseConversationDiscoveryOptions) => ((expectedIds?: readonly string[]) => Promise<void>);
+//# sourceMappingURL=useConversationDiscovery.d.ts.map

package/conversation/useConversationDiscovery/useConversationDiscovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversationDiscovery.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationDiscovery/useConversationDiscovery.ts"],"names":[],"mappings":"AAYA,wDAAwD;AACxD,MAAM,WAAW,+BAA+B;IAC9C,gCAAgC;IAChC,KAAK,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjC,uEAAuE;IACvE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,8DAA8D;IAC9D,UAAU,EAAE,OAAO,CAAC;IACpB,kDAAkD;IAClD,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,uDAAuD;IACvD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AACD,iFAAiF;AACjF,eAAO,MAAM,wBAAwB,GAAI,gGAQtC,+BAA+B,KAAG,CAAC,CACpC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,KAC5B,OAAO,CAAC,IAAI,CAAC,CAkFjB,CAAC"}

package/conversation/useConversationDiscovery/useConversationDiscovery.js

@@ -0,0 +1,60 @@
+import { useCallback as e, useLayoutEffect as t, useRef as n } from "react";
+//#region src/conversation/useConversationDiscovery/useConversationDiscovery.ts
+var r = 2e3, i = 5, a = ({ items: a, refresh: o, sessionKey: s, normalizeId: c, onError: l, retryCount: u = i, retryDelayMs: d = r }) => {
+	let f = n(null), p = n(/* @__PURE__ */ new Set());
+	t(() => {
+		let e = {
+			pending: /* @__PURE__ */ new Map(),
+			inFlight: !1,
+			retired: !1
+		};
+		return f.current = e, () => {
+			e.retired = !0, clearTimeout(e.timer);
+		};
+	}, [s]), t(() => {
+		p.current = new Set(a.map(({ id: e }) => c(e)));
+	}, [a, c]);
+	let m = e((e) => {
+		let t = () => {
+			for (let [t, n] of e.pending) (p.current.has(t) || n === 0) && e.pending.delete(t);
+		}, n = () => {
+			t(), !(e.retired || e.timer || e.inFlight || e.pending.size === 0) && (e.timer = setTimeout(() => {
+				e.timer = void 0, r();
+			}, d));
+		}, r = async () => {
+			if (t(), !(e.retired || e.pending.size === 0)) {
+				for (let [t, n] of e.pending) e.pending.set(t, n - 1);
+				e.inFlight = !0;
+				try {
+					await o();
+				} catch (t) {
+					e.retired || l?.(t);
+				} finally {
+					e.inFlight = !1, n();
+				}
+			}
+		};
+		n();
+	}, [
+		o,
+		l,
+		d
+	]);
+	return e(async (e = []) => {
+		let t = f.current;
+		if (t && !t.retired) {
+			for (let n of e) {
+				let e = c(n);
+				!p.current.has(e) && !t.pending.has(e) && t.pending.set(e, u);
+			}
+			await o(), m(t);
+		}
+	}, [
+		o,
+		m,
+		c,
+		u
+	]);
+};
+//#endregion
+export { a as useConversationDiscovery };

package/conversation/useConversationExport/useConversationExport.d.ts

@@ -0,0 +1,72 @@
+import { ConversationsApi, FilesApi } from '@epam/ai-dial-chat-api-client';
+import { ConversationTransferJob } from '@epam/ai-dial-chat-shared';
+import { ConversationExportMode, ConversationTransferErrorEvent, ConversationTransferSuccessEvent, ConversationTransferWarningEvent } from '../conversation-transfer/types';
+/**
+ * Default ceiling on the summed byte length of an export's attachments.
+ *
+ * The bound is on *input* bytes even though what it protects is peak heap:
+ * the archive pipeline holds roughly three copies at once — every attachment
+ * in memory, `zipSync`'s output buffer (already-compressed media barely
+ * shrinks), and the copy `buildDialArchive` makes before handing it to `Blob`.
+ * 512 MiB of input therefore peaks near 1.5 GiB, which fits a 64-bit desktop
+ * tab. Sizing this against the ~2 GiB single-`ArrayBuffer` ceiling would be
+ * the wrong bound — that limits one buffer, not the three held together.
+ */
+export declare const DEFAULT_MAX_ARCHIVE_BYTES: number;
+interface ExportErrorClassification {
+    isUnauthorized?: boolean;
+    isNotFound?: boolean;
+}
+/** Parameters for {@link useConversationExport}. */
+export interface UseConversationExportParams {
+    /** Already-configured generated-client instance used to read conversations. */
+    conversationsApi: Pick<ConversationsApi, 'getConversation' | 'listConversations'>;
+    /** Already-configured generated-client instance used to download attachments. */
+    filesApi: Pick<FilesApi, 'downloadFileRaw'>;
+    /** Resolves a conversation id to the bucket-qualified path `getConversation` expects. */
+    normalizeConversationPath: (conversationId: string) => string;
+    /** Classifies a thrown error as unauthorized/not-found. Host-owned error taxonomy; defaults to neither. */
+    classifyTransferError?: (error: unknown) => ExportErrorClassification;
+    /** Resolves a trace id for a failing request, for display in an error notification. */
+    resolveErrorTraceId?: (error: unknown) => Promise<string | undefined>;
+    /**
+     * Ceiling on the summed byte length of an export's attachments; a larger
+     * export fails with `FileTooLarge` instead of being zipped. Defaults to
+     * {@link DEFAULT_MAX_ARCHIVE_BYTES}.
+     */
+    maxArchiveBytes?: number;
+    /** Called when a job completes successfully. */
+    onSuccess?: (event: ConversationTransferSuccessEvent) => void;
+    /** Called when a job succeeds but had to skip something (e.g. an unreachable attachment). */
+    onWarning?: (event: ConversationTransferWarningEvent) => void;
+    /** Called when a job fails. */
+    onError?: (event: ConversationTransferErrorEvent) => void;
+}
+/** Return value of {@link useConversationExport}. */
+export interface UseConversationExportResult {
+    /** Export jobs, most recently added last. Multiple jobs can be in progress concurrently. */
+    jobs: ConversationTransferJob[];
+    /** Enqueues a single-conversation export job and starts it immediately. */
+    exportSingle: (conversationId: string, title: string, mode: ConversationExportMode) => Promise<void>;
+    /** Enqueues an export-all job and starts it immediately. */
+    exportAll: () => Promise<void>;
+    /** Aborts a job's underlying requests and marks it canceled, keeping it in `jobs`. */
+    cancelJob: (jobId: string) => void;
+    /** Removes a job from the queue. If still in progress, aborts its underlying requests. */
+    dismissJob: (jobId: string) => void;
+    /** Re-attempts a failed or canceled job in place (same job id, same parameters). */
+    retryJob: (jobId: string) => void;
+    /** Aborts all in-progress jobs and clears the entire queue. */
+    dismissAll: () => void;
+}
+/**
+ * Owns the export job queue: fetches conversation data through the injected
+ * generated-client operations, builds the JSON v5 / ZIP output via the pure
+ * export utils, reports determinate per-job progress and structured
+ * success/warning/error events, and tracks each job's lifecycle (in progress /
+ * success / failed / canceled) independently so multiple exports can run
+ * concurrently.
+ */
+export declare const useConversationExport: ({ conversationsApi, filesApi, normalizeConversationPath, classifyTransferError, resolveErrorTraceId, maxArchiveBytes, onSuccess, onWarning, onError, }: UseConversationExportParams) => UseConversationExportResult;
+export {};
+//# sourceMappingURL=useConversationExport.d.ts.map

package/conversation/useConversationExport/useConversationExport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversationExport.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationExport/useConversationExport.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAGL,KAAK,uBAAuB,EAI7B,MAAM,2BAA2B,CAAC;AAqBnC,OAAO,EACL,sBAAsB,EACtB,KAAK,8BAA8B,EACnC,KAAK,gCAAgC,EAErC,KAAK,gCAAgC,EAEtC,MAAM,gCAAgC,CAAC;AASxC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,QAAoB,CAAC;AA2E3D,UAAU,yBAAyB;IACjC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAsBD,oDAAoD;AACpD,MAAM,WAAW,2BAA2B;IAC1C,+EAA+E;IAC/E,gBAAgB,EAAE,IAAI,CACpB,gBAAgB,EAChB,iBAAiB,GAAG,mBAAmB,CACxC,CAAC;IACF,iFAAiF;IACjF,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IAC5C,yFAAyF;IACzF,yBAAyB,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9D,2GAA2G;IAC3G,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,yBAAyB,CAAC;IACtE,uFAAuF;IACvF,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACtE;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,gCAAgC,KAAK,IAAI,CAAC;IAC9D,6FAA6F;IAC7F,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,gCAAgC,KAAK,IAAI,CAAC;IAC9D,+BAA+B;IAC/B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,8BAA8B,KAAK,IAAI,CAAC;CAC3D;AAED,qDAAqD;AACrD,MAAM,WAAW,2BAA2B;IAC1C,4FAA4F;IAC5F,IAAI,EAAE,uBAAuB,EAAE,CAAC;IAChC,2EAA2E;IAC3E,YAAY,EAAE,CACZ,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,sBAAsB,KACzB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,sFAAsF;IACtF,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,0FAA0F;IAC1F,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,oFAAoF;IACpF,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,+DAA+D;IAC/D,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAAI,wJAUnC,2BAA2B,KAAG,2BAuchC,CAAC"}

package/conversation/useConversationExport/useConversationExport.js

@@ -1,16 +1,16 @@
-import { ConversationExportMode as e, ConversationTransferWarningCode as t, ExportFileNameKind as n } from "../conversation-transfer/types.js";
-import { EXPORT_APP_NAME as r, buildExportEnvelope as i, buildExportFileName as a, serializeExportEnvelope as o, stripConversationAttachments as s } from "../conversation-transfer/export-conversation.js";
-import { collectAttachmentRefs as c } from "../conversation-transfer/attachment-refs.js";
+import { collectAttachmentRefs as e } from "../conversation-transfer/attachment-refs.js";
+import { ConversationExportMode as t, ConversationTransferWarningCode as n, ExportFileNameKind as r } from "../conversation-transfer/types.js";
+import { EXPORT_APP_NAME as i, buildExportEnvelope as a, buildExportFileName as o, serializeExportEnvelope as s, stripConversationAttachments as c } from "../conversation-transfer/export-conversation.js";
 import { resolveDialFileBucketAndPath as l } from "../conversation-transfer/dial-file-resolve.js";
 import { runWithConcurrency as u } from "../conversation-transfer/async.js";
 import { ConversationTransferKind as d, ConversationTransferPhase as f, buildTransferProgress as p } from "../conversation-transfer/progress.js";
 import { useConversationTransferQueue as m } from "../conversation-transfer/queue.js";
 import { buildDialArchive as h } from "../conversation-transfer/zip-export.js";
-import { ConversationTransferErrorCode as g, ConversationTransferSubjectKind as _, ConversationTransferUnitKind as v, triggerBlobDownload as y } from "@epam/ai-dial-chat-shared";
-import { useCallback as b } from "react";
-import { ResponseError as x } from "@epam/ai-dial-chat-api-client";
+import { ResponseError as g } from "@epam/ai-dial-chat-api-client";
+import { ConversationTransferErrorCode as _, ConversationTransferSubjectKind as v, ConversationTransferUnitKind as y, triggerBlobDownload as b } from "@epam/ai-dial-chat-shared";
+import { useCallback as x } from "react";
 //#region src/conversation/useConversationExport/useConversationExport.ts
-var S = 5, C = 512 * 1024 * 1024, w = 429, T = 5, E = 2e3, D = (e) => e instanceof x && e.response.status === w, O = (e, t) => {
+var S = 5, C = 536870912, w = 429, T = 5, E = 2e3, D = (e) => e instanceof g && e.response.status === w, O = (e, t) => {
 	let n = Number(e.response.headers.get("Retry-After"));
 	return Number.isFinite(n) && n > 0 ? n * 1e3 : E * t;
 }, k = (e, t) => new Promise((n) => {
@@ -29,8 +29,8 @@ var S = 5, C = 512 * 1024 * 1024, w = 429, T = 5, E = 2e3, D = (e) => e instance
 		if (n.aborted || !D(e) || r >= T) throw e;
 		await k(O(e, r), n);
 	}
-}, j = (e) => !e.sharedWithMe && !e.publishedWithMe, M = (e) => e instanceof RangeError, N = (t) => t === e.WithoutAttachments ? d.ExportSingle : d.ExportSingleWithAttachments, P = ({ conversationsApi: x, filesApi: w, normalizeConversationPath: T, classifyTransferError: E = () => ({}), resolveErrorTraceId: D = async () => void 0, maxArchiveBytes: O = C, onSuccess: k, onWarning: P, onError: F }) => {
-	let I = m(), L = b(async (e, t, n) => {
+}, j = (e) => !e.sharedWithMe && !e.publishedWithMe, M = (e) => e instanceof RangeError, N = (e) => e === t.WithoutAttachments ? d.ExportSingle : d.ExportSingleWithAttachments, P = ({ conversationsApi: g, filesApi: w, normalizeConversationPath: T, classifyTransferError: E = () => ({}), resolveErrorTraceId: D = async () => void 0, maxArchiveBytes: O = C, onSuccess: k, onWarning: P, onError: F }) => {
+	let I = m(), L = x(async (e, t, n) => {
 		let r = !1, i = !1, a = 0, o = () => {
 			a += 1, n(a, e.length);
 		};
@@ -38,11 +38,8 @@ var S = 5, C = 512 * 1024 * 1024, w = 429, T = 5, E = 2e3, D = (e) => e instance
 			entries: await u(e, S, async (e) => {
 				if (t.aborted || i) return;
 				let n = l(e.fileId);
-				if (!n) {
-					r = !0, o();
-					return;
-				}
-				try {
+				if (!n) r = !0, o();
+				else try {
 					let e = await w.downloadFileRaw({
 						bucket: n.bucket,
 						path: n.path
@@ -64,43 +61,44 @@ var S = 5, C = 512 * 1024 * 1024, w = 429, T = 5, E = 2e3, D = (e) => e instance
 			anySkipped: !t.aborted && !i && r,
 			isUnauthorized: !t.aborted && i
 		};
-	}, [E, w]), R = b(async (n, r, a, l, u, d) => {
-		let m = N(l), _;
+	}, [E, w]), R = x(async (r, i, o, l, u, d) => {
+		let m = N(l), v;
 		try {
-			_ = await A(x, T(r), d);
+			v = await A(g, T(i), d);
 		} catch (e) {
 			if (d.aborted) return;
 			if (E(e).isUnauthorized) F?.({
-				jobId: n,
-				code: g.Unauthorized
-			}), I.failJob(n, g.Unauthorized);
+				jobId: r,
+				code: _.Unauthorized
+			}), I.failJob(r, _.Unauthorized);
 			else {
 				let t = await D(e);
 				F?.({
-					jobId: n,
-					code: g.Unknown,
-					titles: [a],
+					jobId: r,
+					code: _.Unknown,
+					titles: [o],
 					traceId: t
-				}), I.failJob(n, g.Unknown);
+				}), I.failJob(r, _.Unknown);
 			}
 			console.error("Failed to fetch conversation for export", e);
 			return;
 		}
 		if (!d.aborted) {
-			I.setJobProgress(n, p({
+			I.setJobProgress(r, p({
 				kind: m,
 				phase: f.Prepare
 			}));
 			try {
-				if (l === e.WithoutAttachments) {
-					y(o(i([s(_)], [])), u), k?.({
-						jobId: n,
-						titles: [a]
-					}), I.succeedJob(n);
+				if (l === t.WithoutAttachments) {
+					let e = a([c(v)], []), t = s(e);
+					b(t, u), k?.({
+						jobId: r,
+						titles: [o]
+					}), I.succeedJob(r);
 					return;
 				}
-				let r = c(_), { entries: b, anySkipped: x, isUnauthorized: S } = await L(r, d, (e, t) => {
-					I.setJobProgress(n, p({
+				let i = e(v), { entries: g, anySkipped: x, isUnauthorized: S } = await L(i, d, (e, t) => {
+					I.setJobProgress(r, p({
 						kind: m,
 						phase: f.Transfer,
 						completed: e,
@@ -108,54 +106,54 @@ var S = 5, C = 512 * 1024 * 1024, w = 429, T = 5, E = 2e3, D = (e) => e instance
 					}, {
 						completed: e,
 						total: t,
-						kind: v.Attachment
+						kind: y.Attachment
 					}));
 				});
 				if (d.aborted) return;
 				if (S) {
 					F?.({
-						jobId: n,
-						code: g.Unauthorized
-					}), I.failJob(n, g.Unauthorized);
+						jobId: r,
+						code: _.Unauthorized
+					}), I.failJob(r, _.Unauthorized);
 					return;
 				}
-				I.setJobProgress(n, p({
+				I.setJobProgress(r, p({
 					kind: m,
 					phase: f.Transfer,
-					completed: r.length,
-					total: r.length
+					completed: i.length,
+					total: i.length
 				}));
-				let C = b.reduce((e, t) => e + t.data.byteLength, 0);
+				let C = g.reduce((e, t) => e + t.data.byteLength, 0);
 				if (C > O) {
 					F?.({
-						jobId: n,
-						code: g.FileTooLarge,
-						titles: [a]
-					}), I.failJob(n, g.FileTooLarge), console.error(`Refused to build an export archive of ${C} bytes: over the ${O}-byte limit`);
+						jobId: r,
+						code: _.FileTooLarge,
+						titles: [o]
+					}), I.failJob(r, _.FileTooLarge), console.error(`Refused to build an export archive of ${C} bytes: over the ${O}-byte limit`);
 					return;
 				}
-				let { blob: w, skippedPaths: T } = h(i([_], []), b), E = x || T.length > 0;
-				E && P?.({
-					jobId: n,
-					code: t.AttachmentSkipped
-				}), y(w, u), k?.({
-					jobId: n,
-					titles: [a]
-				}), E ? I.warnJob(n, t.AttachmentSkipped) : I.succeedJob(n);
+				let w = a([v], []), { blob: T, skippedPaths: E } = h(w, g), D = x || E.length > 0;
+				D && P?.({
+					jobId: r,
+					code: n.AttachmentSkipped
+				}), b(T, u), k?.({
+					jobId: r,
+					titles: [o]
+				}), D ? I.warnJob(r, n.AttachmentSkipped) : I.succeedJob(r);
 			} catch (e) {
 				if (d.aborted) return;
-				let t = M(e) ? g.FileTooLarge : g.Unknown, r = await D(e);
+				let t = M(e) ? _.FileTooLarge : _.Unknown, n = await D(e);
 				F?.({
-					jobId: n,
+					jobId: r,
 					code: t,
-					titles: [a],
-					traceId: r
-				}), I.failJob(n, t), console.error("Failed to build conversation export archive", e);
+					titles: [o],
+					traceId: n
+				}), I.failJob(r, t), console.error("Failed to build conversation export archive", e);
 			}
 		}
 	}, [
 		E,
-		x,
+		g,
 		L,
 		O,
 		T,
@@ -164,50 +162,50 @@ var S = 5, C = 512 * 1024 * 1024, w = 429, T = 5, E = 2e3, D = (e) => e instance
 		P,
 		I,
 		D
-	]), z = b((t, i, o) => {
-		let s = a(o === e.WithoutAttachments ? n.SingleConversation : n.SingleConversationWithAttachments, r), c = I.addJob({
-			kind: _.Single,
-			title: i
+	]), z = x((e, n, a) => {
+		let s = o(a === t.WithoutAttachments ? r.SingleConversation : r.SingleConversationWithAttachments, i), c = I.addJob({
+			kind: v.Single,
+			title: n
 		}, s);
-		return I.startJob(c, (e) => R(c, t, i, o, s, e));
-	}, [I, R]), B = b(async (e, t, n) => {
-		let r = d.ExportAll, a = [], c;
+		return I.startJob(c, (t) => R(c, e, n, a, s, t));
+	}, [I, R]), B = x(async (e, t, n) => {
+		let r = d.ExportAll, i = [], o;
 		do {
 			if (n.aborted) return;
 			let t;
 			try {
-				t = await x.listConversations({ nextToken: c }, { signal: n });
+				t = await g.listConversations({ nextToken: o }, { signal: n });
 			} catch (t) {
 				if (n.aborted) return;
 				if (E(t).isUnauthorized) F?.({
 					jobId: e,
-					code: g.Unauthorized
-				}), I.failJob(e, g.Unauthorized);
+					code: _.Unauthorized
+				}), I.failJob(e, _.Unauthorized);
 				else {
 					let n = await D(t);
 					F?.({
 						jobId: e,
-						code: g.Unknown,
+						code: _.Unknown,
 						traceId: n
-					}), I.failJob(e, g.Unknown);
+					}), I.failJob(e, _.Unknown);
 				}
 				console.error("Failed to list conversations for export", t);
 				return;
 			}
-			a.push(...t.items.filter(j).map((e) => ({
+			i.push(...t.items.filter(j).map((e) => ({
 				id: e.id,
 				title: e.title
-			}))), c = t.nextToken;
-		} while (c);
+			}))), o = t.nextToken;
+		} while (o);
 		I.setJobProgress(e, p({
 			kind: r,
 			phase: f.Prepare
 		}));
 		let l = [];
-		for (let t of a) {
+		for (let t of i) {
 			if (n.aborted) return;
 			try {
-				let e = await A(x, T(t.id), n);
+				let e = await A(g, T(t.id), n);
 				l.push(e);
 			} catch (r) {
 				if (n.aborted) return;
@@ -215,15 +213,15 @@ var S = 5, C = 512 * 1024 * 1024, w = 429, T = 5, E = 2e3, D = (e) => e instance
 				if (i.isUnauthorized) {
 					F?.({
 						jobId: e,
-						code: g.Unauthorized
-					}), I.failJob(e, g.Unauthorized);
+						code: _.Unauthorized
+					}), I.failJob(e, _.Unauthorized);
 					return;
 				}
 				if (i.isNotFound) {
 					let n = await D(r);
 					F?.({
 						jobId: e,
-						code: g.NotFound,
+						code: _.NotFound,
 						titles: [t.title],
 						traceId: n
 					}), console.error("Skipped a conversation during export-all: not found", r);
@@ -232,27 +230,28 @@ var S = 5, C = 512 * 1024 * 1024, w = 429, T = 5, E = 2e3, D = (e) => e instance
 				let a = await D(r);
 				F?.({
 					jobId: e,
-					code: g.Unknown,
+					code: _.Unknown,
 					traceId: a
-				}), I.failJob(e, g.Unknown), console.error("Aborted export-all: failed to fetch conversation", r);
+				}), I.failJob(e, _.Unknown), console.error("Aborted export-all: failed to fetch conversation", r);
 				return;
 			} finally {
 				I.setJobProgress(e, p({
 					kind: r,
 					phase: f.Transfer,
 					completed: l.length,
-					total: a.length
+					total: i.length
 				}, {
 					completed: l.length,
-					total: a.length,
-					kind: v.Conversation
+					total: i.length,
+					kind: y.Conversation
 				}));
 			}
 		}
 		if (!n.aborted) try {
-			y(o(i(l.map(s), [])), t), k?.({ jobId: e }), I.succeedJob(e);
+			let n = a(l.map(c), []), r = s(n);
+			b(r, t), k?.({ jobId: e }), I.succeedJob(e);
 		} catch (t) {
-			let n = M(t) ? g.FileTooLarge : g.Unknown, r = await D(t);
+			let n = M(t) ? _.FileTooLarge : _.Unknown, r = await D(t);
 			F?.({
 				jobId: e,
 				code: n,
@@ -261,14 +260,14 @@ var S = 5, C = 512 * 1024 * 1024, w = 429, T = 5, E = 2e3, D = (e) => e instance
 		}
 	}, [
 		E,
-		x,
+		g,
 		T,
 		F,
 		k,
 		I,
 		D
-	]), V = b(() => {
-		let e = a(n.AllConversationsHistory, r), t = I.addJob({ kind: _.All }, e);
+	]), V = x(() => {
+		let e = o(r.AllConversationsHistory, i), t = I.addJob({ kind: v.All }, e);
 		return I.startJob(t, (n) => B(t, e, n));
 	}, [I, B]);
 	return {

package/conversation/useConversationHandlers/attachment-to-dto.d.ts

@@ -0,0 +1,7 @@
+import { AttachmentDto } from '@epam/ai-dial-chat-api-client';
+import { Attachment } from '@epam/ai-dial-chat-shared';
+/** Maps an already-uploaded attachment to its DTO shape. Throws if the attachment has no `url` yet. */
+export declare const attachmentToDto: (attachment: Attachment) => AttachmentDto;
+/** Maps a list of already-uploaded attachments to DTOs, or `undefined` when the list is empty. */
+export declare const attachmentsToDtos: (attachments: Attachment[]) => AttachmentDto[] | undefined;
+//# sourceMappingURL=attachment-to-dto.d.ts.map

package/conversation/useConversationHandlers/attachment-to-dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-to-dto.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationHandlers/attachment-to-dto.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,uGAAuG;AACvG,eAAO,MAAM,eAAe,GAAI,YAAY,UAAU,KAAG,aAUxD,CAAC;AAEF,kGAAkG;AAClG,eAAO,MAAM,iBAAiB,GAC5B,aAAa,UAAU,EAAE,KACxB,aAAa,EAAE,GAAG,SAGpB,CAAC"}

package/conversation/useConversationHandlers/message-factory.d.ts

@@ -0,0 +1,9 @@
+import { Message, MessageCustomContent } from '@epam/ai-dial-chat-shared';
+/** A newly-created user message paired with its empty assistant placeholder. */
+export interface MessagePair {
+    userMessage: Message;
+    assistantMessage: Message;
+}
+/** Builds a user message and its empty assistant placeholder, both timestamped `now`. */
+export declare const createMessagePair: (content: string, customContent?: MessageCustomContent, deploymentId?: string | null) => MessagePair;
+//# sourceMappingURL=message-factory.d.ts.map

package/conversation/useConversationHandlers/message-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-factory.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationHandlers/message-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,oBAAoB,EAE1B,MAAM,2BAA2B,CAAC;AAEnC,gFAAgF;AAChF,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,yFAAyF;AACzF,eAAO,MAAM,iBAAiB,GAC5B,SAAS,MAAM,EACf,gBAAgB,oBAAoB,EACpC,eAAe,MAAM,GAAG,IAAI,KAC3B,WAoBF,CAAC"}