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

package/conversation/announcement-message.d.ts

@@ -0,0 +1,61 @@
+/** A link rendered as the call to action of an announcements-popover entry. */
+export interface AnnouncementListItemLink {
+    /** Visible text of the call to action. */
+    label: string;
+    /** Absolute `http`/`https` target the call to action opens. */
+    href: string;
+}
+/** One entry of the announcements popover behind the banner's `+N` pill. */
+export interface AnnouncementListItem {
+    /** Plain-text heading of the entry. */
+    title: string;
+    /** Supporting copy of the entry, sanitized before it is rendered. */
+    description?: string | null;
+    /** Optional call to action shown at the end of the entry. */
+    link?: AnnouncementListItemLink | null;
+}
+/** Structured announcement banner content. */
+export interface AnnouncementContent {
+    title: string | null;
+    description: string | null;
+    html: string | null;
+    /** Entries of the popover the banner opens. */
+    items?: readonly AnnouncementListItem[];
+}
+/** Sanitizes announcement HTML to the allowed inline tag/attribute set. */
+export declare const sanitizeAnnouncementHtml: (html: string) => string;
+/**
+ * Sanitizes the legacy `ANNOUNCEMENT_HTML_MESSAGE` banner, which permits the
+ * block-level markup the inline pass strips. See
+ * `ANNOUNCEMENT_MESSAGE_SANITIZE_OPTIONS` for why the two lists differ.
+ */
+export declare const sanitizeAnnouncementMessageHtml: (html: string) => string;
+/**
+ * Whether the operator configured the structured banner (title and/or
+ * description) rather than only the legacy HTML message. Drives which of the
+ * two banner layouts renders.
+ */
+export declare const hasStructuredAnnouncement: ({ title, description, }: AnnouncementContent) => boolean;
+/** True when the announcement has any renderable content (structured or legacy HTML). */
+export declare const hasAnnouncementContent: (content: AnnouncementContent) => boolean;
+/**
+ * Builds the value persisted under `StorageKey.TextOfClosedAnnouncement` when
+ * the user dismisses the banner. Dismissal is content-keyed: the banner stays
+ * hidden only while the current announcement produces the same signature, so
+ * editing any part of it brings the banner back with no version counter.
+ *
+ * Every piece of content the banner surface renders feeds the signature — the
+ * title, the description, and the popover entries behind the pill, which live
+ * inside the banner and are hidden along with it. Publishing a new entry in
+ * that list therefore invalidates an earlier dismissal on its own, even when
+ * the banner line itself is untouched.
+ *
+ * A legacy-only announcement returns the raw HTML string — byte-identical to
+ * what shipped before the structured fields existed — so dismissals recorded
+ * by older builds keep working without a storage migration. `items` is left
+ * out of the payload entirely when the list is empty for the same reason: a
+ * deployment that never configured the popover keeps matching the signatures
+ * its users already have stored.
+ */
+export declare const buildAnnouncementSignature: (content: AnnouncementContent) => string;
+//# sourceMappingURL=announcement-message.d.ts.map

package/conversation/announcement-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"announcement-message.d.ts","sourceRoot":"","sources":["../../src/conversation/announcement-message.ts"],"names":[],"mappings":"AA+BA,+EAA+E;AAC/E,MAAM,WAAW,wBAAwB;IACvC,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,4EAA4E;AAC5E,MAAM,WAAW,oBAAoB;IACnC,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,6DAA6D;IAC7D,IAAI,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAC;CACxC;AAED,8CAA8C;AAC9C,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACzC;AAQD,2EAA2E;AAC3E,eAAO,MAAM,wBAAwB,GAAI,MAAM,MAAM,KAAG,MACgB,CAAC;AAEzE;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,GAAI,MAAM,MAAM,KAAG,MACY,CAAC;AAK5E;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GAAI,yBAGvC,mBAAmB,KAAG,OACqB,CAAC;AAE/C,yFAAyF;AACzF,eAAO,MAAM,sBAAsB,GAAI,SAAS,mBAAmB,KAAG,OACN,CAAC;AA2BjE;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,0BAA0B,GACrC,SAAS,mBAAmB,KAC3B,MAgBF,CAAC"}

package/conversation/conversation-draft/conversation-draft-store.d.ts

