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

package/conversation/useConversationImport/useConversationImport.d.ts

@@ -0,0 +1,54 @@
+import { ConversationsApi, FilesApi } from '@epam/ai-dial-chat-api-client';
+import { ConversationTransferJob } from '@epam/ai-dial-chat-shared';
+import { ConversationTransferErrorEvent, ConversationTransferSuccessEvent, ConversationTransferWarningEvent } from '../conversation-transfer/types';
+/** Parameters for {@link useConversationImport}. */
+export interface UseConversationImportParams {
+    /** Already-configured generated-client instance used to persist imported conversations. */
+    conversationsApi: Pick<ConversationsApi, 'saveConversation'>;
+    /** Already-configured generated-client instance used to list/upload attachments. */
+    filesApi: Pick<FilesApi, 'listFiles' | 'uploadFile'>;
+    /** The current user's DIAL Core storage bucket. Import fails with `MissingBucket` when `undefined`. */
+    bucket: string | undefined;
+    /** Called after at least one conversation in a job was imported successfully. */
+    onImported?: () => Promise<void> | void;
+    /** Classifies a thrown error as unauthorized. Host-owned error taxonomy; defaults to never. */
+    classifyTransferError?: (error: unknown) => {
+        isUnauthorized?: boolean;
+    };
+    /** Resolves a trace id for a failing request, for display in an error notification. */
+    resolveErrorTraceId?: (error: unknown) => Promise<string | undefined>;
+    /** Called when a job completes with at least one successfully imported conversation. */
+    onSuccess?: (event: ConversationTransferSuccessEvent) => void;
+    /** Called when a job succeeds but had to skip an attachment. */
+    onWarning?: (event: ConversationTransferWarningEvent) => void;
+    /** Called when a job fails, or when some conversations within it failed. */
+    onError?: (event: ConversationTransferErrorEvent) => void;
+}
+/** Return value of {@link useConversationImport}. */
+export interface UseConversationImportResult {
+    /** Import jobs, most recently added last. Multiple jobs can be in progress concurrently. */
+    jobs: ConversationTransferJob[];
+    /** Parses the given file and starts importing it as a new job. */
+    importConversations: (file: File) => Promise<void>;
+    /** Aborts a job's underlying requests and marks it canceled, keeping it in `jobs`. */
+    cancelJob: (jobId: string) => void;
+    /** Removes a job from the queue. If still in progress, aborts its underlying requests. */
+    dismissJob: (jobId: string) => void;
+    /** Re-attempts a failed or canceled job in place (same job id, reusing the already-parsed file). */
+    retryJob: (jobId: string) => void;
+    /** Aborts all in-progress jobs and clears the entire queue. */
+    dismissAll: () => void;
+}
+/**
+ * Owns the import job queue: parses a selected export file (`.json` or
+ * `.dial`/`.zip`, v5 envelope, old- or new-chat origin) once per file, then
+ * re-uploads any archive attachments to `uploads/<YYYY-MM>/` —
+ * disambiguating a name collision with a ` (n)` suffix instead of rejecting
+ * it — rewrites attachment references (and renamed titles), drops any
+ * reference still pointing into another user's bucket, regenerates each
+ * conversation's id/path with a fresh UUID (collision-free save, no replace
+ * dialog), and persists every conversation through the injected
+ * `conversationsApi`. One job per imported file, not per conversation.
+ */
+export declare const useConversationImport: ({ conversationsApi, filesApi, bucket, onImported, classifyTransferError, resolveErrorTraceId, onSuccess, onWarning, onError, }: UseConversationImportParams) => UseConversationImportResult;
+//# sourceMappingURL=useConversationImport.d.ts.map

