@epam/ai-dial-chat-hooks 1.3.0-dev.28 → 1.3.0-dev.288

package/conversation/conversation-transfer/import-conversation.d.ts

@@ -0,0 +1,111 @@
+import { Conversation, ExportFormat } from '@epam/ai-dial-chat-shared';
+import { AllocatedUploadPath, UploadPathAllocator } from './build-upload-path';
+/** Thrown when an imported file cannot be parsed as a supported export envelope. */
+export declare class UnsupportedImportFormatError extends Error {
+    constructor(message: string);
+}
+/**
+ * Parses raw file text into a supported export envelope (`version: 5`) with
+ * an array `history` — conversations are returned unmodified.
+ * Throws `UnsupportedImportFormatError` for malformed JSON or any other shape.
+ */
+export declare const parseImportEnvelope: (text: string) => ExportFormat;
+export interface RebasedConversationId {
+    /** The conversation with `id`/`folderId` rebased to `bucket` and a fresh UUID, and `name` sanitized. */
+    conversation: Conversation;
+    /** Bucket-relative path to pass to `saveConversation`. */
+    subPath: string;
+}
+/**
+ * Rebases a conversation's id/folderId to the current user's bucket and
+ * regenerates its trailing UUID segment, so importing it can never collide
+ * with an existing conversation and needs no replace/skip dialog. Folder
+ * path segments between the bucket and the filename are preserved (not
+ * flattened) — the new chat currently displays everything at the root, but
+ * the conversation keeps its original folder location for when the folder
+ * feature ships.
+ *
+ * The filename's title segment is rewritten from the conversation's own
+ * `name` (see `buildImportedFileName`), and `name` is replaced with the same
+ * sanitized value — the invariant the conversation list relies on to render a
+ * row's title identically whether or not it read the body back.
+ */
+export declare const rebaseConversationId: (conversation: Conversation, bucket: string) => RebasedConversationId;
+/**
+ * Derives the queue row's secondary breadcrumb line from a conversation's
+ * source `folderId` (`{bucket}[/<folder>/...]`) — the segments after the
+ * leading bucket, joined with " / ". Returns `undefined` for a root
+ * conversation (no folder segments).
+ */
+export declare const getFolderBreadcrumb: (conversation: Conversation) => string | undefined;
+/**
+ * Formats a list of names for the aggregate success/failure notifications,
+ * each individually quoted and comma-separated (e.g. `"A", "B", "C"`) so the
+ * i18n template only needs to append the trailing verb phrase.
+ */
+export declare const formatQuotedNameList: (names: string[]) => string;
+/** New location — and, when the import renamed it, new display name — for an imported attachment. */
+export interface RewrittenAttachmentTarget {
+    /** New `files/{bucket}/{path}` id to write into `url`/`reference_url`. */
+    url: string;
+    /** New display name — present only when a ` (n)` disambiguation suffix was applied. */
+    title?: string;
+}
+/**
+ * Rewrites every attachment reference a conversation carries — each
+ * message's own `custom_content.attachments`, the attachments of each
+ * execution stage, the source document of each citation, and the source
+ * document of each entry in the conversation-level citation pool — from an
+ * old file id to its new uploaded location, and its `title` when the target
+ * carries a renamed one. References not present in `targetMap` are left
+ * untouched (immutable — returns a new conversation).
+ */
+export declare const rewriteAttachmentUrls: (conversation: Conversation, targetMap: Map<string, RewrittenAttachmentTarget>) => Conversation;
+/**
+ * Removes every attachment reference that still points into another user's
+ * bucket once the import has re-pointed what it could.
+ *
+ * A plain `.json` export carries no attachment bytes, and an archive can miss
+ * some, so those references keep the exporting user's `files/{bucket}/…` ids.
+ * Written back verbatim, they leave the importing user with previews that
+ * fail with 403. Own-bucket references are kept — they are the
+ * user's own files on a re-import — and so are public ones. A file another
+ * user shared with the importing user is dropped too: nothing here can tell
+ * it apart from one they never had access to.
+ *
+ * The conversation-level citation pool is covered as well: a message
+ * citation stripped of its source would otherwise resolve its `<cit>` from
+ * the pool's copy, which still names the foreign file.
+ *
+ * Returns the conversation (unchanged when nothing was foreign) and the name
+ * of every dropped file, for the skipped-attachment warning.
+ */
+export declare const dropForeignAttachmentRefs: (conversation: Conversation, bucket: string) => {
+    conversation: Conversation;
+    droppedNames: string[];
+};
+/** One attachment reference planned for upload, with its collision-free destination already allocated. */
+export interface PlannedAttachmentUpload {
+    /** Original DIAL file id this attachment is uploaded from — the key `rewriteAttachmentUrls` rewrites. */
+    fileId: string;
+    /** Raw bytes read from the archive. */
+    bytes: Uint8Array;
+    /** Basename a 409 retry re-derives its next attempt from (never the already-suffixed name). */
+    originalFileName: string;
+    /** Destination allocated for the first upload attempt. */
+    allocated: AllocatedUploadPath;
+}
+/**
+ * Resolves a conversation's unique attachment references to archive bytes
+ * and allocates each a collision-free upload destination, in
+ * `collectAttachmentRefs` order — a synchronous pre-pass so suffix
+ * assignment stays deterministic regardless of later upload concurrency.
+ * A reference that cannot be resolved to a `{bucket, path}` pair, or has no
+ * matching bytes in the archive, is reported in `skippedNames` and does not
+ * consume an allocator slot.
+ */
+export declare const planAttachmentUploads: (conversation: Conversation, attachmentBytes: Map<string, Uint8Array>, allocator: UploadPathAllocator) => {
+    plan: PlannedAttachmentUpload[];
+    skippedNames: string[];
+};
+//# sourceMappingURL=import-conversation.d.ts.map

