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

package/conversation/message-utils.js

@@ -7,24 +7,28 @@ var i = (t, n, r, i) => i && n === r - 1 && t.role === e.Assistant, a = (e) => {
 		if (i.deploymentId) return i.deploymentId;
 	}
 	return null;
-}, o = (t) => t.role === e.Assistant && (t.custom_content?.stages?.length ?? 0) > 0, s = (t) => {
+}, o = (e, t) => {
+	let i = [], a = t;
+	for (let t of e) r(t) && t.custom_content?.event_type === n.ModelChanged && (a = t.custom_content.new_deployment_id), i.push(t.deploymentId ?? a);
+	return i;
+}, s = (t) => t.role === e.Assistant && (t.custom_content?.stages?.length ?? 0) > 0, c = (t) => {
 	for (let n = t.length - 1; n >= 0; n--) if (t[n].role === e.User) return t[n].custom_content?.configuration_value;
-}, c = (e) => {
+}, l = (e) => {
 	if (typeof e.default == "boolean") return e.default;
 	let t = e.oneOf;
 	if (Array.isArray(t) && t.length === 1) {
 		let e = t[0];
 		if (typeof e == "object" && e && "const" in e && typeof e.const == "boolean") return e.const;
 	}
-}, l = (e) => {
+}, u = (e) => {
 	let t = e?.properties;
 	if (t == null) return;
 	let n = Object.entries(t).flatMap(([e, t]) => {
-		let n = c(t);
+		let n = l(t);
 		return n === void 0 ? [] : [[e, n]];
 	});
 	return n.length > 0 ? Object.fromEntries(n) : void 0;
-}, u = (t) => {
+}, d = (t) => {
 	let n = -1;
 	for (let r = t.length - 1; r >= 0; r--) if (t[r].role === e.User) {
 		n = r;
@@ -34,23 +38,23 @@ var i = (t, n, r, i) => i && n === r - 1 && t.role === e.Assistant, a = (e) => {
 	for (let i = n + 1; i < t.length; i++) {
 		let n = t[i];
 		if (n.role !== e.Assistant) continue;
-		let a = l(n.custom_content?.form_schema);
+		let a = u(n.custom_content?.form_schema);
 		a && (r = {
 			...r,
 			...a
 		});
 	}
 	return r;
-}, d = (t, n, r) => {
+}, f = (t, n, r) => {
 	let i = n.length - 1, a = n[i];
 	if (a?.role !== e.Assistant) return;
-	let o = l(a.custom_content?.form_schema);
+	let o = u(a.custom_content?.form_schema);
 	if (!o) return;
 	let s = Object.fromEntries(r.filter((e) => e in o).sort().map((e) => [e, o[e]]));
 	if (Object.keys(s).length !== 0) return {
 		key: `${t}|${i}|${JSON.stringify(s)}`,
 		values: s
 	};
-}, f = (e) => (e ?? "").toLowerCase().replace(/[^a-z]/g, "") === "plaintext" ? t.PlainText : t.Markdown;
+}, p = (e) => (e ?? "").toLowerCase().replace(/[^a-z]/g, "") === "plaintext" ? t.PlainText : t.Markdown;
 //#endregion
-export { d as getFormSchemaToolSyncKey, a as getLastDeploymentId, s as getLastUserMessageToolConfiguration, u as getLatestToolConfiguration, l as getToolConfigurationFromFormSchema, i as isMessageStreaming, o as messageHasStages, f as normalizeResponseFormat };
+export { o as getEffectiveDeploymentIds, f as getFormSchemaToolSyncKey, a as getLastDeploymentId, c as getLastUserMessageToolConfiguration, d as getLatestToolConfiguration, u as getToolConfigurationFromFormSchema, i as isMessageStreaming, s as messageHasStages, p as normalizeResponseFormat };

package/conversation/overlay-messages.d.ts

@@ -0,0 +1,5 @@
+import { OverlayChatMessage } from '@epam/ai-dial-chat-overlay';
+import { Message } from '@epam/ai-dial-chat-shared';
+/** Maps chat messages to the DIAL Chat Overlay protocol's message shape. */
+export declare const toOverlayMessages: (messages: Message[]) => OverlayChatMessage[];
+//# sourceMappingURL=overlay-messages.d.ts.map

package/conversation/overlay-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-messages.d.ts","sourceRoot":"","sources":["../../src/conversation/overlay-messages.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,kBAAkB,EAGxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,KAAK,OAAO,EAGb,MAAM,2BAA2B,CAAC;AAsCnC,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,GAAI,UAAU,OAAO,EAAE,KAAG,kBAAkB,EAStE,CAAC"}

package/conversation/quick-app-conversation-starters.d.ts

@@ -0,0 +1,10 @@
+import { StarterOption } from '@epam/ai-dial-chat-shared';
+/** Resolved Quick App conversation-starter settings. */
+export interface QuickAppConversationStartersSettings {
+    starters: StarterOption[];
+    introText: string | undefined;
+    isChatMessageInputDisabled: boolean;
+}
+/** Parses a Quick App's raw `conversationStarters` schema value into starter options. */
+export declare const getQuickAppConversationStarters: (conversationStarters: unknown) => QuickAppConversationStartersSettings;
+//# sourceMappingURL=quick-app-conversation-starters.d.ts.map

package/conversation/quick-app-conversation-starters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-app-conversation-starters.d.ts","sourceRoot":"","sources":["../../src/conversation/quick-app-conversation-starters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,wDAAwD;AACxD,MAAM,WAAW,oCAAoC;IACnD,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,0BAA0B,EAAE,OAAO,CAAC;CACrC;AAWD,yFAAyF;AACzF,eAAO,MAAM,+BAA+B,GAC1C,sBAAsB,OAAO,KAC5B,oCAuCF,CAAC"}

package/conversation/scheduled-task-grouping.d.ts

@@ -0,0 +1,48 @@
+/** Timestamped conversation used for immutable scheduled-run grouping. */
+export interface ScheduledTaskConversation {
+    /** Host conversation identity. */
+    id: string;
+    /** Creation timestamp; absent values sort last. */
+    createdAt?: number;
+    /** Last update timestamp. */
+    updatedAt: number;
+}
+/** Host policies for grouping scheduled runs. */
+export interface GroupScheduledTaskConversationsOptions<T> {
+    /** Owner-qualified task key, or undefined for an ordinary conversation. */
+    getGroupKey: (item: T) => string | undefined;
+    /** Whether this item may be hidden behind another run. */
+    isCollapsible: (item: T) => boolean;
+    /** Compares host IDs, including their encoding variants. */
+    conversationIdsMatch: (left: string, right: string) => boolean;
+}
+/** Grouping policies and the currently active conversation. */
+export interface CollapseScheduledTaskConversationsOptions<T> extends GroupScheduledTaskConversationsOptions<T> {
+    /** Active conversation identity, when present. */
+    activeConversationId?: string;
+}
+/** A grouped run and its representative status. */
+export interface ScheduledTaskRun<T> {
+    /** Original conversation object. */
+    item: T;
+    /** Host-provided task key. */
+    groupKey: string;
+    /** Whether this is the group's newest run. */
+    isRepresentative: boolean;
+}
+/** Immutable grouping reusable across active-conversation changes. */
+export interface ScheduledTaskGrouping<T> extends GroupScheduledTaskConversationsOptions<T> {
+    /** Collapsed conversations in original order. */
+    collapsed: T[];
+    /** Eligible runs in original order. */
+    runs: ScheduledTaskRun<T>[];
+    /** Complete original list. */
+    items: readonly T[];
+}
+/** Selects each eligible group's newest run, preserving input order and objects. */
+export declare const groupScheduledTaskConversations: <T extends ScheduledTaskConversation>(items: readonly T[], options: GroupScheduledTaskConversationsOptions<T>) => ScheduledTaskGrouping<T>;
+/** Substitutes an active older run; returns the original collapsed array when unchanged. */
+export declare const applyActiveScheduledTaskRun: <T extends ScheduledTaskConversation>(grouping: ScheduledTaskGrouping<T>, activeConversationId: string | undefined) => T[];
+/** Collapses scheduled runs using host policies and the active conversation. */
+export declare const collapseScheduledTaskConversations: <T extends ScheduledTaskConversation>(items: readonly T[], options: CollapseScheduledTaskConversationsOptions<T>) => T[];
+//# sourceMappingURL=scheduled-task-grouping.d.ts.map

package/conversation/scheduled-task-grouping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-task-grouping.d.ts","sourceRoot":"","sources":["../../src/conversation/scheduled-task-grouping.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,MAAM,WAAW,yBAAyB;IACxC,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,iDAAiD;AACjD,MAAM,WAAW,sCAAsC,CAAC,CAAC;IACvD,2EAA2E;IAC3E,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;IAC7C,0DAA0D;IAC1D,aAAa,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;IACpC,4DAA4D;IAC5D,oBAAoB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;CAChE;AAED,+DAA+D;AAC/D,MAAM,WAAW,yCAAyC,CACxD,CAAC,CACD,SAAQ,sCAAsC,CAAC,CAAC,CAAC;IACjD,kDAAkD;IAClD,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,mDAAmD;AACnD,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,oCAAoC;IACpC,IAAI,EAAE,CAAC,CAAC;IACR,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,sEAAsE;AACtE,MAAM,WAAW,qBAAqB,CACpC,CAAC,CACD,SAAQ,sCAAsC,CAAC,CAAC,CAAC;IACjD,iDAAiD;IACjD,SAAS,EAAE,CAAC,EAAE,CAAC;IACf,uCAAuC;IACvC,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5B,8BAA8B;IAC9B,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;CACrB;AA0BD,oFAAoF;AACpF,eAAO,MAAM,+BAA+B,GAC1C,CAAC,SAAS,yBAAyB,EAEnC,OAAO,SAAS,CAAC,EAAE,EACnB,SAAS,sCAAsC,CAAC,CAAC,CAAC,KACjD,qBAAqB,CAAC,CAAC,CAqBzB,CAAC;AAEF,4FAA4F;AAC5F,eAAO,MAAM,2BAA2B,GACtC,CAAC,SAAS,yBAAyB,EAEnC,UAAU,qBAAqB,CAAC,CAAC,CAAC,EAClC,sBAAsB,MAAM,GAAG,SAAS,KACvC,CAAC,EAYH,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,kCAAkC,GAC7C,CAAC,SAAS,yBAAyB,EAEnC,OAAO,SAAS,CAAC,EAAE,EACnB,SAAS,yCAAyC,CAAC,CAAC,CAAC,KACpD,CAAC,EAID,CAAC"}

package/conversation/scheduled-task-grouping.js

@@ -0,0 +1,40 @@
+//#region src/conversation/scheduled-task-grouping.ts
+var e = (e, t) => {
+	let n = e.createdAt ?? -Infinity, r = t.createdAt ?? -Infinity;
+	return n === r ? e.updatedAt === t.updatedAt ? e.id === t.id ? 0 : t.id > e.id ? 1 : -1 : t.updatedAt - e.updatedAt : r > n ? 1 : -1;
+}, t = (e, t, n) => e.filter((e) => {
+	if (!n.isCollapsible(e)) return !0;
+	let r = n.getGroupKey(e);
+	return r === void 0 || t.get(r) === e;
+}), n = (n, r) => {
+	let i = /* @__PURE__ */ new Map(), a = [];
+	for (let t of n) {
+		if (!r.isCollapsible(t)) continue;
+		let n = r.getGroupKey(t);
+		if (n === void 0) continue;
+		a.push({
+			item: t,
+			groupKey: n
+		});
+		let o = i.get(n);
+		(!o || e(t, o) < 0) && i.set(n, t);
+	}
+	return {
+		...r,
+		items: n,
+		collapsed: t(n, i, r),
+		runs: a.map((e) => ({
+			...e,
+			isRepresentative: i.get(e.groupKey) === e.item
+		}))
+	};
+}, r = (e, n) => {
+	if (n === void 0) return e.collapsed;
+	let r = e.runs.find(({ item: t }) => e.conversationIdsMatch(t.id, n));
+	if (!r || r.isRepresentative) return e.collapsed;
+	let i = /* @__PURE__ */ new Map();
+	for (let t of e.runs) t.isRepresentative && i.set(t.groupKey, t.item);
+	return i.set(r.groupKey, r.item), t(e.items, i, e);
+}, i = (e, t) => r(n(e, t), t.activeConversationId);
+//#endregion
+export { r as applyActiveScheduledTaskRun, i as collapseScheduledTaskConversations, n as groupScheduledTaskConversations };

package/conversation/stage.d.ts

@@ -0,0 +1,77 @@
+import { Stage } from '@epam/ai-dial-chat-shared';
+/**
+ * One stage attachment as it arrives from the REST API or the SSE stream,
+ * before normalization: every field is optional and may be `null`.
+ */
+export interface RawStageAttachment {
+    /** Zero-based position in the attachment list. */
+    index?: number | null;
+    /** MIME type of the attachment content. */
+    type?: string | null;
+    /** Display name shown in the UI. */
+    title?: string | null;
+    /** Inline base-64 encoded content. */
+    data?: string | null;
+    /** Remote URL pointing to the attachment content. */
+    url?: string | null;
+    /** MIME type of the referenced resource. */
+    reference_type?: string | null;
+    /** URL of an alternate reference resource. */
+    reference_url?: string | null;
+}
+/**
+ * One stage as it arrives from the REST API or the SSE stream, before
+ * normalization. Structurally satisfied by the generated `StageDto` and by a
+ * raw stream delta, both of which omit `index`/`name`/`status` on the chunk
+ * that opens a stage.
+ */
+export interface RawStage {
+    /** Ordering key. Defaults to `0` when absent. */
+    index?: number | null;
+    /** Stage title. `null` on the chunk that opens the stage. */
+    name?: string | null;
+    /** Terminal state as a raw wire string; anything other than `'completed'`/`'failed'` means still running. */
+    status?: string | null;
+    /** Additional stage text. */
+    content?: string | null;
+    /** Short source/category label shown beside the stage name. */
+    tag?: string | null;
+    /** Files produced or referenced by this stage. */
+    attachments?: RawStageAttachment[] | null;
+    /**
+     * `index` of the parent stage (its array position in a complete unindexed
+     * array). Nullish means top level; `0` is a valid parent.
+     */
+    parent_stage_index?: number | null;
+}
+/**
+ * Message-like payload carrying stages under either the wire's snake_case
+ * `custom_content` or a host's camelCased `customContent`.
+ */
+export interface RawStageSource {
+    /** Custom content as the DIAL wire format spells it. */
+    custom_content?: {
+        stages?: RawStage[] | null;
+    } | null;
+    /** Custom content as a camelCasing host spells it. */
+    customContent?: {
+        stages?: RawStage[] | null;
+    } | null;
+}
+/**
+ * Returns a renderable `Stage` for one raw payload: `index` defaults to `0`,
+ * `name` to `''`, an unrecognized `status` to `null` (still running), and
+ * `content`/`tag`/`attachments`/`parent_stage_index` are passed through when
+ * present (a parent of `0` included).
+ */
+export declare const toStage: (stage: RawStage) => Stage;
+/**
+ * Returns the normalized stages of a complete raw stage array or a
+ * message-like payload (reading `custom_content.stages`, falling back to
+ * `customContent.stages`), or `undefined` when there are none. An entry
+ * without an `index` takes its array position — the identity a complete
+ * non-streaming array's `parent_stage_index` refers to — while explicit
+ * (possibly sparse) indexes are kept. Not for partial stream deltas.
+ */
+export declare const mapStages: (source: RawStage[] | RawStageSource | null | undefined) => Stage[] | undefined;
+//# sourceMappingURL=stage.d.ts.map

package/conversation/stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage.d.ts","sourceRoot":"","sources":["../../src/conversation/stage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAG1E;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,6GAA6G;IAC7G,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,kDAAkD;IAClD,WAAW,CAAC,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;IAC1C;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,cAAc,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACvD,sDAAsD;IACtD,aAAa,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CACvD;AAwBD;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,QAAQ,KAAG,KAYxC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GACpB,QAAQ,QAAQ,EAAE,GAAG,cAAc,GAAG,IAAI,GAAG,SAAS,KACrD,KAAK,EAAE,GAAG,SAUZ,CAAC"}

package/conversation/starter-option.d.ts

@@ -0,0 +1,21 @@
+import { DeploymentConfigurationSchema, StarterOption } from '@epam/ai-dial-chat-shared';
+/**
+ * Returns the text to populate in the input when a starter button is selected.
+ * Falls back to the button title if `populateText` is empty.
+ */
+export declare const getStarterPopulateText: (starter: StarterOption) => string;
+/**
+ * Extracts starter options, the schema property key (`'starter'` or `'button'`),
+ * and the optional description text from a deployment configuration schema.
+ *
+ * - `propertyKey` — `'starter'` or `'button'`; used to build `configuration_value`.
+ * - `description` — human-readable prompt shown above the buttons (only present for `button` properties).
+ *
+ * Returns an empty starters array and `undefined` fields when no matching property is found.
+ */
+export declare const getStartersFromSchema: (schema: DeploymentConfigurationSchema | null | undefined) => {
+    starters: StarterOption[];
+    propertyKey: string | undefined;
+    description: string | undefined;
+};
+//# sourceMappingURL=starter-option.d.ts.map

package/conversation/starter-option.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starter-option.d.ts","sourceRoot":"","sources":["../../src/conversation/starter-option.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC7B,aAAa,EACd,MAAM,2BAA2B,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,aAAa,KAAG,MACH,CAAC;AAE9D;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,6BAA6B,GAAG,IAAI,GAAG,SAAS,KACvD;IACD,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CA8BjC,CAAC"}

package/conversation/useActiveConversationSync/useActiveConversationSync.d.ts

@@ -0,0 +1,37 @@
+import { ConversationListItemDto } from '@epam/ai-dial-chat-api-client';
+/** Parameters for `useActiveConversationSync`. */
+export interface UseActiveConversationSyncParams {
+    /**
+     * The raw context id of the currently active conversation, as tracked by
+     * the host app. `undefined` when no conversation is active.
+     */
+    activeConversationId: string | undefined;
+    /** Raw conversation list from the API. */
+    items: ConversationListItemDto[];
+    /** Refetches the full conversation list. */
+    refreshConversations: () => Promise<void>;
+    /** Marks a scheduler-created conversation as viewed by raw context id. */
+    markConversationViewed: (id: string) => Promise<void>;
+    /**
+     * Returns `true` when two ids refer to the same conversation despite
+     * possible encoding differences. App-specific.
+     */
+    conversationIdsMatch: (a: string, b: string) => boolean;
+    /** Converts a raw context id to the panel-space id. App-specific. */
+    toPanelConversationId: (id: string) => string;
+    /** Whether the active listed conversation should be marked viewed. Defaults to marking every one. */
+    shouldMarkViewed?: (item: ConversationListItemDto) => boolean;
+}
+/**
+ * Synchronises the active conversation with the conversation list and returns
+ * the panel-space id of the active conversation, or `undefined` when none is active.
+ *
+ * Side effects:
+ * 1. If the active conversation is not present in the list, requests a
+ *    refresh. The list and refresh callback are intentionally excluded from
+ *    the dependency array to avoid a refresh-loop on every list update.
+ * 2. Marks the active conversation as viewed when its matching identity becomes
+ *    available and `shouldMarkViewed` accepts it. List refreshes and persistence rollback do not retry the write.
+ */
+export declare const useActiveConversationSync: ({ activeConversationId, items, refreshConversations, markConversationViewed, conversationIdsMatch, toPanelConversationId, shouldMarkViewed, }: UseActiveConversationSyncParams) => string | undefined;
+//# sourceMappingURL=useActiveConversationSync.d.ts.map

package/conversation/useActiveConversationSync/useActiveConversationSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActiveConversationSync.d.ts","sourceRoot":"","sources":["../../../src/conversation/useActiveConversationSync/useActiveConversationSync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAG7E,kDAAkD;AAClD,MAAM,WAAW,+BAA+B;IAC9C;;;OAGG;IACH,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,0CAA0C;IAC1C,KAAK,EAAE,uBAAuB,EAAE,CAAC;IACjC,4CAA4C;IAC5C,oBAAoB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,0EAA0E;IAC1E,sBAAsB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD;;;OAGG;IACH,oBAAoB,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACxD,qEAAqE;IACrE,qBAAqB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9C,qGAAqG;IACrG,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,uBAAuB,KAAK,OAAO,CAAC;CAC/D;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,GAAI,+IAQvC,+BAA+B,KAAG,MAAM,GAAG,SAmD7C,CAAC"}

package/conversation/useActiveConversationSync/useActiveConversationSync.js

@@ -1,18 +1,25 @@
-import { useEffect as e, useMemo as t } from "react";
+import { useEffect as e, useMemo as t, useRef as n } from "react";
 //#region src/conversation/useActiveConversationSync/useActiveConversationSync.ts
-var n = ({ activeConversationId: n, items: r, refreshConversations: i, markConversationViewed: a, conversationIdsMatch: o, toPanelConversationId: s }) => {
-	let c = t(() => n ? s(n) : void 0, [n, s]);
+var r = ({ activeConversationId: r, items: i, refreshConversations: a, markConversationViewed: o, conversationIdsMatch: s, toPanelConversationId: c, shouldMarkViewed: l }) => {
+	let u = t(() => r ? c(r) : void 0, [r, c]);
 	e(() => {
-		c && (r.some((e) => o(e.id, c)) || i());
-	}, [c, o]);
-	let l = c ? r.find((e) => o(e.id, c))?.id : void 0;
+		u && (i.some((e) => s(e.id, u)) || a());
+	}, [u, s]);
+	let d = u ? i.find((e) => s(e.id, u)) : void 0, f = d?.id, p = d != null && (l?.(d) ?? !0), m = n(void 0);
 	return e(() => {
-		c && l && a(l);
+		if (!u || !f) {
+			m.current = void 0;
+			return;
+		}
+		if (!p) return;
+		let e = `${u}\u0000${f}`;
+		m.current !== e && (m.current = e, o(f));
 	}, [
-		c,
-		l,
-		a
-	]), c;
+		u,
+		f,
+		p,
+		o
+	]), u;
 };
 //#endregion