package/conversation/useConversationImport/useConversationImport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversationImport.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationImport/useConversationImport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,gBAAgB,EAChB,QAAQ,EACT,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,KAAK,uBAAuB,EAK7B,MAAM,2BAA2B,CAAC;AAwBnC,OAAO,EACL,KAAK,8BAA8B,EACnC,KAAK,gCAAgC,EAErC,KAAK,gCAAgC,EACtC,MAAM,gCAAgC,CAAC;AAgExC,oDAAoD;AACpD,MAAM,WAAW,2BAA2B;IAC1C,2FAA2F;IAC3F,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;IAC7D,oFAAoF;IACpF,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,YAAY,CAAC,CAAC;IACrD,uGAAuG;IACvG,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACxC,+FAA+F;IAC/F,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK;QAAE,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACzE,uFAAuF;IACvF,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACtE,wFAAwF;IACxF,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,gCAAgC,KAAK,IAAI,CAAC;IAC9D,gEAAgE;IAChE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,gCAAgC,KAAK,IAAI,CAAC;IAC9D,4EAA4E;IAC5E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,8BAA8B,KAAK,IAAI,CAAC;CAC3D;AA8GD,qDAAqD;AACrD,MAAM,WAAW,2BAA2B;IAC1C,4FAA4F;IAC5F,IAAI,EAAE,uBAAuB,EAAE,CAAC;IAChC,kEAAkE;IAClE,mBAAmB,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,sFAAsF;IACtF,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,0FAA0F;IAC1F,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,oGAAoG;IACpG,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,+DAA+D;IAC/D,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,GAAI,gIAUnC,2BAA2B,KAAG,2BA+ThC,CAAC"}

package/conversation/useConversationImport/useConversationImport.js

@@ -21,8 +21,9 @@ var x = 5, S = 5, C = (e) => /\.(dial|zip)$/i.test(e.name), w = (e) => new Promi
 			isArchive: !0
 		};
 	}
+	let t = await w(e);
 	return {
-		history: a(await w(e)).history,
+		history: a(t).history,
 		attachments: /* @__PURE__ */ new Map(),
 		isArchive: !1
 	};