@@ -0,0 +1,21 @@
+import { ConversationDraftStore, MemoryConversationDraftStoreOptions, WebStorageConversationDraftStoreOptions } from './conversation-draft';
+/**
+ * Creates a `ConversationDraftStore` over a host-chosen Web `Storage`.
+ *
+ * Every host-specific fact — which storage, which key (including any user
+ * scope), how ids are canonicalised — arrives through `options`. The store owns
+ * only the versioned JSON format of its own data
+ * (`{ version: 1, drafts: { [id]: ConversationDraft } }`), the `maxEntries`
+ * cap with oldest-first eviction, a half-eviction retry when the quota is
+ * exceeded, and silent failure: an absent or throwing storage behaves as an
+ * empty store that ignores writes.
+ */
+export declare const createWebStorageConversationDraftStore: ({ getStorage, storageKey, maxEntries, normalizeId, }: WebStorageConversationDraftStoreOptions) => ConversationDraftStore;
+/**
+ * Creates a `ConversationDraftStore` that keeps drafts in memory for the
+ * lifetime of the returned instance. Same semantics as the Web Storage store
+ * (`maxEntries`, `normalizeId`, empty-draft removal); suited to hosts that want
+ * drafts only for the page lifetime, and to tests.
+ */
+export declare const createMemoryConversationDraftStore: ({ maxEntries, normalizeId, }?: MemoryConversationDraftStoreOptions) => ConversationDraftStore;
+//# sourceMappingURL=conversation-draft-store.d.ts.map

package/conversation/conversation-draft/conversation-draft-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-draft-store.d.ts","sourceRoot":"","sources":["../../../src/conversation/conversation-draft/conversation-draft-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,sBAAsB,EACtB,mCAAmC,EACnC,uCAAuC,EACxC,MAAM,sBAAsB,CAAC;AAqE9B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sCAAsC,GAAI,sDAKpD,uCAAuC,KAAG,sBA0E5C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kCAAkC,GAAI,+BAGhD,mCAAwC,KAAG,sBAwB7C,CAAC"}

package/conversation/conversation-draft/conversation-draft-store.js

@@ -0,0 +1,84 @@
+//#region src/conversation/conversation-draft/conversation-draft-store.ts
+var e = (e) => e, t = (e) => e.text.trim() === "" && e.skills.length === 0, n = (e) => {
+	if (typeof e != "object" || !e) return !1;
+	let t = e;
+	return typeof t.text == "string" && Array.isArray(t.skills) && typeof t.updatedAt == "number";
+}, r = (e, t) => Object.hasOwn(e, t) ? e[t] : void 0, i = (e) => Object.keys(e).sort((t, n) => e[t].updatedAt - e[n].updatedAt), a = (e, t) => {
+	let n = i(e), r = n.length - Math.max(t, 0);
+	if (r <= 0) return e;
+	let a = { ...e };
+	return n.slice(0, r).forEach((e) => delete a[e]), a;
+}, o = (e, n, r, i) => {
+	let o = { ...e };
+	return t(r) ? (delete o[n], o) : (o[n] = r, a(o, i));
+}, s = (e) => e instanceof DOMException && (e.name === "QuotaExceededError" || e.name === "NS_ERROR_DOM_QUOTA_REACHED"), c = ({ getStorage: t, storageKey: c, maxEntries: l = 50, normalizeId: u = e }) => {
+	let d = () => {
+		try {
+			return t();
+		} catch {
+			return;
+		}
+	}, f = () => {
+		try {
+			let e = d()?.getItem(c);
+			if (!e) return {};
+			let t = JSON.parse(e);
+			return t == null || t.version !== 1 || t.drafts == null || typeof t.drafts != "object" ? {} : Object.fromEntries(Object.entries(t.drafts).filter(([, e]) => n(e)));
+		} catch {
+			return {};
+		}
+	}, p = (e, t) => {
+		if (Object.keys(t).length === 0) {
+			e.removeItem(c);
+			return;
+		}
+		let n = {
+			version: 1,
+			drafts: t
+		};
+		e.setItem(c, JSON.stringify(n));
+	}, m = (e) => {
+		let t = d();
+		if (t) try {
+			p(t, e);
+		} catch (n) {
+			if (!s(n)) return;
+			try {
+				let n = i(e);
+				p(t, a(e, Math.floor(n.length / 2)));
+			} catch {}
+		}
+	};
+	return {
+		read: (e) => r(f(), u(e)),
+		write: (e, t) => m(o(f(), u(e), t, l)),
+		remove: (e) => {
+			let t = f(), n = u(e);
+			Object.hasOwn(t, n) && (delete t[n], m(t));
+		},
+		clear: () => {
+			try {
+				d()?.removeItem(c);
+			} catch {}
+		}
+	};
+}, l = ({ maxEntries: t = 50, normalizeId: n = e } = {}) => {
+	let i = {};
+	return {
+		read: (e) => r(i, n(e)),
+		write: (e, r) => {
+			i = o(i, n(e), r, t);
+		},
+		remove: (e) => {
+			let t = n(e);
+			if (!Object.hasOwn(i, t)) return;
+			let r = { ...i };
+			delete r[t], i = r;
+		},
+		clear: () => {
+			i = {};
+		}
+	};
+};
+//#endregion
+export { l as createMemoryConversationDraftStore, c as createWebStorageConversationDraftStore };

