@epam/ai-dial-chat-hooks 1.3.0-dev.33 → 1.3.0-dev.331

package/conversation/conversation-transfer/attachment-refs.js

@@ -10,7 +10,25 @@ var e = (e) => e.startsWith("files/"), t = /^#[\w.=%-]*$/, n = (e) => {
 		fileId: e.slice(0, n),
 		anchor: t.test(r) ? r : ""
 	};
-}, r = (e, t) => {
+}, r = (e) => typeof e == "object" && !!e, i = (e) => {
+	let t = e.customViewState?.annotations;
+	return Array.isArray(t) ? t.filter(r) : [];
+}, a = (e, t) => {
+	let n = e.customViewState, i = n?.annotations;
+	if (!Array.isArray(i)) return e;
+	let a = !1, o = i.map((e) => {
+		if (!r(e)) return e;
+		let n = t(e);
+		return n !== e && (a = !0), n;
+	});
+	return a ? {
+		...e,
+		customViewState: {
+			...n,
+			annotations: o
+		}
+	} : e;
+}, o = (e, t) => {
 	for (let n of e.messages) {
 		let e = n.custom_content;
 		if (e) {
@@ -22,15 +40,19 @@ var e = (e) => e.startsWith("files/"), t = /^#[\w.=%-]*$/, n = (e) => {
 			}
 		}
 	}