-export { n as useActiveConversationSync };
+export { r as useActiveConversationSync };

package/conversation/useAsyncConfirmDialog/useAsyncConfirmDialog.d.ts

@@ -0,0 +1,46 @@
+/** State and controls returned by `useAsyncConfirmDialog`. */
+export interface AsyncConfirmDialogControls<T> {
+    /**
+     * The value currently awaiting confirmation, or `null` when no dialog is
+     * open.
+     */
+    pending: T | null;
+    /** `true` when `pending` is not `null`. */
+    isPending: boolean;
+    /** `true` while the async operation started by `confirm` is in-flight. */
+    isRunning: boolean;
+    /** Error message set when the last `confirm` run threw, or `null` otherwise. */
+    error: string | null;
+    /**
+     * Opens the dialog by setting `pending` to `value` and clearing any prior
+     * error.
+     *
+     * Pass `returnFocusTo` when the control that opened the dialog will not
+     * survive it — a row menu item, for instance, unmounts with its menu, so
+     * restoring focus to it is impossible and the caller should name a stable
+     * element such as the menu's own trigger. When omitted, whatever held focus
+     * at the moment of the call is used.
+     */
+    open: (value: T, returnFocusTo?: HTMLElement | null) => void;
+    /** Closes the dialog by resetting `pending`, `error`, and `isRunning` to their initial values. */
+    close: () => void;
+    /**
+     * Runs `run(pending)` while enforcing a re-entry guard.
+     *
+     * - No-op when `isRunning` is already `true` or `pending` is `null`.
+     * - On success: calls `close()` to reset all state.
+     * - On failure: sets `error` to `onError(caughtError)` and leaves `pending`
+     *   set so the caller may retry.
+     */
+    confirm: (run: (value: T) => Promise<void>, onError: (error: unknown) => string) => Promise<void>;
+}
+/**
+ * Generic single-slot pending / loading / error state machine for
+ * confirmation dialogs that trigger an async operation.
+ *
+ * Replaces the `[pendingXxx, setXxx] / [isXxxing, setIsXxxing] / [xxxError,
+ * setXxxError]` triads that previously appeared inline at each call site in
+ * `ConversationPanelView` and `ConversationPanelMenu`.
+ */
+export declare const useAsyncConfirmDialog: <T>() => AsyncConfirmDialogControls<T>;
+//# sourceMappingURL=useAsyncConfirmDialog.d.ts.map