package/conversation/conversation-transfer/import-conversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-conversation.d.ts","sourceRoot":"","sources":["../../../src/conversation/conversation-transfer/import-conversation.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAEV,YAAY,EAEZ,YAAY,EAGb,MAAM,2BAA2B,CAAC;AAOnC,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAG7B,oFAAoF;AACpF,qBAAa,4BAA6B,SAAQ,KAAK;gBACzC,OAAO,EAAE,MAAM;CAI5B;AAOD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,KAAG,YA2BlD,CAAC;AAgGF,MAAM,WAAW,qBAAqB;IACpC,wGAAwG;IACxG,YAAY,EAAE,YAAY,CAAC;IAC3B,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;CACjB;AAgBD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,oBAAoB,GAC/B,cAAc,YAAY,EAC1B,QAAQ,MAAM,KACb,qBAmDF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC9B,cAAc,YAAY,KACzB,MAAM,GAAG,SAMX,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,EAAE,KAAG,MACV,CAAC;AAE9C,qGAAqG;AACrG,MAAM,WAAW,yBAAyB;IACxC,0EAA0E;IAC1E,GAAG,EAAE,MAAM,CAAC;IACZ,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA8HD;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAChC,cAAc,YAAY,EAC1B,WAAW,GAAG,CAAC,MAAM,EAAE,yBAAyB,CAAC,KAChD,YAIA,CAAC;AA4EJ;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,yBAAyB,GACpC,cAAc,YAAY,EAC1B,QAAQ,MAAM,KACb;IAAE,YAAY,EAAE,YAAY,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CA+DtD,CAAC;AAMF,0GAA0G;AAC1G,MAAM,WAAW,uBAAuB;IACtC,yGAAyG;IACzG,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,KAAK,EAAE,UAAU,CAAC;IAClB,+FAA+F;IAC/F,gBAAgB,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,SAAS,EAAE,mBAAmB,CAAC;CAChC;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAChC,cAAc,YAAY,EAC1B,iBAAiB,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACxC,WAAW,mBAAmB,KAC7B;IAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CA2B3D,CAAC"}

package/conversation/conversation-transfer/import-conversation.js

@@ -1,36 +1,39 @@
-import { collectAttachmentRefs as e, splitFileIdAnchor as t } from "./attachment-refs.js";
-import { resolveDialFileBucketAndPath as n } from "./dial-file-resolve.js";
-import { PUBLIC_BUCKET as r, generateUUID as i, sanitizeConversationName as a, stripTrailingDots as o, truncateToUtf8Bytes as s } from "@epam/ai-dial-chat-shared";
+import { collectAttachmentRefs as e, mapAnnotationPool as t, splitFileIdAnchor as n } from "./attachment-refs.js";
+import { resolveDialFileBucketAndPath as r } from "./dial-file-resolve.js";
+import { PUBLIC_BUCKET as i, generateUUID as a, sanitizeConversationName as o, stripTrailingDots as s, truncateToUtf8Bytes as c } from "@epam/ai-dial-chat-shared";
 //#region src/conversation/conversation-transfer/import-conversation.ts
