@epam/ai-dial-chat-hooks 1.3.0-dev.16 → 1.3.0-dev.161

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,

package/conversation/create-chat-stream-api.d.ts

@@ -0,0 +1,109 @@
+import { SendCompletionDtoModeEnum } from '@epam/ai-dial-chat-api-client';
+import { MessageCustomContent, StreamChunk } from '@epam/ai-dial-chat-shared';
+/** Safe fallback for hosts that do not supply a translated persistence warning. */
+export declare const DEFAULT_GENERATION_PERSISTENCE_ERROR_MESSAGE = "The response could not be saved. It is still shown here, but may be lost if you reload or leave this page. Copy it before continuing.";
+/** Terminal markers the rejected write of a stopped, aborted, or failed answer carried. */
+export interface GenerationPersistenceTerminalMarker {
+    /** Error text the failed write stored; `''` asks the host for its localized fallback. */
+    streamErrorMessage?: string;
+    /** `true` when the rejected write recorded a user stop. */
+    wasStoppedByUser?: boolean;
+}
+/** Identifies a failed terminal save independently of the model's generation outcome. */
+export declare class GenerationPersistenceError extends Error {
+    static readonly type = "conversation_save_failed";
+    /** HTTP status of the rejected terminal write, when the backend reported one. */
+    readonly status?: number;
+    /** Terminal markers of an answer that did not complete; `undefined` for a completed one. */
+    readonly terminalMarker?: GenerationPersistenceTerminalMarker;
+    /**
+     * Creates the error with the default persistence message.
+     * @param status - HTTP status of the rejected terminal write, if known
+     * @param terminalMarker - markers the rejected write of an answer that did not complete carried
+     */
+    constructor(status?: number, terminalMarker?: GenerationPersistenceTerminalMarker);
+}
+/** Fallback text of a {@link GenerationConflictError} when no message is supplied. */
+export declare const DEFAULT_GENERATION_CONFLICT_MESSAGE = "A response is already being generated in this conversation. Wait for it to finish or stop it before sending another message.";
+/**
+ * Reported through `onError` when the backend rejects a completion because
+ * another generation is already active on the same conversation — what a
+ * second browser tab of the same session hits when it submits into a
+ * conversation the first tab is still generating. Distinct from a generic
+ * transport failure so callers can present it as an expected state.
+ */
+export declare class GenerationConflictError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Reported through `onError` when DIAL Core itself signals a failure with an
+ * in-band `{ error: { message, display_message? } }` SSE chunk. Its `message`
+ * is upstream text intended for the user — the chunk's `display_message` when
+ * present, else its `message` — unlike a transport failure (failed `fetch`, non-OK
+ * status, broken stream), whose message is technical detail. A custom
+ * transport raises this for any user-facing upstream error text.
+ */
+export declare class StreamUpstreamError extends Error {
+    constructor(message: string);
+}
+/**
+ * Reported through `onError` when the network connection carrying a
+ * completion stream is lost (a rejected `fetch`, or a read that fails after a
+ * 2xx response) or goes silent past the idle timeout — what a laptop sleep or
+ * a phone lock mid-generation produces. The backend-owned generation may
+ * still be running, so the caller can recover it rather than treat the
+ * response as failed. `cause` holds the original error, when there is one.
+ */
+export declare class StreamInterruptedError extends Error {
+    constructor(cause?: unknown);
+}
+/** Thrown when the Stop endpoint answers with a non-OK status. */
+export declare class StopCompletionError extends Error {
+    /** HTTP status of the rejected Stop request. */
+    readonly status: number;
+    constructor(status: number);
+}
+export declare const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 45000;
+/** Callbacks {@link streamCompletion} reports streamed completion events through. */
+export interface ChatStreamCompletionOptions {
+    onChunk: (chunk: StreamChunk) => void;
+    onComplete: () => void;
+    onError: (error: Error) => void;
+    signal?: AbortSignal;
+}
+/** Host capabilities {@link createChatStreamApi} needs to stream and stop completions. */
+export interface CreateChatStreamApiDeps {
+    /** Returns the currently held CSRF token, or `null` when none is set. */
+    getCsrfToken: () => string | null;
+    /** Stores a CSRF token captured from a response header. */
+    setCsrfToken: (token: string | null) => void;
+    /** Base path for the completion/stop endpoints, e.g. `/api/v1/conversations`. */
+    completionsBasePath: string;
+    /** Resolves the caller's current timezone, attached as `X-Timezone` when non-empty. */
+    getTimezone?: () => string | undefined;
+    /** `fetch` implementation to issue requests through. Defaults to the global `fetch`. */
+    fetchImpl?: typeof fetch;
+    /**
+     * How long an open completion stream may go without receiving a byte
+     * (keepalive comments included) before it is reported as a
+     * {@link StreamInterruptedError}. Defaults to {@link DEFAULT_STREAM_IDLE_TIMEOUT_MS}.
+     */
+    idleTimeoutMs?: number;
+}
+/** DIAL Core completion streaming transport produced by {@link createChatStreamApi}. */
+export interface ChatStreamApi {
+    streamCompletion: (path: string, message: string | undefined, model: string, options: ChatStreamCompletionOptions, customContent?: MessageCustomContent, generationId?: string, mode?: SendCompletionDtoModeEnum, messageIndex?: number, clientChannelId?: string) => void;
+    stopCompletion: (dto: {
+        generationId: string;
+        path: string;
+        content?: string;
+    }) => Promise<void>;
+}
+/**
+ * Builds the streamed-completion transport `apps/chat/src/server-api/chat-stream.api.ts`
+ * exposes today: SSE parsing across partial chunks, CSRF header attachment
+ * and rotation, and an optional timezone header, backed by an injected
+ * `fetch` implementation and base path.
+ */
+export declare const createChatStreamApi: (deps: CreateChatStreamApiDeps) => ChatStreamApi;
+//# sourceMappingURL=create-chat-stream-api.d.ts.map

package/conversation/create-chat-stream-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-chat-stream-api.d.ts","sourceRoot":"","sources":["../../src/conversation/create-chat-stream-api.ts"],"names":[],"mappings":"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"}