package/conversation/conversation-draft/conversation-draft.d.ts

@@ -0,0 +1,48 @@
+import { RequestSkill } from '@epam/ai-dial-chat-shared';
+/** An unsent composer draft kept for one conversation. */
+export interface ConversationDraft {
+    /** The composer text as the user left it. */
+    text: string;
+    /** Skills mentioned in the draft, in the same shape a sent message carries. */
+    skills: RequestSkill[];
+    /** Epoch milliseconds of the last change; the oldest entry is evicted first. */
+    updatedAt: number;
+}
+/**
+ * Synchronous, never-throwing persistence contract for conversation drafts.
+ *
+ * The host creates and owns the instance: it decides the storage medium, the
+ * key, the user scope and how conversation ids are canonicalised. A host with
+ * async persistence wraps it behind a synchronous in-memory cache, because the
+ * restore runs before the user can type and the flush on unmount must finish
+ * synchronously.
+ */
+export interface ConversationDraftStore {
+    /** Returns the stored draft for `conversationId`, or `undefined` when there is none. */
+    read: (conversationId: string) => ConversationDraft | undefined;
+    /** Stores `draft` for `conversationId`; an empty draft removes the entry instead. */
+    write: (conversationId: string, draft: ConversationDraft) => void;
+    /** Removes the draft for `conversationId`. */
+    remove: (conversationId: string) => void;
+    /** Removes every draft the store holds. */
+    clear: () => void;
+}
+/** Options shared by both store factories. */
+export interface MemoryConversationDraftStoreOptions {
+    /** Maximum number of drafts kept; the oldest-`updatedAt` entry is evicted beyond it. Defaults to `50`. */
+    maxEntries?: number;
+    /** Canonicalises a conversation id before it is used as an entry key. Defaults to identity. */
+    normalizeId?: (conversationId: string) => string;
+}
+/** Options for `createWebStorageConversationDraftStore`. */
+export interface WebStorageConversationDraftStoreOptions extends MemoryConversationDraftStoreOptions {
+    /**
+     * Returns the `Storage` to use, or `undefined` when none is available. It is
+     * a getter so an absent or throwing storage accessor (SSR, tests, blocked
+     * site data) is handled inside the store's guard.
+     */
+    getStorage: () => Storage | undefined;
+    /** The single key all drafts are written under, including any user scope the host needs. */
+    storageKey: string;
+}
+//# sourceMappingURL=conversation-draft.d.ts.map

package/conversation/conversation-draft/conversation-draft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-draft.d.ts","sourceRoot":"","sources":["../../../src/conversation/conversation-draft/conversation-draft.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,sBAAsB;IACrC,wFAAwF;IACxF,IAAI,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,iBAAiB,GAAG,SAAS,CAAC;IAChE,qFAAqF;IACrF,KAAK,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAClE,8CAA8C;IAC9C,MAAM,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,2CAA2C;IAC3C,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,8CAA8C;AAC9C,MAAM,WAAW,mCAAmC;IAClD,0GAA0G;IAC1G,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+FAA+F;IAC/F,WAAW,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,MAAM,CAAC;CAClD;AAED,4DAA4D;AAC5D,MAAM,WAAW,uCAAwC,SAAQ,mCAAmC;IAClG;;;;OAIG;IACH,UAAU,EAAE,MAAM,OAAO,GAAG,SAAS,CAAC;IACtC,4FAA4F;IAC5F,UAAU,EAAE,MAAM,CAAC;CACpB"}

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