-var c = class extends Error {
+var l = class extends Error {
 	constructor(e) {
 		super(e), this.name = "UnsupportedImportFormatError";
 	}
-}, l = (e) => typeof e == "object" && !!e, u = 5, d = (e) => {
+}, u = (e) => typeof e == "object" && !!e, d = 5, f = (e) => {
 	let t;
 	try {
 		t = JSON.parse(e);
 	} catch {
-		throw new c("Import file is not valid JSON");
+		throw new l("Import file is not valid JSON");
 	}
-	if (!l(t) || t.version !== u || !Array.isArray(t.history)) throw new c("Import file is not a supported export format");
+	if (!u(t) || t.version !== d || !Array.isArray(t.history)) throw new l("Import file is not a supported export format");
 	let n = Array.isArray(t.folders) ? t.folders : [];
 	return {
-		version: u,
+		version: d,
 		history: t.history,
 		folders: n
 	};
-}, f = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i, p = "__", m = 255, h = "applications", g = /[-+]/, _ = /^\d+$/, v = (e) => e ? e.split(g)[0].split(".").every((e) => _.test(e)) : !1, y = (e) => o(s(e.replace(/\r\n|\r/g, "\n").split("\n").map((e) => a(e).trim()).filter(Boolean)[0] ?? "", m)).trimEnd(), b = (e, t, n) => {
-	let r = e.split(p);
-	if (r.length < 2) return [e, i()].join(p);
-	let a = n && v(r[1]) ? r.slice(0, 2) : r.slice(0, 1), o = a.length > 1 ? f.test(r[r.length - 1]) : r.length >= 3, s = r.slice(a.length, o ? -1 : void 0).join(p);
+}, p = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i, m = "__", h = 255, g = "applications", _ = /[-+]/, v = /^\d+$/, y = (e) => e ? e.split(_)[0].split(".").every((e) => v.test(e)) : !1, b = (e) => {
+	let t = e.replace(/\r\n|\r/g, "\n").split("\n").map((e) => o(e).trim()).filter(Boolean)[0] ?? "";
+	return s(c(t, h)).trimEnd();
+}, x = (e, t, n) => {
+	let r = e.split(m);
+	if (r.length < 2) return [e, a()].join(m);
+	let i = n && y(r[1]) ? r.slice(0, 2) : r.slice(0, 1), o = i.length > 1 ? p.test(r[r.length - 1]) : r.length >= 3, s = r.slice(i.length, o ? -1 : void 0).join(m);
 	return [
-		...a,
+		...i,
 		t || s,
-		i()
-	].join(p);
-}, x = "conversations/", S = (e) => e.startsWith(x) ? e.slice(14) : e, C = (e, t) => {
-	let n = S(e.id), r = n.split("/"), i = S(e.folderId), a = r[0], o = i.startsWith(`${a}/`) ? i.slice(a.length + 1).split("/").filter(Boolean) : [], s = r.slice(1).slice(o.length), c = s.slice(0, -1), l = s.at(-1) ?? r.at(-1) ?? n, u = [...o, ...c], d = y(e.name), f = b(l, d, u[0] === h), p = [...u, f].join("/"), m = o.length ? `${t}/${o.join("/")}` : t;
+		a()
+	].join(m);
+}, S = "conversations/", C = (e) => e.startsWith(S) ? e.slice(14) : e, w = (e, t) => {
+	let n = C(e.id), r = n.split("/"), i = C(e.folderId), a = r[0], o = i.startsWith(`${a}/`) ? i.slice(a.length + 1).split("/").filter(Boolean) : [], s = r.slice(1).slice(o.length), c = s.slice(0, -1), l = s.at(-1) ?? r.at(-1) ?? n, u = [...o, ...c], d = b(e.name), f = x(l, d, u[0] === g), p = [...u, f].join("/"), m = o.length ? `${t}/${o.join("/")}` : t;
 	return {
 		conversation: {
 			...e,
@@ -40,18 +43,18 @@ var c = class extends Error {
 		},
 		subPath: p
 	};
-}, w = (e) => {
-	let t = S(e.folderId).split("/").filter(Boolean).slice(1);
+}, T = (e) => {
+	let t = C(e.folderId).split("/").filter(Boolean).slice(1);
 	return t.length ? t.join(" / ") : void 0;
-}, T = (e) => e.map((e) => `"${e}"`).join(", "), E = (e, n) => {
+}, E = (e) => e.map((e) => `"${e}"`).join(", "), D = (e, t) => {
 	if (!e) return;
-	let { fileId: r, anchor: i } = t(e), a = n.get(r);
+	let { fileId: r, anchor: i } = n(e), a = t.get(r);
 	if (a != null) return {
 		...a,
 		url: `${a.url}${i}`
 	};
-}, D = (e, t) => {
-	let n = E(e.url, t), r = E(e.reference_url, t);
+}, O = (e, t) => {
+	let n = D(e.url, t), r = D(e.reference_url, t);
 	if (n == null && r == null) return;
 	let i = n?.title ?? r?.title;
 	return {
@@ -59,19 +62,19 @@ var c = class extends Error {
 		...r == null ? {} : { reference_url: r.url },
 		...i == null ? {} : { title: i }
 	};
-}, O = (e, t) => e.map((e) => e.attachments?.length ? {
+}, k = (e, t) => e.map((e) => e.attachments?.length ? {
 	...e,
 	attachments: e.attachments.map((e) => {
-		let n = D(e, t);
+		let n = O(e, t);
 		return n ? {
 			...e,
 			...n
 		} : e;
 	})
-} : e), k = (e, t) => e.map((e) => {
+} : e), A = (e, t) => {
 	let n = e.body?.source;
 	if (n?.attachment == null) return e;
-	let r = D(n.attachment, t);
+	let r = O(n.attachment, t);
 	return r == null ? e : {
 		...e,
 		body: {
@@ -85,7 +88,7 @@ var c = class extends Error {
 			}
 		}
 	};
-}), A = (e, t) => ({
+}, j = (e, t) => e.map((e) => A(e, t)), M = (e, t) => ({
 	...e,
 	messages: e.messages.map((e) => {
 		let n = e.custom_content;
@@ -96,31 +99,31 @@ var c = class extends Error {
 			custom_content: {
 				...n,
 				...r?.length ? { attachments: r.map((e) => {
-					let n = D(e, t);
+					let n = O(e, t);
 					return n ? {
 						...e,
 						...n
 					} : e;
 				}) } : {},
-				...i?.length ? { stages: O(i, t) } : {},
-				...a?.length ? { annotations: k(a, t) } : {}
+				...i?.length ? { stages: k(i, t) } : {},
+				...a?.length ? { annotations: j(a, t) } : {}
 			}
 		};
 	})
-}), j = (e, i) => {
+}), N = (e, n) => t(M(e, n), (e) => A(e, n)), P = (e, t) => {
 	if (!e) return;
-	let a = n(t(e).fileId);
-	if (!(!a || a.bucket === i || a.bucket === r)) return a.path.split("/").pop() || a.path;
-}, M = (e, t, n) => e.flatMap((e) => {
-	let r = j(e.url, t);
+	let a = r(n(e).fileId);
+	if (a && a.bucket !== t && a.bucket !== i) return a.path.split("/").pop() || a.path;
+}, F = (e, t, n) => e.flatMap((e) => {
+	let r = P(e.url, t);
 	if (r != null) return n.push(r), [];
-	let i = j(e.reference_url, t);
+	let i = P(e.reference_url, t);
 	if (i == null) return [e];
 	n.push(i);
 	let { reference_url: a, reference_type: o, ...s } = e;
 	return s.url == null && s.data == null ? [] : [s];
-}), N = (e, t, n) => e.map((e) => {
-	let r = e.body, i = j(r?.source?.attachment?.url, t);
+}), I = (e, t, n) => {
+	let r = e.body, i = P(r?.source?.attachment?.url, t);
 	if (r == null || i == null) return e;
 	n.push(i);
 	let { source: a, ...o } = r;
@@ -128,53 +131,46 @@ var c = class extends Error {
 		...e,
 		body: o
 	};
-}), P = (e, t) => {
-	let n = [], r = e.messages.map((e) => {
-		let r = e.custom_content;
-		if (!r) return e;
-		let { attachments: i, stages: a, annotations: o } = r;
+}, L = (e, t, n) => e.map((e) => I(e, t, n)), R = (e, n) => {
+	let r = [], i = e.messages.map((e) => {
+		let t = e.custom_content;
+		if (!t) return e;
+		let { attachments: i, stages: a, annotations: o } = t;
 		return !i?.length && !a?.length && !o?.length ? e : {
 			...e,
 			custom_content: {
-				...r,
-				...i?.length ? { attachments: M(i, t, n) } : {},
+				...t,
+				...i?.length ? { attachments: F(i, n, r) } : {},
 				...a?.length ? { stages: a.map((e) => e.attachments?.length ? {
 					...e,
-					attachments: M(e.attachments, t, n)
+					attachments: F(e.attachments, n, r)
 				} : e) } : {},
-				...o?.length ? { annotations: N(o, t, n) } : {}
+				...o?.length ? { annotations: L(o, n, r) } : {}
 			}
 		};
-	});
-	return n.length ? {
-		conversation: {
-			...e,
-			messages: r
-		},
-		droppedNames: n
-	} : {
-		conversation: e,
-		droppedNames: n
+	}), a = r.length ? {
+		...e,
+		messages: i
+	} : e;
+	return {
+		conversation: t(a, (e) => I(e, n, r)),
+		droppedNames: r
 	};
-}, F = (e) => e.split("/").pop() || e, I = (t, r, i) => {
+}, z = (e) => e.split("/").pop() || e, B = (t, n, i) => {
 	let a = [], o = [];
 	for (let s of e(t)) {
-		let e = n(s.fileId);
+		let e = r(s.fileId);
 		if (!e) {
-			o.push(F(s.fileId));
-			continue;
-		}
-		let t = e.path.split("/").pop() ?? e.path, c = r.get(e.path);
-		if (!c) {
-			o.push(t);
+			o.push(z(s.fileId));
 			continue;
 		}
-		a.push({
+		let t = e.path.split("/").pop() ?? e.path, c = n.get(e.path);
+		c ? a.push({
 			fileId: s.fileId,
 			bytes: c,
 			originalFileName: t,
 			allocated: i.allocate(t)
-		});
+		}) : o.push(t);
 	}
 	return {
 		plan: a,
@@ -182,4 +178,4 @@ var c = class extends Error {
 	};
 };
 //#endregion
-export { c as UnsupportedImportFormatError, P as dropForeignAttachmentRefs, T as formatQuotedNameList, w as getFolderBreadcrumb, d as parseImportEnvelope, I as planAttachmentUploads, C as rebaseConversationId, A as rewriteAttachmentUrls };
+export { l as UnsupportedImportFormatError, R as dropForeignAttachmentRefs, E as formatQuotedNameList, T as getFolderBreadcrumb, f as parseImportEnvelope, B as planAttachmentUploads, w as rebaseConversationId, N as rewriteAttachmentUrls };

package/conversation/conversation-transfer/progress.d.ts

@@ -0,0 +1,60 @@
+import { ConversationTransferProgress, ConversationTransferProgressUnits } from '@epam/ai-dial-chat-shared';
+/**
+ * The three stages every transfer job moves through. `Transfer` is the only
+ * one whose work is subdivided, because its unit count is discovered rather
+ * than known at enqueue time.
+ */
+export declare enum ConversationTransferPhase {
+    /** Fetching the conversation, listing conversations, or parsing the import file. */
+    Prepare = "prepare",
+    /** Downloading or uploading the discovered units. */
+    Transfer = "transfer",
+    /** Serializing, building the archive, or saving the conversations. */
+    Finalize = "finalize"
+}
+/** Which weight table a job uses. */
+export declare enum ConversationTransferKind {
+    ExportSingle = "exportSingle",
+    ExportSingleWithAttachments = "exportSingleWithAttachments",
+    ExportAll = "exportAll",
+    Import = "import"
+}
+/** Share of a job's 100 percentage points that each phase is worth. */
+interface PhaseWeights {
+    [ConversationTransferPhase.Prepare]: number;
+    [ConversationTransferPhase.Transfer]: number;
+    [ConversationTransferPhase.Finalize]: number;
+}
+/**
+ * Per-kind phase weights, each summing to 100. Fixed rather than derived from
+ * the unit count so that discovering how many attachments a job has subdivides
+ * work still to do instead of moving the indicator backwards.
+ */
+export declare const TRANSFER_PHASE_WEIGHTS: Record<ConversationTransferKind, PhaseWeights>;
+/** Percentage a fully settled job reports. */
+export declare const TRANSFER_PROGRESS_COMPLETE = 100;
+/** Arguments for {@link computeTransferPercent}. */
+export interface ComputeTransferPercentParams {
+    /** Which weight table applies. */
+    kind: ConversationTransferKind;
+    /** The phase currently advancing. */
+    phase: ConversationTransferPhase;
+    /**
+     * Units settled within `phase`. Omit (or pass `total: 0`) for a phase whose
+     * work is not subdivided; its whole weight is then credited at once.
+     */
+    completed?: number;
+    /** Units `phase` will settle in total. */
+    total?: number;
+}
+/**
+ * Returns the job's completion as an integer 0–100: every earlier phase's
+ * weight in full, plus `phase`'s weight scaled by `completed / total`. A phase
+ * with no units to settle is credited in full, so a conversation with no
+ * attachments never stalls at the start of the transfer phase.
+ */
+export declare const computeTransferPercent: ({ kind, phase, completed, total, }: ComputeTransferPercentParams) => number;
+/** Builds the progress patch for a phase, carrying its unit readout when the phase has units. */
+export declare const buildTransferProgress: (params: ComputeTransferPercentParams, units?: ConversationTransferProgressUnits) => ConversationTransferProgress;
+export {};
+//# sourceMappingURL=progress.d.ts.map

package/conversation/conversation-transfer/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../src/conversation/conversation-transfer/progress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAC5B,iCAAiC,EAClC,MAAM,2BAA2B,CAAC;AAEnC;;;;GAIG;AACH,oBAAY,yBAAyB;IACnC,oFAAoF;IACpF,OAAO,YAAY;IACnB,qDAAqD;IACrD,QAAQ,aAAa;IACrB,sEAAsE;IACtE,QAAQ,aAAa;CACtB;AAED,qCAAqC;AACrC,oBAAY,wBAAwB;IAClC,YAAY,iBAAiB;IAC7B,2BAA2B,gCAAgC;IAC3D,SAAS,cAAc;IACvB,MAAM,WAAW;CAClB;AAED,uEAAuE;AACvE,UAAU,YAAY;IACpB,CAAC,yBAAyB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC5C,CAAC,yBAAyB,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC7C,CAAC,yBAAyB,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC9C;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CACzC,wBAAwB,EACxB,YAAY,CAsBb,CAAC;AAEF,8CAA8C;AAC9C,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAkB9C,oDAAoD;AACpD,MAAM,WAAW,4BAA4B;IAC3C,kCAAkC;IAClC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,qCAAqC;IACrC,KAAK,EAAE,yBAAyB,CAAC;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,oCAKpC,4BAA4B,KAAG,MAOjC,CAAC;AAEF,iGAAiG;AACjG,eAAO,MAAM,qBAAqB,GAChC,QAAQ,4BAA4B,EACpC,QAAQ,iCAAiC,KACxC,4BAGD,CAAC"}

package/conversation/conversation-transfer/progress.js

@@ -36,4 +36,4 @@ var e = /* @__PURE__ */ function(e) {
 	units: t
 });
 //#endregion
-export { t as ConversationTransferKind, e as ConversationTransferPhase, o as buildTransferProgress };
+export { t as ConversationTransferKind, e as ConversationTransferPhase, n as TRANSFER_PHASE_WEIGHTS, o as buildTransferProgress, a as computeTransferPercent };

package/conversation/conversation-transfer/queue.d.ts

@@ -0,0 +1,54 @@
+import { ConversationTransferErrorCode, ConversationTransferJob, ConversationTransferProgress, ConversationTransferSubject, ConversationTransferWarningCode } from '@epam/ai-dial-chat-shared';
+/** Shared job-queue primitive underlying both `useConversationExport` and `useConversationImport`. */
+export interface ConversationTransferQueue {
+    /** Queued jobs, most recently added last. */
+    jobs: ConversationTransferJob[];
+    /** Adds a new `InProgress` job for `subject`, named `fileName`, at 0% and returns its id. */
+    addJob: (subject: ConversationTransferSubject, fileName: string) => string;
+    /** Merges `patch` into the job identified by `jobId`. */
+    updateJob: (jobId: string, patch: Partial<ConversationTransferJob>) => void;
+    /**
+     * Advances the job's progress. A write whose `percent` is lower than the
+     * stored value is discarded, so out-of-order completions from concurrent
+     * transfers cannot move the indicator backwards, and a write to a job that
+     * has already settled is ignored, so an aborted run unwinding in the
+     * background cannot advance a canceled or failed row.
+     */
+    setJobProgress: (jobId: string, progress: ConversationTransferProgress) => void;
+    /** Marks the job `Success` at 100%. */
+    succeedJob: (jobId: string) => void;
+    /**
+     * Marks the job `Warning` at 100%, recording what was incomplete. The file
+     * was still delivered, so this settles the job exactly as `succeedJob` does
+     * apart from the status and the attached code and optional file names.
+     */
+    warnJob: (jobId: string, warningCode: ConversationTransferWarningCode, warningNames?: string[]) => void;
+    /** Marks the job `Failed`, recording why. Progress freezes where it stopped. */
+    failJob: (jobId: string, errorCode: ConversationTransferErrorCode) => void;
+    /**
+     * Aborts the job's in-flight request(s) and marks it `Canceled`, keeping the
+     * row so the user has a record of what they stopped. The job stays retryable.
+     */
+    cancelJob: (jobId: string) => void;
+    /** Aborts the job's in-flight request (if any) and removes it from `jobs`. */
+    dismissJob: (jobId: string) => void;
+    /** Re-invokes the job's registered run function under a fresh `AbortController`. */
+    retryJob: (jobId: string) => void;
+    /** Aborts every in-flight job and clears the queue. */
+    dismissAll: () => void;
+    /**
+     * Runs `run` under a fresh `AbortController` registered for `jobId`, and
+     * registers the same `run` function to be re-invoked (under a new
+     * controller) on `retryJob`.
+     */
+    startJob: (jobId: string, run: (signal: AbortSignal) => Promise<void>) => Promise<void>;
+}
+/**
+ * Owns the export/import job queue: job list state, per-job
+ * `AbortController` tracking, monotonic progress, retry-function
+ * registration, and unmount cleanup. Shared by `useConversationExport` and
+ * `useConversationImport` so both hooks have identical cancellation,
+ * retry, and dismissal semantics.
+ */
+export declare const useConversationTransferQueue: () => ConversationTransferQueue;
+//# sourceMappingURL=queue.d.ts.map

package/conversation/conversation-transfer/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../src/conversation/conversation-transfer/queue.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,EAE5B,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,+BAA+B,EAErC,MAAM,2BAA2B,CAAC;AAInC,sGAAsG;AACtG,MAAM,WAAW,yBAAyB;IACxC,6CAA6C;IAC7C,IAAI,EAAE,uBAAuB,EAAE,CAAC;IAChC,6FAA6F;IAC7F,MAAM,EAAE,CAAC,OAAO,EAAE,2BAA2B,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3E,yDAAyD;IACzD,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,uBAAuB,CAAC,KAAK,IAAI,CAAC;IAC5E;;;;;;OAMG;IACH,cAAc,EAAE,CACd,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,4BAA4B,KACnC,IAAI,CAAC;IACV,uCAAuC;IACvC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC;;;;OAIG;IACH,OAAO,EAAE,CACP,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,+BAA+B,EAC5C,YAAY,CAAC,EAAE,MAAM,EAAE,KACpB,IAAI,CAAC;IACV,gFAAgF;IAChF,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,6BAA6B,KAAK,IAAI,CAAC;IAC3E;;;OAGG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,8EAA8E;IAC9E,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,oFAAoF;IACpF,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,uDAAuD;IACvD,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB;;;;OAIG;IACH,QAAQ,EAAE,CACR,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,KACxC,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,QAAO,yBAkL/C,CAAC"}

package/conversation/conversation-transfer/types.d.ts

@@ -0,0 +1,36 @@
+import { ConversationTransferErrorCode, ConversationTransferWarningCode } from '@epam/ai-dial-chat-shared';
+/** Whether an export includes the conversation's attachments. */
+export declare enum ConversationExportMode {
+    WithAttachments = "withAttachments",
+    WithoutAttachments = "withoutAttachments"
+}
+/** Which export file was produced, used to derive its file name/extension. */
+export declare enum ExportFileNameKind {
+    SingleConversation = "chat_conversation",
+    SingleConversationWithAttachments = "chat_with_attachments",
+    AllConversationsHistory = "chat_conversations_history"
+}
+/** Structured, translation-free error report for a transfer job. */
+export interface ConversationTransferErrorEvent {
+    jobId: string;
+    code: ConversationTransferErrorCode;
+    /** Conversation title(s) relevant to the error, when applicable. */
+    titles?: string[];
+    /** Resolved trace id for the failing request, when the host's `resolveErrorTraceId` supplies one. */
+    traceId?: string;
+}
+export { ConversationTransferErrorCode, ConversationTransferWarningCode };
+/** Structured, translation-free warning report for a transfer job. */
+export interface ConversationTransferWarningEvent {
+    jobId: string;
+    code: ConversationTransferWarningCode;
+    /** Names relevant to the warning (e.g. skipped attachment file names). */
+    names?: string[];
+}
+/** Structured, translation-free success report for a transfer job. */
+export interface ConversationTransferSuccessEvent {
+    jobId: string;
+    /** Conversation title(s) affected, when applicable. */
+    titles?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/conversation/conversation-transfer/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/conversation/conversation-transfer/types.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,oBAAY,sBAAsB;IAChC,eAAe,oBAAoB;IACnC,kBAAkB,uBAAuB;CAC1C;AAED,OAAO,EACL,6BAA6B,EAC7B,+BAA+B,EAChC,MAAM,2BAA2B,CAAC;AAEnC,8EAA8E;AAC9E,oBAAY,kBAAkB;IAC5B,kBAAkB,sBAAsB;IACxC,iCAAiC,0BAA0B;IAC3D,uBAAuB,+BAA+B;CACvD;AAED,oEAAoE;AACpE,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,6BAA6B,CAAC;IACpC,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,qGAAqG;IACrG,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAQD,OAAO,EAAE,6BAA6B,EAAE,+BAA+B,EAAE,CAAC;AAE1E,sEAAsE;AACtE,MAAM,WAAW,gCAAgC;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,+BAA+B,CAAC;IACtC,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,sEAAsE;AACtE,MAAM,WAAW,gCAAgC;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/conversation/conversation-transfer/zip-export.d.ts

@@ -0,0 +1,31 @@
+import { ExportFormat } from '@epam/ai-dial-chat-shared';
+/**
+ * Validates an attachment path before it is written into (or read from) a
+ * `.dial` archive. Blocks path traversal and absolute paths by rejecting
+ * empty, `.`, or `..` path segments (so `../../etc/passwd` and `/etc/passwd`
+ * are both rejected). No character allowlist — real-world filenames
+ * routinely contain spaces, parentheses, and non-ASCII characters, and any
+ * character that would be unsafe in the eventual upload URL is already
+ * percent-encoded downstream by `buildUploadPath`.
+ */
+export declare const isValidArchivePath: (path: string) => boolean;
+/** A single attachment already fetched into memory, ready to be written into the archive. */
+export interface ZipAttachmentEntry {
+    /** Relative path under which the attachment is stored, e.g. `reports/q1.pdf`. */
+    path: string;
+    /** Attachment content. */
+    data: Uint8Array;
+}
+export interface BuildDialArchiveResult {
+    /** The built `.dial` archive. */
+    blob: Blob;
+    /** Attachment paths that failed validation and were not written to the archive. */
+    skippedPaths: string[];
+}
+/**
+ * Builds a `.dial` ZIP archive containing the conversation export envelope
+ * plus every valid attachment, laid out under `res/<path>`. Attachments
+ * failing the path allowlist are skipped and reported in `skippedPaths`.
+ */
+export declare const buildDialArchive: (envelope: ExportFormat, attachments: ZipAttachmentEntry[]) => BuildDialArchiveResult;
+//# sourceMappingURL=zip-export.d.ts.map

package/conversation/conversation-transfer/zip-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip-export.d.ts","sourceRoot":"","sources":["../../../src/conversation/conversation-transfer/zip-export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAY9D;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,OAI4B,CAAC;AAE/E,6FAA6F;AAC7F,MAAM,WAAW,kBAAkB;IACjC,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,iCAAiC;IACjC,IAAI,EAAE,IAAI,CAAC;IACX,mFAAmF;IACnF,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,UAAU,YAAY,EACtB,aAAa,kBAAkB,EAAE,KAChC,sBAqBF,CAAC"}

package/conversation/conversation-transfer/zip-export.js

@@ -2,13 +2,7 @@ import { strToU8 as e, zipSync as t } from "fflate";
 //#region src/conversation/conversation-transfer/zip-export.ts
 var n = e("", !0).constructor, r = (e) => e instanceof n ? e : new n(e), i = (e) => e.length > 0 && e.split("/").every((e) => e !== "" && e !== "." && e !== ".."), a = (n, a) => {
 	let o = [], s = { "conversation.json": r(e(JSON.stringify(n, null, 2))) };
-	for (let e of a) {
-		if (!i(e.path)) {
-			o.push(e.path);
-			continue;
-		}
-		s[`res/${e.path}`] = r(e.data);
-	}
+	for (let e of a) i(e.path) ? s[`res/${e.path}`] = r(e.data) : o.push(e.path);
 	let c = t(s);
 	return {
 		blob: new Blob([new Uint8Array(c)], { type: "application/zip" }),

package/conversation/conversation-transfer/zip-import.d.ts

@@ -0,0 +1,17 @@
+import { ExportFormat } from '@epam/ai-dial-chat-shared';
+export interface ParsedDialArchive {
+    /** The parsed and validated export envelope. */
+    envelope: ExportFormat;
+    /** Attachment bytes keyed by their bucket-relative path (the `res/<path>` suffix). */
+    attachments: Map<string, Uint8Array>;
+}
+/**
+ * Parses a `.dial`/`.zip` archive produced by either the new-chat export
+ * (`conversation.json` at the archive root) or the old (`development`
+ * branch) export (`conversations/<name>.json`) — the JSON entry name is
+ * detected tolerantly by its archive path, since both old-chat and new-chat
+ * archives write the same `version: 5` envelope. Attachment bytes are
+ * collected from `res/<path>` entries, keyed by their validated relative path.
+ */
+export declare const parseDialArchive: (file: File) => Promise<ParsedDialArchive>;
+//# sourceMappingURL=zip-import.d.ts.map

package/conversation/conversation-transfer/zip-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip-import.d.ts","sourceRoot":"","sources":["../../../src/conversation/conversation-transfer/zip-import.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAe9D,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,QAAQ,EAAE,YAAY,CAAC;IACvB,sFAAsF;IACtF,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACtC;AAqBD;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,GAC3B,MAAM,IAAI,KACT,OAAO,CAAC,iBAAiB,CAiC3B,CAAC"}

package/conversation/conversation-transfer/zip-import.js

@@ -18,7 +18,7 @@ var a = "conversation.json", o = /^conversations\/.*\.json$/, s = "res/", c = (e
 	for (let e of d) {
 		if (e.endsWith("/") || !e.startsWith(s)) continue;
 		let t = e.slice(4);
-		!t || !n(t) || m.set(t, u[e]);
+		t && n(t) && m.set(t, u[e]);
 	}
 	return {
 		envelope: p,