package/conversation/useAsyncConfirmDialog/useAsyncConfirmDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAsyncConfirmDialog.d.ts","sourceRoot":"","sources":["../../../src/conversation/useAsyncConfirmDialog/useAsyncConfirmDialog.ts"],"names":[],"mappings":"AAEA,8DAA8D;AAC9D,MAAM,WAAW,0BAA0B,CAAC,CAAC;IAC3C;;;OAGG;IACH,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;IAClB,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,SAAS,EAAE,OAAO,CAAC;IACnB,gFAAgF;IAChF,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;;;;;;;;OASG;IACH,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,aAAa,CAAC,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IAC7D,kGAAkG;IAClG,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB;;;;;;;OAOG;IACH,OAAO,EAAE,CACP,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EAChC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,KAChC,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,OAAK,0BAA0B,CAAC,CAAC,CAwFvE,CAAC"}

package/conversation/useAttachmentUpload/useAttachmentUpload.d.ts

@@ -0,0 +1,27 @@
+import { FilesApi } from '@epam/ai-dial-chat-api-client';
+import { Attachment, UploadedAttachmentResult } from '@epam/ai-dial-chat-shared';
+/** Parameters for {@link useAttachmentUpload}. */
+export interface UseAttachmentUploadParams {
+    /** Already-configured client; optional listing skips stored names after a conflict. */
+    filesApi: Pick<FilesApi, 'uploadFile'> & Partial<Pick<FilesApi, 'listFiles'>>;
+    /** DIAL Core bucket the file is uploaded into. */
+    bucket: string | undefined;
+    /** Called with batched filenames after a burst of network-error upload failures. */
+    onNetworkError?: (filenames: string[]) => void;
+    /** Debounce window, in ms, for coalescing offline-failure batches. Defaults to `700`. */
+    debounceMs?: number;
+}
+/** Return value of {@link useAttachmentUpload}. */
+export interface UseAttachmentUploadResult {
+    /** Uploads the given attachment's file and resolves to its DIAL Core file URL and stored name. */
+    handleUploadAttachment: (attachment: Attachment) => Promise<UploadedAttachmentResult>;
+}
+/**
+ * Uploads an attachment's file to DIAL Core storage against an
+ * already-configured `FilesApi` instance, giving every upload a collision-free
+ * path so no attachment overwrites another, and coalescing a burst of
+ * offline/network upload failures into a single debounced callback rather
+ * than firing one notification per failed file.
+ */
+export declare const useAttachmentUpload: ({ filesApi, bucket, onNetworkError, debounceMs, }: UseAttachmentUploadParams) => UseAttachmentUploadResult;
+//# sourceMappingURL=useAttachmentUpload.d.ts.map