-}, i = (t) => {
-	let i = /* @__PURE__ */ new Set(), a = (t) => {
+	for (let n of i(e)) {
+		let e = n.body?.source?.attachment;
+		e && t(e);
+	}
+}, s = (t) => {
+	let r = /* @__PURE__ */ new Set(), i = (t) => {
 		if (t == null) return;
-		let { fileId: r } = n(t);
-		e(r) && i.add(r);
+		let { fileId: i } = n(t);
+		e(i) && r.add(i);
 	};
-	return r(t, (e) => {
-		a(e.url), a(e.reference_url);
-	}), Array.from(i, (e) => ({ fileId: e }));
+	return o(t, (e) => {
+		i(e.url), i(e.reference_url);
+	}), Array.from(r, (e) => ({ fileId: e }));
 };
 //#endregion
-export { i as collectAttachmentRefs, n as splitFileIdAnchor };
+export { s as collectAttachmentRefs, a as mapAnnotationPool, n as splitFileIdAnchor };

package/conversation/conversation-transfer/build-upload-path.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Builds the `uploads/<YYYY-MM>/<safe-name>` upload path for a file.
+ * `date` defaults to now (regular attachment upload); conversation import
+ * passes a date fixed for the whole job so all its attachments land in the
+ * same month folder. Does not de-duplicate: a name collision is left for the
+ * upload call to reject (`create-only` mode) — use `createUploadPathAllocator`
+ * when collisions must be resolved with a ` (n)` suffix instead.
+ */
+export declare const buildUploadPath: (fileName: string, date?: Date) => string;
+/** A file name the allocator has handed out, in the forms the caller needs. */
+export interface AllocatedUploadPath {
+    /** Bucket-relative, percent-encoded upload path, e.g. `uploads/2026-08/report%20(1).pdf`. */
+    path: string;
+    /** Decoded name actually reserved, e.g. `report (1).pdf` — pass this as the uploaded `File`'s name. */
+    fileName: string;
+    /** Whether a ` (n)` suffix had to be appended because the requested name was taken. */
+    isRenamed: boolean;
+}
+/** Stateful allocator that hands out collision-free upload paths inside one month folder. */
+export interface UploadPathAllocator {
+    /** Reserves the next free name derived from `fileName` and returns its upload path. */
+    allocate: (fileName: string) => AllocatedUploadPath;
+    /** Records `fileName` as taken — used when the server rejects a name the registry believed free. */
+    markTaken: (fileName: string) => void;
+    /** Returns a previously allocated `fileName` to the free pool — used when its upload failed for a reason other than a collision. */
+    release: (fileName: string) => void;
+}
+/**
+ * Creates an allocator that assigns ` (1)`, ` (2)`, … suffixes to repeated or
+ * pre-existing file names so every allocation lands on a distinct path inside
+ * one `uploads/<YYYY-MM>/` folder. Mutation is deliberately confined to the
+ * private `Set` closed over here — an explicit, contained exception to the
+ * immutable-by-default rule, needed because collision-free naming is
+ * inherently a sequential, stateful decision.
+ */
+export declare const createUploadPathAllocator: (params?: {
+    /** Month folder to allocate into. Defaults to now. */
+    date?: Date;
+    /** Decoded names already present in the destination folder, e.g. from `listFiles`. */
+    existingNames?: Iterable<string>;
+}) => UploadPathAllocator;
+//# sourceMappingURL=build-upload-path.d.ts.map

package/conversation/conversation-transfer/build-upload-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-upload-path.d.ts","sourceRoot":"","sources":["../../../src/conversation/conversation-transfer/build-upload-path.ts"],"names":[],"mappings":"AAmBA;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAU,MAAM,EAChB,OAAM,IAAiB,KACtB,MAIF,CAAC;AAUF,+EAA+E;AAC/E,MAAM,WAAW,mBAAmB;IAClC,6FAA6F;IAC7F,IAAI,EAAE,MAAM,CAAC;IACb,uGAAuG;IACvG,QAAQ,EAAE,MAAM,CAAC;IACjB,uFAAuF;IACvF,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,6FAA6F;AAC7F,MAAM,WAAW,mBAAmB;IAClC,uFAAuF;IACvF,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,mBAAmB,CAAC;IACpD,oGAAoG;IACpG,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,oIAAoI;IACpI,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,GAAI,SAAS;IACjD,sDAAsD;IACtD,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,sFAAsF;IACtF,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CAClC,KAAG,mBAgCH,CAAC"}

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

@@ -0,0 +1,5 @@
+/** Formats a `Date` as `YYYY-MM-DD` using its local-time components. */
+export declare const formatDateYMD: (date: Date) => string;
+/** Formats a `Date` as `YYYY-MM` using its local-time components. */
+export declare const formatDateYM: (date: Date) => string;
+//# sourceMappingURL=date.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../../src/conversation/conversation-transfer/date.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,eAAO,MAAM,aAAa,GAAI,MAAM,IAAI,KAAG,MAK1C,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,YAAY,GAAI,MAAM,IAAI,KAAG,MAIzC,CAAC"}

package/conversation/conversation-transfer/dial-file-resolve.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Extracts the bucket and decoded relative path from a DIAL file ID
+ * (`files/{bucket}/{path}`). Returns `undefined` if the input does not start
+ * with `files/` or has no path segment after the bucket.
+ */
+export declare const resolveDialFileBucketAndPath: (fileId: string) => {
+    bucket: string;
+    path: string;
+} | undefined;
+//# sourceMappingURL=dial-file-resolve.d.ts.map

package/conversation/conversation-transfer/dial-file-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dial-file-resolve.d.ts","sourceRoot":"","sources":["../../../src/conversation/conversation-transfer/dial-file-resolve.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,GACvC,QAAQ,MAAM,KACb;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAcrC,CAAC"}

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

@@ -0,0 +1,14 @@
+import { Conversation, ExportFolder, ExportFormat } from '@epam/ai-dial-chat-shared';
+import { ExportFileNameKind } from './types';
+/** Placeholder app name used in every export file name — this branch has no app display-name config yet. */
+export declare const EXPORT_APP_NAME = "ai_dial";
+/**
+ * Returns the conversation with every message-, stage- and citation-level
+ * attachment reference removed, including the source documents of the
+ * conversation-level citation pool.
+ */
+export declare const stripConversationAttachments: (conversation: Conversation) => Conversation;
+export declare const buildExportEnvelope: (conversations: Conversation[], folders?: ExportFolder[]) => ExportFormat;
+export declare const serializeExportEnvelope: (envelope: ExportFormat) => Blob;
+export declare const buildExportFileName: (kind: ExportFileNameKind, appName: string, date?: Date) => string;
+//# sourceMappingURL=export-conversation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export-conversation.d.ts","sourceRoot":"","sources":["../../../src/conversation/conversation-transfer/export-conversation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,YAAY,EACZ,YAAY,EACZ,YAAY,EAGb,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C,4GAA4G;AAC5G,eAAO,MAAM,eAAe,YAAY,CAAC;AA8CzC;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,GACvC,cAAc,YAAY,KACzB,YAOA,CAAC;AAEJ,eAAO,MAAM,mBAAmB,GAC9B,eAAe,YAAY,EAAE,EAC7B,UAAS,YAAY,EAAO,KAC3B,YAID,CAAC;AAEH,eAAO,MAAM,uBAAuB,GAAI,UAAU,YAAY,KAAG,IACY,CAAC;AAQ9E,eAAO,MAAM,mBAAmB,GAC9B,MAAM,kBAAkB,EACxB,SAAS,MAAM,EACf,OAAM,IAAiB,KACtB,MACyE,CAAC"}

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

@@ -1,22 +1,23 @@
-import { formatDateYMD as e } from "./date.js";
-import { ExportFileNameKind as t } from "./types.js";
+import { mapAnnotationPool as e } from "./attachment-refs.js";
+import { formatDateYMD as t } from "./date.js";
+import { ExportFileNameKind as n } from "./types.js";
 //#region src/conversation/conversation-transfer/export-conversation.ts
-var n = "ai_dial", r = (e) => e.map(({ attachments: e, ...t }) => t), i = (e) => e.map((e) => {
+var r = "ai_dial", i = (e) => e.map(({ attachments: e, ...t }) => t), a = (e) => {
 	if (e.body?.source == null) return e;
 	let { source: t, ...n } = e.body;
 	return {
 		...e,
 		body: n
 	};
-}), a = (e) => {
+}, o = (e) => e.map(a), s = (e) => {
 	let t = e.custom_content;
 	if (!t) return e;
-	let { attachments: n, stages: a, annotations: o, ...s } = t;
-	if (n == null && a == null && o == null) return e;
+	let { attachments: n, stages: r, annotations: a, ...s } = t;
+	if (n == null && r == null && a == null) return e;
 	let c = {
 		...s,
-		...a ? { stages: r(a) } : {},
-		...o ? { annotations: i(o) } : {}
+		...r ? { stages: i(r) } : {},
+		...a ? { annotations: o(a) } : {}
 	};
 	if (Object.keys(c).length > 0) return {
 		...e,
@@ -24,17 +25,17 @@ var n = "ai_dial", r = (e) => e.map(({ attachments: e, ...t }) => t), i = (e) =>
 	};
 	let { custom_content: l, ...u } = e;
 	return u;
-}, o = (e) => ({
-	...e,
-	messages: e.messages.map(a)
-}), s = (e, t = []) => ({
+}, c = (t) => e({
+	...t,
+	messages: t.messages.map(s)
+}, a), l = (e, t = []) => ({
 	version: 5,
 	history: e,
 	folders: t
-}), c = (e) => new Blob([JSON.stringify(e, null, 2)], { type: "application/json" }), l = {
-	[t.SingleConversation]: "json",
-	[t.SingleConversationWithAttachments]: "dial",
-	[t.AllConversationsHistory]: "json"
-}, u = (t, n, r = /* @__PURE__ */ new Date()) => `${e(r)}_${n}_${t}.${l[t]}`;
+}), u = (e) => new Blob([JSON.stringify(e, null, 2)], { type: "application/json" }), d = {
+	[n.SingleConversation]: "json",
+	[n.SingleConversationWithAttachments]: "dial",
+	[n.AllConversationsHistory]: "json"
+}, f = (e, n, r = /* @__PURE__ */ new Date()) => `${t(r)}_${n}_${e}.${d[e]}`;
 //#endregion
-export { n as EXPORT_APP_NAME, s as buildExportEnvelope, u as buildExportFileName, c as serializeExportEnvelope, o as stripConversationAttachments };
+export { r as EXPORT_APP_NAME, l as buildExportEnvelope, f as buildExportFileName, u as serializeExportEnvelope, c as stripConversationAttachments };

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 };