@@ -168,32 +169,31 @@ var x = 5, S = 5, C = (e) => /\.(dial|zip)$/i.test(e.name), w = (e) => new Promi
 			k(A.length + j.length);
 		}
 		if (!m.aborted) {
-			if (N) {
-				D?.({
+			if (N) D?.({
+				jobId: n,
+				code: g.Unauthorized
+			}), O.failJob(n, g.Unauthorized);
+			else {
+				if (A.length > 0) {
+					try {
+						await h?.();
+					} catch {}
+					C?.({
+						jobId: n,
+						titles: A
+					});
+				}
+				j.length > 0 && D?.({
 					jobId: n,
-					code: g.Unauthorized
-				}), O.failJob(n, g.Unauthorized);
-				return;
-			}
-			if (A.length > 0) {
-				try {
-					await h?.();
-				} catch {}
-				C?.({
+					code: g.Unknown,
+					titles: j,
+					traceId: P
+				}), M.size > 0 && w?.({
 					jobId: n,
-					titles: A
-				});
+					code: t.AttachmentSkipped,
+					names: [...M]
+				}), j.length > 0 ? O.failJob(n, g.Unknown) : M.size > 0 ? O.warnJob(n, t.AttachmentSkipped, [...M]) : O.succeedJob(n);
 			}
-			j.length > 0 && D?.({
-				jobId: n,
-				code: g.Unknown,
-				titles: j,
-				traceId: P
-			}), M.size > 0 && w?.({
-				jobId: n,
-				code: t.AttachmentSkipped,
-				names: [...M]
-			}), j.length > 0 ? O.failJob(n, g.Unknown) : M.size > 0 ? O.warnJob(n, t.AttachmentSkipped, [...M]) : O.succeedJob(n);
 		}
 	}, [
 		u,

package/conversation/useConversationLookupMaps/useConversationLookupMaps.d.ts

@@ -0,0 +1,24 @@
+import { ConversationListItemDto } from '@epam/ai-dial-chat-api-client';
+/** Parameters for `useConversationLookupMaps`. */
+export interface UseConversationLookupMapsParams {
+    /** Raw conversation list from the API. */
+    items: ConversationListItemDto[];
+    /** Converts a raw conversation id to the panel-space id. App-specific. */
+    toPanelConversationId: (id: string) => string;
+}
+/** Stable reverse-lookup maps returned by `useConversationLookupMaps`. */
+export interface ConversationLookupMaps {
+    /** Returns the raw context id for a panel-space conversation id, or `undefined` when not found. */
+    toContextId: (panelId: string) => string | undefined;
+    /** Returns the raw `ConversationListItemDto` for a panel-space conversation id, or `undefined` when not found. */
+    getRawItem: (panelId: string) => ConversationListItemDto | undefined;
+}
+/**
+ * Builds two memoised reverse-lookup maps from the raw conversation list:
+ * panel-space id → context id and panel-space id → raw DTO.
+ *
+ * Replaces the inlined `panelToContextId` map and `items.find` calls that
+ * previously appeared at each row-action call site in `ConversationPanelView`.
+ */
+export declare const useConversationLookupMaps: ({ items, toPanelConversationId, }: UseConversationLookupMapsParams) => ConversationLookupMaps;
+//# sourceMappingURL=useConversationLookupMaps.d.ts.map

package/conversation/useConversationLookupMaps/useConversationLookupMaps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversationLookupMaps.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationLookupMaps/useConversationLookupMaps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAG7E,kDAAkD;AAClD,MAAM,WAAW,+BAA+B;IAC9C,0CAA0C;IAC1C,KAAK,EAAE,uBAAuB,EAAE,CAAC;IACjC,0EAA0E;IAC1E,qBAAqB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;CAC/C;AAED,0EAA0E;AAC1E,MAAM,WAAW,sBAAsB;IACrC,mGAAmG;IACnG,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACrD,kHAAkH;IAClH,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,uBAAuB,GAAG,SAAS,CAAC;CACtE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GAAI,mCAGvC,+BAA+B,KAAG,sBAaD,CAAC"}

package/conversation/useConversationPanelItems/useConversationPanelItems.d.ts

@@ -0,0 +1,65 @@
+import { ConversationListItemDto, DeploymentItemDto } from '@epam/ai-dial-chat-api-client';
+import { ConversationKind, FilterTab } from '@epam/ai-dial-chat-shared';
+import { ReactNode } from 'react';
+/**
+ * Classifies a conversation's ownership using the shared filter-tab contract.
+ */
+export declare const getConversationSource: (item: Pick<ConversationListItemDto, "sharedWithMe" | "publishedWithMe">) => FilterTab;
+/** Resolver callbacks injected by the host app into `useConversationPanelItems`. */
+export interface UseConversationPanelItemsResolvers {
+    /** Converts a raw conversation id to the panel-space id. App-specific. */
+    toPanelConversationId: (id: string) => string;
+    /** Resolves the icon URL for a deployment. Returns `undefined` when not available. */
+    resolveIconUrl: (deployment: DeploymentItemDto | undefined) => string | undefined;
+    /**
+     * Resolves the icon tooltip text. Receives the matched deployment (or
+     * `undefined`) and a decoded fallback string derived from the model path.
+     */
+    resolveIconTooltip: (deployment: DeploymentItemDto | undefined, fallback: string) => string | undefined;
+    /** Resolves the href to navigate to when the conversation row is clicked. */
+    resolveHref: (panelConversationId: string) => string;
+    /**
+     * Returns the row presentation for a scheduled-task conversation — a
+     * host-rendered leading icon that replaces the deployment avatar, and the
+     * unread flag — or `undefined` for an ordinary conversation.
+     */
+    resolveTaskPresentation?: (item: ConversationListItemDto) => {
+        leadingIcon?: ReactNode;
+        isUnread: boolean;
+    } | undefined;
+}
+/** Parameters accepted by `useConversationPanelItems`. */
+export interface UseConversationPanelItemsParams extends UseConversationPanelItemsResolvers {
+    /** Raw conversation list from the API. */
+    items: ConversationListItemDto[];
+    /** Available deployments used to resolve icons and tooltips. */
+    deployments: DeploymentItemDto[];
+    /** Whether the deployments list is still loading (drives `isIconLoading`). */
+    isDeploymentsLoading: boolean;
+}
+/**
+ * Maps raw `ConversationListItemDto[]` to panel-compatible conversation items.
+ *
+ * Returns a memoised array whose shape is compatible with the conversation
+ * panel's item contract. All app-specific concerns (icon URL resolution,
+ * route generation, id normalisation) are injected via resolver callbacks.
+ *
+ * While every input except `items` is unchanged, a DTO that is referentially
+ * the same as in the previous render maps to the same item object, so a list
+ * change (or a navigation that re-derives the list) re-renders only the rows
+ * whose DTO actually changed.
+ */
+export declare const useConversationPanelItems: ({ items, deployments, isDeploymentsLoading, toPanelConversationId, resolveIconUrl, resolveIconTooltip, resolveHref, resolveTaskPresentation, }: UseConversationPanelItemsParams) => {
+    leadingIcon?: ReactNode;
+    isUnread?: boolean | undefined;
+    id: string;
+    title: string;
+    isPinned: boolean;
+    iconUrl: string | undefined;
+    iconTooltip: string | undefined;
+    isIconLoading: boolean;
+    source: FilterTab;
+    kind: ConversationKind;
+    href: string;
+}[];
+//# sourceMappingURL=useConversationPanelItems.d.ts.map

package/conversation/useConversationPanelItems/useConversationPanelItems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversationPanelItems.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationPanelItems/useConversationPanelItems.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAOnE;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAChC,MAAM,IAAI,CAAC,uBAAuB,EAAE,cAAc,GAAG,iBAAiB,CAAC,KACtE,SAIF,CAAC;AAEF,oFAAoF;AACpF,MAAM,WAAW,kCAAkC;IACjD,0EAA0E;IAC1E,qBAAqB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9C,sFAAsF;IACtF,cAAc,EAAE,CACd,UAAU,EAAE,iBAAiB,GAAG,SAAS,KACtC,MAAM,GAAG,SAAS,CAAC;IACxB;;;OAGG;IACH,kBAAkB,EAAE,CAClB,UAAU,EAAE,iBAAiB,GAAG,SAAS,EACzC,QAAQ,EAAE,MAAM,KACb,MAAM,GAAG,SAAS,CAAC;IACxB,6EAA6E;IAC7E,WAAW,EAAE,CAAC,mBAAmB,EAAE,MAAM,KAAK,MAAM,CAAC;IACrD;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,CACxB,IAAI,EAAE,uBAAuB,KAC1B;QAAE,WAAW,CAAC,EAAE,SAAS,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;CACjE;AAED,0DAA0D;AAC1D,MAAM,WAAW,+BAAgC,SAAQ,kCAAkC;IACzF,0CAA0C;IAC1C,KAAK,EAAE,uBAAuB,EAAE,CAAC;IACjC,gEAAgE;IAChE,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,8EAA8E;IAC9E,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AA+BD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,yBAAyB,GAAI,gJASvC,+BAA+B;;;;;;;;;;;;GAoFjC,CAAC"}

package/conversation/useConversationPanelItems/useConversationPanelItems.js

@@ -1,53 +1,57 @@
 import { safeDecodeURIComponent as e } from "../../shared/string-utils.js";
 import { getModelIdCandidatesFromConversationId as t, getModelIdFromConversationId as n } from "../get-model-id-from-conversation-id.js";
-import { FilterTab as r } from "@epam/ai-dial-chat-shared";
-import { useEffect as i, useMemo as a, useRef as o } from "react";
+import { ConversationKind as r, FilterTab as i } from "@epam/ai-dial-chat-shared";
+import { useEffect as a, useMemo as o, useRef as s } from "react";
 //#region src/conversation/useConversationPanelItems/useConversationPanelItems.ts
-var s = (e) => e.sharedWithMe ? r.Shared : e.publishedWithMe ? r.Organization : r.MyChats, c = (e) => {
+var c = (e) => e.sharedWithMe ? i.Shared : e.publishedWithMe ? i.Organization : i.MyChats, l = (e) => {
 	let t = /* @__PURE__ */ new Map(), n = /* @__PURE__ */ new Map();
 	for (let r of e) t.has(r.id) || t.set(r.id, r), r.reference && !n.has(r.reference) && n.set(r.reference, r);
 	return (e) => t.get(e) ?? n.get(e);
-}, l = ({ items: r, deployments: l, isDeploymentsLoading: u, toPanelConversationId: d, resolveIconUrl: f, resolveIconTooltip: p, resolveHref: m, resolveTaskPresentation: h }) => {
-	let g = a(() => c(l), [l]), _ = a(() => (r) => {
-		let i = d(r.id), a = n(r.id), o = t(r.id).map(g).find(Boolean), c = a ? e(a.split("/").pop() ?? a) : "", l = h?.(r);
+}, u = ({ items: i, deployments: u, isDeploymentsLoading: d, toPanelConversationId: f, resolveIconUrl: p, resolveIconTooltip: m, resolveHref: h, resolveTaskPresentation: g }) => {
+	let _ = o(() => l(u), [u]), v = o(() => (i) => {
+		let a = f(i.id), o = n(i.id), s = t(i.id).map(_).find(Boolean), l = o ? e(o.split("/").pop() ?? o) : "", u = g?.(i);
 		return {
-			id: i,
-			title: r.title,
-			isPinned: r.isPinned ?? !1,
-			iconUrl: f(o),
-			iconTooltip: p(o, c),
-			isIconLoading: u,
-			source: s(r),
-			href: m(i),
-			...l == null ? {} : {
-				leadingIcon: l.leadingIcon,
-				isUnread: l.isUnread
+			id: a,
+			title: i.title,
+			isPinned: i.isPinned ?? !1,
+			iconUrl: p(s),
+			iconTooltip: m(s, l),
+			isIconLoading: d,
+			source: c(i),
+			kind: u == null ? r.Chat : r.Task,
+			href: h(a),
+			...u == null ? i.isUnread ? {
+				leadingIcon: void 0,
+				isUnread: !0
+			} : {} : {
+				leadingIcon: u.leadingIcon,
+				isUnread: u.isUnread
 			}
 		};
 	}, [
-		g,
-		u,
+		_,
 		d,
 		f,
 		p,
 		m,
-		h
-	]), v = o(null), y = a(() => {
-		let e = v.current, t = e?.mapItem === _ ? e.byDto : void 0, n = /* @__PURE__ */ new Map();
+		h,
+		g
+	]), y = s(null), b = o(() => {
+		let e = y.current, t = e?.mapItem === v ? e.byDto : void 0, n = /* @__PURE__ */ new Map();
 		return {
-			mapped: r.map((e) => {
-				let r = t?.get(e) ?? _(e);
+			mapped: i.map((e) => {
+				let r = t?.get(e) ?? v(e);
 				return n.set(e, r), r;
 			}),
 			cache: {
-				mapItem: _,
+				mapItem: v,
 				byDto: n
 			}
 		};
-	}, [r, _]);
-	return i(() => {
-		v.current = y.cache;
-	}, [y]), y.mapped;
+	}, [i, v]);
+	return a(() => {
+		y.current = b.cache;
+	}, [b]), b.mapped;
 };
 //#endregion
-export { s as getConversationSource, l as useConversationPanelItems };
+export { c as getConversationSource, u as useConversationPanelItems };

package/conversation/useConversationScroll/useConversationScroll.d.ts

@@ -0,0 +1,46 @@
+import { RefObject } from 'react';
+/** Parameters for {@link useConversationScroll}. `T` is never read — only `messages.length` is used to detect growth/reset. */
+export interface UseConversationScrollParams<T> {
+    /** Messages currently rendered in the list. */
+    messages: T[];
+    /** Whether an assistant response is currently streaming in. */
+    isAssistantTyping: boolean;
+    /** Identifier of the conversation being displayed. */
+    conversationId: string;
+}
+/** Return value of {@link useConversationScroll}. */
+export interface UseConversationScrollResult {
+    /** Attach to the scrollable message-list element. */
+    containerRef: RefObject<HTMLDivElement | null>;
+    /** Attach to the element wrapping all rendered messages (used to detect content growth). */
+    contentRef: RefObject<HTMLDivElement | null>;
+    /**
+     * Attach to a spacer element, a sibling rendered right after `contentRef`
+     * inside `containerRef`. Its height is set imperatively, not via React
+     * state. Render it with `shrink-0` and an initial `style={{ height: 0 }}`.
+     */
+    spacerRef: RefObject<HTMLDivElement | null>;
+    /** Callback ref to register/unregister a rendered message's DOM node by index. */
+    setMessageRef: (index: number, el: HTMLDivElement | null) => void;
+    /** Whether the scroll-to-bottom button should be shown. */
+    isScrollButtonVisible: boolean;
+    /** Smoothly scrolls to the current bottom of the actual message content. */
+    scrollToBottom: () => void;
+    /**
+     * Arms the message at `index` to be scrolled near the top of the viewport
+     * on the next render — call right before triggering a send, regenerate,
+     * or edit-and-resubmit so the resulting message anchors near the top.
+     */
+    armAnchor: (index: number) => void;
+}
+/**
+ * Owns chat-list scrolling: anchors a new turn near the viewport top, keeps
+ * the position stable while the response streams, and reports whether the
+ * scroll-to-bottom button should be shown.
+ *
+ * The temporary spacer is technical scroll room, not user-visible content:
+ * it is sized to the minimum required to make the anchor reachable and manual
+ * scrolling is clamped before the user can move past the real message content.
+ */
+export declare const useConversationScroll: <T>({ messages, isAssistantTyping, conversationId, }: UseConversationScrollParams<T>) => UseConversationScrollResult;
+//# sourceMappingURL=useConversationScroll.d.ts.map

package/conversation/useConversationScroll/useConversationScroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversationScroll.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationScroll/useConversationScroll.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAMf,+HAA+H;AAC/H,MAAM,WAAW,2BAA2B,CAAC,CAAC;IAC5C,+CAA+C;IAC/C,QAAQ,EAAE,CAAC,EAAE,CAAC;IACd,+DAA+D;IAC/D,iBAAiB,EAAE,OAAO,CAAC;IAC3B,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,qDAAqD;AACrD,MAAM,WAAW,2BAA2B;IAC1C,qDAAqD;IACrD,YAAY,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC/C,4FAA4F;IAC5F,UAAU,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC7C;;;;OAIG;IACH,SAAS,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC5C,kFAAkF;IAClF,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,cAAc,GAAG,IAAI,KAAK,IAAI,CAAC;IAClE,2DAA2D;IAC3D,qBAAqB,EAAE,OAAO,CAAC;IAC/B,4EAA4E;IAC5E,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B;;;;OAIG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,EAAE,kDAItC,2BAA2B,CAAC,CAAC,CAAC,KAAG,2BAwTnC,CAAC"}

package/conversation/useConversationScroll/useConversationScroll.js

@@ -47,7 +47,7 @@ var a = 80, o = 1, s = ({ messages: s, isAssistantTyping: c, conversationId: l }
 		return e == null || t == null ? null : Math.max(e, t);
 	}, [j]), N = e(() => {
 		let e = f.current, t = M();
-		!e || t == null || e.scrollTop > t + o && (e.scrollTop = t);
+		e && t != null && e.scrollTop > t + o && (e.scrollTop = t);
 	}, [M]), P = e((e) => {
 		let t = m.current, n = j();
 		if (!t || n == null) return;
@@ -72,11 +72,7 @@ var a = 80, o = 1, s = ({ messages: s, isAssistantTyping: c, conversationId: l }
 		};
 		t && w();
 		let r = x.current;
-		if (r != null && y.current.has(r)) {
-			x.current = null, F(r), n();
-			return;
-		}
-		c || ((e || t) && E(!1), n());
+		r != null && y.current.has(r) ? (x.current = null, F(r), n()) : c || ((e || t) && E(!1), n());
 	}, [
 		s,
 		c,

package/conversation/useConversationStream/apply-chunk.d.ts

@@ -0,0 +1,35 @@
+import { Message, Stage, StreamChunk } from '@epam/ai-dial-chat-shared';
+/**
+ * Merges incoming stage deltas into an existing stage list, keyed by `index`.
+ *
+ * Partial `name` and `content` strings are concatenated across chunks;
+ * attachments are merged by their own `index` (concatenating partial `title`
+ * and `data`); every other field on the incoming delta overwrites the
+ * accumulated one. A brand-new stage whose first chunk carries `name: null`
+ * is normalized to `''`.
+ *
+ * Exported for hosts that keep a flattened `Stage[]` on the message instead
+ * of `Message.custom_content.stages` and therefore cannot reuse
+ * {@link applyChunkToMessages}. Prefer `useConversationStream` when the host
+ * can delegate the whole stream loop.
+ */
+export declare const mergeStages: (existing: Stage[], incoming: Stage[]) => Stage[];
+/**
+ * Applies a single SSE stream chunk to the message list.
+ *
+ *
+ * Attachments are accumulated: each chunk's attachments are appended to the
+ * existing array rather than replacing it.
+ *
+ * Annotations are merged by `index`: partial `body.title` and `body.quote`
+ * strings are concatenated across chunks, matching the same delta-merge
+ * semantics used for stages.
+ *
+ * `state` is overwritten (not merged) by each chunk that carries one,
+ * matching the DIAL stateful-app contract.
+ *
+ * @returns Updated message array, or `null` when the chunk carries no
+ *   actionable data (empty content, no form_schema, and no attachments).
+ */
+export declare const applyChunkToMessages: (messages: Message[], messageIndex: number, chunk: StreamChunk) => Message[] | null;
+//# sourceMappingURL=apply-chunk.d.ts.map

package/conversation/useConversationStream/apply-chunk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-chunk.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationStream/apply-chunk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,OAAO,EAEP,KAAK,EACL,WAAW,EACZ,MAAM,2BAA2B,CAAC;AAqFnC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW,GAAI,UAAU,KAAK,EAAE,EAAE,UAAU,KAAK,EAAE,KAAG,KAAK,EA+BvE,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,OAAO,EAAE,EACnB,cAAc,MAAM,EACpB,OAAO,WAAW,KACjB,OAAO,EAAE,GAAG,IAqEd,CAAC"}

package/conversation/useConversationStream/buffered-generation.d.ts

@@ -0,0 +1,15 @@
+import { Conversation, Message } from '@epam/ai-dial-chat-shared';
+/**
+ * A generation's assistant message accumulated while its conversation isn't
+ * the displayed one (a background stream, or a resume attach), keyed by
+ * conversation path so it can be restored once that conversation is shown
+ * again.
+ */
+export interface BufferedGeneration {
+    generationId: string;
+    messageIndex: number;
+    message: Message;
+}
+/** Restores `buffered.message` into `conversation` at `buffered.messageIndex`, merging into whatever message is already there. */
+export declare const restoreBufferedMessage: (conversation: Conversation, buffered: BufferedGeneration) => Conversation;
+//# sourceMappingURL=buffered-generation.d.ts.map

package/conversation/useConversationStream/buffered-generation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffered-generation.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationStream/buffered-generation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB;AAgBD,kIAAkI;AAClI,eAAO,MAAM,sBAAsB,GACjC,cAAc,YAAY,EAC1B,UAAU,kBAAkB,KAC3B,YAeF,CAAC"}

package/conversation/useConversationStream/conversation-path.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Strips the leading bucket segment from a conversation id and decodes any
+ * already-percent-encoded remainder back to raw, so callers that re-encode
+ * the result once (e.g. an API client) don't double-encode it on the wire.
+ */
+export declare const getConversationPath: (conversationId: string) => string;
+//# sourceMappingURL=conversation-path.d.ts.map

package/conversation/useConversationStream/conversation-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-path.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationStream/conversation-path.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,gBAAgB,MAAM,KAAG,MAO5D,CAAC"}

package/conversation/useConversationStream/conversation-path.js

@@ -1,8 +1,8 @@
 import { safeDecodeURI as e } from "../../shared/string-utils.js";
 //#region src/conversation/useConversationStream/conversation-path.ts
 var t = (t) => {
-	let n = t.indexOf("/");
-	return e(n === -1 ? t : t.substring(n + 1));
+	let n = t.indexOf("/"), r = n === -1 ? t : t.substring(n + 1);
+	return e(r);
 };
 //#endregion
 export { t as getConversationPath };

package/conversation/useConversationStream/frame-scheduler.d.ts

@@ -0,0 +1,14 @@
+/** Coalesces work per key into at most one run per animation frame. */
+export interface FrameScheduler {
+    /** Runs `task` on the next frame, replacing any task still pending for `key`. */
+    schedule: (key: string, task: () => void) => void;
+    /** Runs the task pending for `key` now, if any; it will not run again. */
+    flush: (key: string) => void;
+    /** Drops the task pending for `key` without running it. */
+    cancel: (key: string) => void;
+    /** Drops every pending task without running it. */
+    cancelAll: () => void;
+}
+/** Returns a scheduler that runs the latest task per key once per animation frame. */
+export declare const createFrameScheduler: () => FrameScheduler;
+//# sourceMappingURL=frame-scheduler.d.ts.map

package/conversation/useConversationStream/frame-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-scheduler.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationStream/frame-scheduler.ts"],"names":[],"mappings":"AAGA,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B,iFAAiF;IACjF,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IAClD,0EAA0E;IAC1E,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,2DAA2D;IAC3D,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,mDAAmD;IACnD,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAgBD,sFAAsF;AACtF,eAAO,MAAM,oBAAoB,QAAO,cAmCvC,CAAC"}

package/conversation/useConversationStream/frame-scheduler.js

@@ -1,19 +1,19 @@
 //#region src/conversation/useConversationStream/frame-scheduler.ts
-var e = 16, t = (t) => {
+var e = (e) => {
 	if (typeof requestAnimationFrame == "function") {
-		let e = requestAnimationFrame(t);
-		return () => cancelAnimationFrame(e);
+		let t = requestAnimationFrame(e);
+		return () => cancelAnimationFrame(t);
 	}
-	let n = setTimeout(t, e);
-	return () => clearTimeout(n);
-}, n = () => {
-	let e = /* @__PURE__ */ new Map(), n = (t) => {
-		let n = e.get(t);
-		n && (e.delete(t), n.task());
+	let t = setTimeout(e, 16);
+	return () => clearTimeout(t);
+}, t = () => {
+	let t = /* @__PURE__ */ new Map(), n = (e) => {
+		let n = t.get(e);
+		n && (t.delete(e), n.task());
 	};
 	return {
 		schedule: (r, i) => {
-			let a = e.get(r);
+			let a = t.get(r);
 			if (a) {
 				a.task = i;
 				return;
@@ -22,18 +22,18 @@ var e = 16, t = (t) => {
 				task: i,
 				cancelFrame: () => void 0
 			};
-			e.set(r, o), o.cancelFrame = t(() => n(r));
+			t.set(r, o), o.cancelFrame = e(() => n(r));
 		},
-		flush: (t) => {
-			e.get(t)?.cancelFrame(), n(t);
+		flush: (e) => {
+			t.get(e)?.cancelFrame(), n(e);
 		},
-		cancel: (t) => {
-			e.get(t)?.cancelFrame(), e.delete(t);
+		cancel: (e) => {
+			t.get(e)?.cancelFrame(), t.delete(e);
 		},
 		cancelAll: () => {
-			e.forEach((e) => e.cancelFrame()), e.clear();
+			t.forEach((e) => e.cancelFrame()), t.clear();
 		}
 	};
 };
 //#endregion
-export { n as createFrameScheduler };
+export { t as createFrameScheduler };