package/conversation/useAttachmentUpload/useAttachmentUpload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAttachmentUpload.d.ts","sourceRoot":"","sources":["../../../src/conversation/useAttachmentUpload/useAttachmentUpload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,wBAAwB,EAC9B,MAAM,2BAA2B,CAAC;AAYnC,kDAAkD;AAClD,MAAM,WAAW,yBAAyB;IACxC,uFAAuF;IACvF,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;IAC9E,kDAAkD;IAClD,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,oFAAoF;IACpF,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC/C,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC,kGAAkG;IAClG,sBAAsB,EAAE,CACtB,UAAU,EAAE,UAAU,KACnB,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACxC;AAyBD;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,mDAKjC,yBAAyB,KAAG,yBA6G9B,CAAC"}

package/conversation/useAttachmentUpload/useAttachmentUpload.js

@@ -4,7 +4,10 @@ import { createUploadPathAllocator as n } from "../conversation-transfer/build-u
 import { AttachmentErrorReason as r } from "@epam/ai-dial-chat-shared";
 import { useCallback as i, useRef as a } from "react";
 //#region src/conversation/useAttachmentUpload/useAttachmentUpload.ts
-var o = 700, s = 5, c = (e) => t(e.split("/").filter(Boolean).pop() ?? "file").replace(/\.\.+/g, ".").replace(/^\.+/, "") || "file", l = (e) => typeof e == "object" && !!e && "response" in e && e.response?.status === 409, u = ({ filesApi: t, bucket: u, onNetworkError: d, debounceMs: f = o }) => {
+var o = 700, s = 5, c = (e) => {
+	let n = e.split("/").filter(Boolean).pop() ?? "file";
+	return t(n).replace(/\.\.+/g, ".").replace(/^\.+/, "") || "file";
+}, l = (e) => typeof e == "object" && !!e && "response" in e && e.response?.status === 409, u = ({ filesApi: t, bucket: u, onNetworkError: d, debounceMs: f = o }) => {
 	let p = a([]), m = a(null), h = a(null), g = i((t, r) => {
 		let i = `${t}|${e(r)}`;
 		return h.current?.key !== i && (h.current = {

package/conversation/useConversationComposerDraft/useConversationComposerDraft.d.ts

@@ -0,0 +1,39 @@
+import { RequestSkill } from '@epam/ai-dial-chat-shared';
+import { ConversationDraft, ConversationDraftStore } from '../conversation-draft/conversation-draft';
+/** Parameters of `useConversationComposerDraft`. */
+export interface UseConversationComposerDraftParams {
+    /** Host-owned draft store; `undefined` (e.g. no signed-in user yet) makes every handler a no-op. */
+    store: ConversationDraftStore | undefined;
+    /** The conversation whose draft is managed. */
+    conversationId: string;
+    /** Seeds the host's own composer and mention state from a restored draft. */
+    restoreDraft: (draft: ConversationDraft) => void;
+    /** While `false` the restore is deferred. Defaults to `true`. */
+    isRestoreReady?: boolean;
+    /** Skips the restore for this conversation, e.g. when external content is pending. Defaults to `false`. */
+    shouldSkipRestore?: boolean;
+    /** Delay before a change is written to the store, in milliseconds. Defaults to `300`. */
+    debounceMs?: number;
+}
+/** Stable handlers returned by `useConversationComposerDraft`. */
+export interface UseConversationComposerDraftResult {
+    /** Records a user-driven text change and schedules a save. */
+    handleTextChange: (text: string) => void;
+    /** Records the current skill mentions and schedules a save when they changed. */
+    handleSkillsChange: (skills: RequestSkill[]) => void;
+    /** Replaces the draft with host-provided content and no skills, and schedules a save. */
+    handleExternalContent: (text: string) => void;
+    /** Runs `send`, removing the draft when it resolves unless the user edited meanwhile, and storing `text` again when it rejects (the rejection is rethrown). */
+    sendWithDraft: (text: string, send: () => Promise<unknown> | unknown) => Promise<void>;
+    /** Discards the draft for the current conversation. */
+    clearDraft: () => void;
+}
+/**
+ * Headless per-conversation composer draft: saves the text and skill mentions
+ * the user leaves behind, restores them once when the conversation is shown
+ * again, and discards them on a successful send or an emptied input.
+ *
+ * All state lives in refs, so the hook never re-renders the host.
+ */
+export declare const useConversationComposerDraft: ({ store, conversationId, restoreDraft, isRestoreReady, shouldSkipRestore, debounceMs, }: UseConversationComposerDraftParams) => UseConversationComposerDraftResult;
+//# sourceMappingURL=useConversationComposerDraft.d.ts.map

package/conversation/useConversationComposerDraft/useConversationComposerDraft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversationComposerDraft.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationComposerDraft/useConversationComposerDraft.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,KAAK,EACV,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,0CAA0C,CAAC;AAMlD,oDAAoD;AACpD,MAAM,WAAW,kCAAkC;IACjD,oGAAoG;IACpG,KAAK,EAAE,sBAAsB,GAAG,SAAS,CAAC;IAC1C,+CAA+C;IAC/C,cAAc,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,YAAY,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACjD,iEAAiE;IACjE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,2GAA2G;IAC3G,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,kEAAkE;AAClE,MAAM,WAAW,kCAAkC;IACjD,8DAA8D;IAC9D,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,iFAAiF;IACjF,kBAAkB,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC;IACrD,yFAAyF;IACzF,qBAAqB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,+JAA+J;IAC/J,aAAa,EAAE,CACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,KACnC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,uDAAuD;IACvD,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAgCD;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,GAAI,yFAO1C,kCAAkC,KAAG,kCA4KvC,CAAC"}

package/conversation/useConversationComposerDraft/useConversationComposerDraft.js

@@ -0,0 +1,128 @@
+import { useCallback as e, useEffect as t, useRef as n } from "react";
+//#region src/conversation/useConversationComposerDraft/useConversationComposerDraft.ts
+var r = 300, i = {
+	text: "",
+	skills: [],
+	updatedAt: 0
+}, a = (e) => ({
+	conversationId: e,
+	text: "",
+	skills: [],
+	hasUserInput: !1,
+	isRestored: !1,
+	isSendingCleared: !1,
+	editRevision: 0
+}), o = (e, t) => e.length === t.length && e.every((e, n) => e.url === t[n].url), s = ({ store: s, conversationId: c, restoreDraft: l, isRestoreReady: u = !0, shouldSkipRestore: d = !1, debounceMs: f = r }) => {
+	let p = n(null), m = n(!1), h = n(null), g = n(l), _ = n(f);
+	g.current = l, _.current = f;
+	let v = e((e) => {
+		let t = p.current;
+		if (t?.conversationId === e) return t;
+		t && (m.current = !0);
+		let n = a(e);
+		return p.current = n, n;
+	}, []), y = e(() => {
+		let e = h.current;
+		e && (clearTimeout(e.handle), h.current = null);
+	}, []), b = e(() => {
+		let e = h.current;
+		e && (clearTimeout(e.handle), e.run());
+	}, []), x = e((e, t) => {
+		y();
+		let n = () => {
+			h.current = null, e.write(t.conversationId, {
+				text: t.text,
+				skills: t.skills,
+				updatedAt: Date.now()
+			});
+		};
+		h.current = {
+			handle: setTimeout(n, _.current),
+			run: n
+		};
+	}, [y]);
+	return t(() => b, [
+		s,
+		c,
+		b
+	]), t(() => (window.addEventListener("pagehide", b), () => window.removeEventListener("pagehide", b)), [b]), t(() => {
+		let e = v(c);
+		if (e.isRestored) return;
+		if (d) {
+			e.isRestored = !0;
+			return;
+		}
+		if (!u || !s || (e.isRestored = !0, e.hasUserInput)) return;
+		let t = s.read(c);
+		t ? (e.text = t.text, e.skills = t.skills, g.current(t)) : m.current && g.current(i);
+	}, [
+		s,
+		c,
+		u,
+		d,
+		v
+	]), {
+		handleTextChange: e((e) => {
+			let t = v(c);
+			t.text = e, t.hasUserInput = !0, t.editRevision += 1, t.isSendingCleared = !1, s && x(s, t);
+		}, [
+			s,
+			c,
+			v,
+			x
+		]),
+		handleSkillsChange: e((e) => {
+			let t = v(c);
+			o(t.skills, e) || (t.skills = e, !(t.isSendingCleared && t.text === "") && (t.hasUserInput = !0, t.editRevision += 1, s && x(s, t)));
+		}, [
+			s,
+			c,
+			v,
+			x
+		]),
+		handleExternalContent: e((e) => {
+			let t = v(c);
+			t.text = e, t.skills = [], t.hasUserInput = !0, t.editRevision += 1, t.isSendingCleared = !1, s && x(s, t);
+		}, [
+			s,
+			c,
+			v,
+			x
+		]),
+		sendWithDraft: e(async (e, t) => {
+			if (!s) {
+				await t();
+				return;
+			}
+			let n = v(c);
+			y(), n.text = "", n.isSendingCleared = !0;
+			let r = n.editRevision;
+			try {
+				await t();
+			} catch (t) {
+				throw n.text = e, n.isSendingCleared = !1, s.write(c, {
+					text: e,
+					skills: n.skills,
+					updatedAt: Date.now()
+				}), t;
+			}
+			n.editRevision === r && s.remove(c);
+		}, [
+			s,
+			c,
+			v,
+			y
+		]),
+		clearDraft: e(() => {
+			let e = v(c);
+			y(), e.text = "", e.skills = [], s?.remove(c);
+		}, [
+			s,
+			c,
+			v,
+			y
+		])
+	};
+};
+//#endregion
+export { s as useConversationComposerDraft };