@@ -0,0 +1,10 @@
+/**
+ * Runs `worker` over `items` with at most `limit` concurrent invocations.
+ * Preserves no particular result order beyond "worker completed"; a worker
+ * that returns `undefined`, or throws, contributes nothing to the result
+ * array (used to skip failed/invalid items without aborting the whole
+ * batch) — a throwing worker is caught here so the other concurrent items
+ * keep being tracked instead of continuing unobserved in the background.
+ */
+export declare const runWithConcurrency: <T, R>(items: T[], limit: number, worker: (item: T) => Promise<R | undefined>) => Promise<R[]>;
+//# sourceMappingURL=async.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../../../src/conversation/conversation-transfer/async.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAAU,CAAC,EAAE,CAAC,EAC3C,OAAO,CAAC,EAAE,EACV,OAAO,MAAM,EACb,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,KAC1C,OAAO,CAAC,CAAC,EAAE,CAqBb,CAAC"}

package/conversation/conversation-transfer/attachment-refs.d.ts

@@ -0,0 +1,50 @@
+import { Annotation, Conversation } from '@epam/ai-dial-chat-shared';
+/**
+ * The reference fields shared by every attachment shape a conversation can
+ * carry — `MessageAttachment` on a message or a stage, and
+ * `AttachmentResource` on a citation's source.
+ */
+export interface AttachmentReference {
+    /** DIAL file id (`files/{bucket}/{path}`), optionally with a trailing `#…` anchor. */
+    url?: string;
+    /** Alternate reference resource, same shape as `url`. */
+    reference_url?: string;
+    /** Display name shown in the UI. */
+    title?: string;
+}
+/**
+ * Splits a DIAL file reference into the resource id and its trailing `#…`
+ * anchor (e.g. the `#page=3` a PDF citation carries). An anchor outside
+ * {@link SAFE_ANCHOR_PATTERN} is reported as absent; the file id is returned
+ * either way, so the attachment itself is still transferred.
+ *
+ * The anchor is display metadata, not part of the stored resource path: the
+ * download endpoint 404s on it, so it has to be stripped before a reference
+ * is resolved to `{bucket, path}` — and restored afterwards, so an imported
+ * citation still opens the page it cited.
+ */
+export declare const splitFileIdAnchor: (url: string) => {
+    fileId: string;
+    anchor: string;
+};
+/**
+ * Applies `mapAnnotation` to every readable entry of the citation pool,
+ * keeping unreadable entries and every other `customViewState` key as they
+ * are. Returns `conversation` itself when no entry changed, so a caller can
+ * tell by identity that the pool needed no work.
+ */
+export declare const mapAnnotationPool: (conversation: Conversation, mapAnnotation: (annotation: Annotation) => Annotation) => Conversation;
+/** A unique DIAL file reference found in a conversation's messages. */
+export interface AttachmentRef {
+    fileId: string;
+}
+/**
+ * Collects unique attachment references across all messages — message
+ * attachments, stage attachments, and citation source documents — and the
+ * conversation-level citation pool, with any
+ * `#…` anchor stripped. The same file can be referenced more than once (by a
+ * later turn, by a stage and the message it belongs to, or by several
+ * citations), so dedupe by file id and process it only once.
+ */
+export declare const collectAttachmentRefs: (conversation: Conversation) => AttachmentRef[];
+//# sourceMappingURL=attachment-refs.d.ts.map

package/conversation/conversation-transfer/attachment-refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-refs.d.ts","sourceRoot":"","sources":["../../../src/conversation/conversation-transfer/attachment-refs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAK1E;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,sFAAsF;IACtF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAeD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,GAC5B,KAAK,MAAM,KACV;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CASlC,CAAC;AAqBF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC5B,cAAc,YAAY,EAC1B,eAAe,CAAC,UAAU,EAAE,UAAU,KAAK,UAAU,KACpD,YAgBF,CAAC;AAEF,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB;AAgDD;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAChC,cAAc,YAAY,KACzB,aAAa,EAef,CAAC"}

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