@epam/ai-dial-chat-hooks 1.3.0-dev.98 → 1.3.0-rc.0

package/conversation/useConversationTitleEnrichmentController.d.ts

@@ -0,0 +1,64 @@
+import { Dispatch, SetStateAction } from 'react';
+/** Completion outcome of one incremental request. */
+export declare enum ConversationTitleRequestEnd {
+    Complete = "complete",
+    Budget = "budget",
+    Unsupported = "unsupported",
+    Stopped = "stopped"
+}
+/** Minimal list row required for title reconciliation. */
+export interface ConversationTitleItem {
+    /** Exact resource identity. */
+    id: string;
+    /** Current display title. */
+    title: string;
+    /** Whether the title still needs enrichment. */
+    isTitlePending?: boolean;
+}
+/** Outcome of an incremental transport call. */
+export interface ConversationTitleTransportResult {
+    /** Completion or fallback outcome. */
+    end: ConversationTitleRequestEnd;
+    /** IDs with a terminal outcome, including missing titles. */
+    settledIds: readonly string[];
+}
+/** Host transports and scheduling policies. Keep this object stable. */
+export interface ConversationTitleEnrichmentOptions {
+    /** Fetches one JSON batch. */
+    getTitles: (ids: string[], signal: AbortSignal) => Promise<{
+        items: {
+            id: string;
+            title: string;
+        }[];
+    }>;
+    /** Optional incremental transport; omitted for JSON-only hosts. */
+    streamTitles?: (ids: string[], signal: AbortSignal, onTitle: (id: string, title: string) => void) => Promise<ConversationTitleTransportResult>;
+    /** Maximum IDs in each JSON batch; must be positive. */
+    batchSize: number;
+    /** Maximum IDs in each incremental request; must be positive. */
+    maxIds: number;
+    /** Maximum encoded JSON-array bytes per incremental request. */
+    maxBytes: number;
+    /** Maximum delay before buffered titles flush. */
+    flushMs: number;
+    /** Maximum buffered title count; must be positive. */
+    maxPendingUpdates: number;
+    /** Duration for which local writes override remote snapshots. */
+    protectionMs: number;
+    /** Clock for local protection; defaults to Date.now. */
+    now?: () => number;
+}
+/** Resolves list titles without blocking the initial history response. */
+export declare const useConversationTitleEnrichmentController: <T extends ConversationTitleItem>(identityScope: unknown, setConversations: Dispatch<SetStateAction<T[]>>, options: ConversationTitleEnrichmentOptions) => {
+    applyConversationList: (items: T[], requestedAtRevision: number) => void;
+    getTitleRevision: () => number;
+    rememberTitle: (id: string, title: string, options?: {
+        isWriting?: boolean;
+        protect?: boolean;
+    }) => void;
+    forgetTitle: (id: string, isPending?: boolean) => void;
+    restoreTitle: (id: string, title: string) => void;
+    setVisibleConversationIds: (viewKey: string, ids: string[] | null) => void;
+    isUpdatingTitles: boolean;
+};
+//# sourceMappingURL=useConversationTitleEnrichmentController.d.ts.map

package/conversation/useConversationTitleEnrichmentController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversationTitleEnrichmentController.d.ts","sourceRoot":"","sources":["../../src/conversation/useConversationTitleEnrichmentController.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,cAAc,EAKpB,MAAM,OAAO,CAAC;AAEf,qDAAqD;AACrD,oBAAY,2BAA2B;IACrC,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,WAAW,gBAAgB;IAC3B,OAAO,YAAY;CACpB;AACD,0DAA0D;AAC1D,MAAM,WAAW,qBAAqB;IACpC,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AACD,gDAAgD;AAChD,MAAM,WAAW,gCAAgC;IAC/C,sCAAsC;IACtC,GAAG,EAAE,2BAA2B,CAAC;IACjC,6DAA6D;IAC7D,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B;AACD,wEAAwE;AACxE,MAAM,WAAW,kCAAkC;IACjD,8BAA8B;IAC9B,SAAS,EAAE,CACT,GAAG,EAAE,MAAM,EAAE,EACb,MAAM,EAAE,WAAW,KAChB,OAAO,CAAC;QAAE,KAAK,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,CAAC,CAAC;IACzD,mEAAmE;IACnE,YAAY,CAAC,EAAE,CACb,GAAG,EAAE,MAAM,EAAE,EACb,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,KACzC,OAAO,CAAC,gCAAgC,CAAC,CAAC;IAC/C,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AA2DD,0EAA0E;AAC1E,eAAO,MAAM,wCAAwC,GACnD,CAAC,SAAS,qBAAqB,EAE/B,eAAe,OAAO,EACtB,kBAAkB,QAAQ,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,EAC/C,SAAS,kCAAkC;mCAwFjC,CAAC,EAAE,uBAAuB,MAAM;;wBApClC,MAAM,SACH,MAAM,YACJ;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE;sBAelB,MAAM;uBAUpC,MAAM,SAAS,MAAM;yCApChB,MAAM,OAAO,MAAM,EAAE,GAAG,IAAI;;CA+RzC,CAAC"}

package/conversation/useConversationTitleEnrichmentController.js

@@ -0,0 +1,155 @@
+import { useCallback as e, useLayoutEffect as t, useRef as n, useState as r } from "react";
+//#region src/conversation/useConversationTitleEnrichmentController.ts
+var i = /* @__PURE__ */ function(e) {
+	return e.Complete = "complete", e.Budget = "budget", e.Unsupported = "unsupported", e.Stopped = "stopped", e;
+}({}), a = new TextEncoder(), o = (e, t, n) => {
+	let r = 2, i = [];
+	for (let o of e) {
+		if (i.length >= t) break;
+		let e = a.encode(JSON.stringify(o)).length + +!!i.length;
+		if (r + e > n) break;
+		r += e, i.push(o);
+	}
+	return i;
+}, s = (e, t) => new Promise((n) => {
+	let r = () => {
+		cancelAnimationFrame(i), clearTimeout(a), e.removeEventListener("abort", r), n();
+	}, i = requestAnimationFrame(r), a = setTimeout(r, t);
+	e.addEventListener("abort", r, { once: !0 });
+}), c = (e, t) => {
+	let n = new Set(e), r = /* @__PURE__ */ new Set();
+	for (let e of t.values()) for (let t of e) n.has(t) && r.add(t);
+	return r.size === 0 ? e : [...r, ...e.filter((e) => !r.has(e))];
+}, l = (i, a, l) => {
+	let { getTitles: u, streamTitles: d, batchSize: f, maxIds: p, maxBytes: m, flushMs: h, maxPendingUpdates: g, protectionMs: _, now: v = Date.now } = l, y = n(null), b = n(/* @__PURE__ */ new Map()), x = n(/* @__PURE__ */ new Map()), S = n(/* @__PURE__ */ new Map()), C = n(/* @__PURE__ */ new Set()), w = n(0), T = n(!!d), E = n(/* @__PURE__ */ new Map()), [D, O] = r(!1);
+	t(() => (b.current.clear(), x.current.clear(), S.current.clear(), C.current.clear(), w.current = 0, E.current.clear(), T.current = !!d, O(!1), () => {
+		y.current?.abort(), y.current = null;
+	}), [i, d]);
+	let k = e(() => w.current, []), A = e((e, t) => {
+		t ? E.current.set(e, t) : E.current.delete(e);
+	}, []), j = e((e, t, n = {}) => {
+		let r = ++w.current;
+		x.current.set(e, r), b.current.set(e, {
+			title: t,
+			revision: r,
+			isWriting: n.isWriting,
+			protectedUntil: n.protect === !1 ? void 0 : v() + _
+		});
+	}, [v, _]), M = e((e, t = !1) => {
+		let n = ++w.current;
+		x.current.set(e, n), S.current.set(e, n), t ? C.current.add(e) : C.current.delete(e), b.current.delete(e);
+	}, []), N = e((e, t) => {
+		S.current.delete(e), C.current.delete(e), j(e, t, { protect: !1 });
+	}, [j]);
+	return {
+		applyConversationList: e((e, t) => {
+			y.current?.abort();
+			let n = new AbortController();
+			y.current = n;
+			let r = e.filter(({ id: e }) => !C.current.has(e) && (S.current.get(e) ?? 0) <= t);
+			for (let [e, n] of S.current) n <= t && !C.current.has(e) && S.current.delete(e);
+			let i = new Set(r.map(({ id: e }) => e));
+			for (let e of b.current.keys()) i.has(e) || b.current.delete(e);
+			for (let e of x.current.keys()) !i.has(e) && !S.current.has(e) && x.current.delete(e);
+			a(r.map((e) => {
+				let n = b.current.get(e.id);
+				return n && (e.isTitlePending || n.isWriting || (n.protectedUntil ?? 0) > v() || n.revision > t) ? {
+					...e,
+					title: n.title,
+					...(n.protectedUntil ?? 0) > v() || n.isWriting || n.revision > t ? { isTitlePending: !1 } : {}
+				} : (e.isTitlePending || b.current.set(e.id, {
+					title: e.title,
+					revision: x.current.get(e.id) ?? 0
+				}), e);
+			}));
+			let l = [...new Set(r.filter((e) => e.isTitlePending && !b.current.get(e.id)?.isWriting && (b.current.get(e.id)?.protectedUntil ?? 0) <= v() && (x.current.get(e.id) ?? 0) <= t).map((e) => e.id))], _ = new Map(l.map((e) => [e, x.current.get(e) ?? 0])), w = (e) => _.get(e) === (x.current.get(e) ?? 0), D = () => y.current === n && !n.signal.aborted;
+			O(l.length > 0);
+			let k = /* @__PURE__ */ new Map(), A, j, M = () => {
+				if (A !== void 0 && cancelAnimationFrame(A), clearTimeout(j), A = void 0, j = void 0, k.size === 0) return;
+				let e = new Map([...k].filter(([e]) => w(e)));
+				k.clear(), D() && e.size !== 0 && (e.forEach((e, t) => {
+					b.current.set(t, {
+						title: e,
+						revision: x.current.get(t) ?? 0
+					});
+				}), a((t) => {
+					if (!D()) return t;
+					let n = !1, r = t.map((t) => {
+						let r = e.get(t.id);
+						return r !== void 0 && w(t.id) && (t.title !== r || t.isTitlePending) ? (n = !0, {
+							...t,
+							title: r,
+							isTitlePending: !1
+						}) : t;
+					});
+					return n ? r : t;
+				}));
+			};
+			n.signal.addEventListener("abort", M, { once: !0 });
+			let N = (e, t) => {
+				D() && w(e) && (k.set(e, t), k.size >= g ? M() : j === void 0 && (A = requestAnimationFrame(M), j = setTimeout(M, h)));
+			}, P = async (e) => {
+				for (let t = 0; t < e.length; t += f) {
+					if (!D()) return;
+					let r = e.slice(t, t + f).filter(w);
+					if (r.length !== 0) try {
+						let e = await u(r, n.signal);
+						if (!D()) return;
+						for (let { id: t, title: n } of e.items) r.includes(t) && N(t, n);
+						M();
+					} catch {
+						return;
+					}
+				}
+			}, F = async (e, t) => {
+				if (!d) return "unsupported";
+				try {
+					let r = new Set(e), i = await d(e, n.signal, (e, t) => {
+						D() && r.has(e) && N(e, t);
+					});
+					if (!D()) return "stopped";
+					for (let e of i.settledIds) r.has(e) && t.add(e);
+					return i.end;
+				} catch {
+					return "stopped";
+				}
+			};
+			(async () => {
+				let e = l;
+				try {
+					for (e.length > 0 && await s(n.signal, h); e.length > 0 && D();) {
+						if (e = c(e.filter(w), E.current), T.current === !1) {
+							await P(e);
+							return;
+						}
+						let t = o(e, p, m);
+						if (t.length === 0) return;
+						let r = /* @__PURE__ */ new Set(), i = await F(t, r);
+						if (i === "unsupported") y.current === n && (T.current = !1);
+						else if (e = e.filter((e) => !r.has(e)), i === "stopped" || r.size === 0) return;
+					}
+				} finally {
+					M(), y.current === n && O(!1);
+				}
+			})();
+		}, [
+			a,
+			u,
+			d,
+			f,
+			p,
+			m,
+			h,
+			g,
+			v
+		]),
+		getTitleRevision: k,
+		rememberTitle: j,
+		forgetTitle: M,
+		restoreTitle: N,
+		setVisibleConversationIds: A,
+		isUpdatingTitles: D
+	};
+};
+//#endregion
+export { i as ConversationTitleRequestEnd, l as useConversationTitleEnrichmentController };

package/conversation/useDeploymentChangeTracking.d.ts

@@ -0,0 +1,14 @@
+/** Host selection and conversation lifecycle inputs. */
+export interface DeploymentChangeTrackingOptions {
+    /** Active conversation identity; absent outside a conversation. */
+    conversationId: string | undefined;
+    /** Restored or user-selected deployment. */
+    selectedDeploymentId: string | null;
+    /** Whether conversation restoration has finished. */
+    isLoaded: boolean;
+    /** Reports user changes after restoration. */
+    onChange: (previous: string | null, next: string) => void;
+}
+/** Tracks user selection changes without treating conversation restoration as a change. */
+export declare const useDeploymentChangeTracking: ({ conversationId, selectedDeploymentId, isLoaded, onChange, }: DeploymentChangeTrackingOptions) => void;
+//# sourceMappingURL=useDeploymentChangeTracking.d.ts.map

package/conversation/useDeploymentChangeTracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeploymentChangeTracking.d.ts","sourceRoot":"","sources":["../../src/conversation/useDeploymentChangeTracking.ts"],"names":[],"mappings":"AAEA,wDAAwD;AACxD,MAAM,WAAW,+BAA+B;IAC9C,mEAAmE;IACnE,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,4CAA4C;IAC5C,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,qDAAqD;IACrD,QAAQ,EAAE,OAAO,CAAC;IAClB,8CAA8C;IAC9C,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3D;AACD,2FAA2F;AAC3F,eAAO,MAAM,2BAA2B,GAAI,+DAKzC,+BAA+B,KAAG,IAoBpC,CAAC"}

package/conversation/useDeploymentChangeTracking.js

@@ -0,0 +1,23 @@
+import { useEffect as e, useRef as t } from "react";
+//#region src/conversation/useDeploymentChangeTracking.ts
+var n = ({ conversationId: n, selectedDeploymentId: r, isLoaded: i, onChange: a }) => {
+	let o = t(void 0);
+	e(() => {
+		if (!n || !i) {
+			o.current = void 0;
+			return;
+		}
+		let e = o.current;
+		o.current = {
+			conversationId: n,
+			deploymentId: r
+		}, e && e.conversationId === n && e.deploymentId !== r && r !== null && a(e.deploymentId, r);
+	}, [
+		n,
+		r,
+		i,
+		a
+	]);
+};
+//#endregion
+export { n as useDeploymentChangeTracking };

package/conversation/useEntityPreselection/useEntityPreselection.d.ts

@@ -0,0 +1,108 @@
+/** Sources whose arrival values may be consumed. */
+export declare enum EntityPreselectionSource {
+    Deployment = "deployment",
+    Skill = "skill",
+    Prompt = "prompt"
+}
+/** Failure outcomes interpreted by the host. */
+export declare enum EntityPreselectionOutcome {
+    DeploymentUnavailable = "deployment-unavailable",
+    DeploymentsLoadFailed = "deployments-load-failed",
+    SkillUnavailable = "skill-unavailable",
+    SkillsLoadFailed = "skills-load-failed",
+    PromptUnavailable = "prompt-unavailable"
+}
+/** Parsed arrival values; the controller captures these once per mount. */
+export interface EntityPreselectionSnapshot {
+    /** Requested deployment identity. */
+    deploymentId: string | null;
+    /** Requested skill reference. */
+    skillId: string | null;
+    /** Requested prompt identity. */
+    promptId: string | null;
+    /** Sources already provided by the host, which take precedence. */
+    superseded: readonly EntityPreselectionSource[];
+    /** Disables all application, consumption and outcome side effects. */
+    isDisabled: boolean;
+}
+/** Structural prompt passed to the host's composer or parameter popup. */
+export interface EntityPreselectionPrompt {
+    /** Canonical identity. */
+    id: string;
+    /** Display name. */
+    name: string;
+    /** Optional description. */
+    description?: string;
+    /** Prompt content. */
+    content: string;
+}
+/** A resolved skill mention. */
+export interface EntityPreselectionSkill {
+    /** Canonical reference. */
+    url: string;
+    /** Resolved display name. */
+    name: string;
+}
+/** Loaded prompt and parameter policy. */
+export interface EntityPreselectionPromptResult {
+    /** Resolved prompt. */
+    prompt: EntityPreselectionPrompt;
+    /** Whether the host must ask for parameter values. */
+    hasParameters: boolean;
+}
+/** Host actions for applying resolved entities. */
+export interface EntityPreselectionSinks {
+    /** Selects a deployment without persisting a preference. */
+    restoreSelectedItemId: (id: string) => void;
+    /** Inserts a skill mention. */
+    selectSkillByUrl: (url: string) => void;
+    /** Seeds combined prompt text and skill references. */
+    seedSkillMentions: (content: string, entries: {
+        url: string;
+    }[] | undefined) => void;
+    /** Seeds plain prompt text. */
+    seedComposerText: (text: string) => void;
+    /** Opens a parameterized prompt. */
+    openParametersPopup: (prompt: EntityPreselectionPrompt) => void;
+}
+/** Host listings, loaders and side-effect adapters. */
+export interface UseEntityPreselectionOptions {
+    /** Parsed arrival snapshot. */
+    snapshot: EntityPreselectionSnapshot;
+    /** Whether the deployment listing is pending. */
+    isDeploymentsLoading: boolean;
+    /** Whether deployment loading failed. */
+    deploymentsError: unknown;
+    /** Looks up an eligible deployment in the current listing. */
+    resolveDeployment: (id: string) => {
+        id: string;
+    } | undefined;
+    /** Whether skill listing is pending. */
+    isSkillsLoading: boolean;
+    /** Whether skill loading failed. */
+    skillsError: unknown;
+    /** Whether skills are available in this host. */
+    isSkillsEnabled: boolean;
+    /** Looks up a valid skill in current listings. */
+    resolveSkill: (id: string) => EntityPreselectionSkill | undefined;
+    /** Whether prompts are available in this host. */
+    isPromptsEnabled: boolean;
+    /** Loads and adapts a prompt; undefined means unavailable. */
+    loadPrompt: (id: string, signal: AbortSignal) => Promise<EntityPreselectionPromptResult | undefined>;
+    /** Application sinks, read from the latest committed render. */
+    sinks: EntityPreselectionSinks;
+    /** Consumes supplied arrival sources, leaving URL/router policy to the host. */
+    onConsume: (sources: EntityPreselectionSource[]) => void;
+    /** Reports a typed failure, optional host error and original identity. */
+    onOutcome: (outcome: EntityPreselectionOutcome, id: string, error?: unknown) => void;
+}
+/** Deployment override flags for default-selection coordination. */
+export interface UseEntityPreselectionResult {
+    /** Pending or successfully applied deployment override. */
+    isDeploymentOverrideActive: boolean;
+    /** Deployment resolution has not settled yet. */
+    isDeploymentPending: boolean;
+}
+/** Applies arrival entities once, preserving source precedence and ignoring retired work. */
+export declare const useEntityPreselection: (options: UseEntityPreselectionOptions) => UseEntityPreselectionResult;
+//# sourceMappingURL=useEntityPreselection.d.ts.map

package/conversation/useEntityPreselection/useEntityPreselection.d.ts.map

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

package/conversation/useEntityPreselection/useEntityPreselection.js

@@ -0,0 +1,78 @@
+import { useEffect as e, useRef as t, useState as n } from "react";
+//#region src/conversation/useEntityPreselection/useEntityPreselection.ts
+var r = /* @__PURE__ */ function(e) {
+	return e.Deployment = "deployment", e.Skill = "skill", e.Prompt = "prompt", e;
+}({}), i = /* @__PURE__ */ function(e) {
+	return e.DeploymentUnavailable = "deployment-unavailable", e.DeploymentsLoadFailed = "deployments-load-failed", e.SkillUnavailable = "skill-unavailable", e.SkillsLoadFailed = "skills-load-failed", e.PromptUnavailable = "prompt-unavailable", e;
+}({}), a = (r) => {
+	let [i] = n(r.snapshot), a = (e, t) => !i.isDisabled && t !== null && !i.superseded.includes(e), [o, s] = n(() => a("deployment", i.deploymentId) ? "pending" : "idle"), [c, l] = n(() => ({ status: a("skill", i.skillId) ? "pending" : "idle" })), [u, d] = n(() => ({ status: a("prompt", i.promptId) ? "pending" : "idle" })), f = t(r);
+	e(() => {
+		f.current = r;
+	});
+	let p = t(!1), m = t(!1), h = t(!1), g = t(!1), _ = t(!1);
+	return e(() => {
+		if (i.isDisabled || p.current) return;
+		p.current = !0;
+		let e = {
+			deployment: i.deploymentId,
+			skill: i.skillId,
+			prompt: i.promptId
+		};
+		f.current.onConsume(i.superseded.filter((t) => !!e[t]));
+	}, [i]), e(() => {
+		if (o !== "pending" || r.isDeploymentsLoading || m.current) return;
+		m.current = !0;
+		let e = i.deploymentId ?? "", t = f.current, n = t.resolveDeployment(e);
+		n ? (t.sinks.restoreSelectedItemId(n.id), s("resolved")) : (t.onOutcome(t.deploymentsError == null ? "deployment-unavailable" : "deployments-load-failed", e), s("failed")), t.onConsume(["deployment"]);
+	}, [
+		o,
+		r.isDeploymentsLoading,
+		r.deploymentsError,
+		r.resolveDeployment,
+		i.deploymentId
+	]), e(() => {
+		if (c.status !== "pending" || r.isSkillsLoading || h.current) return;
+		h.current = !0;
+		let e = i.skillId ?? "", t = f.current, n = t.isSkillsEnabled ? t.resolveSkill(e) : void 0;
+		n ? l({
+			status: "resolved",
+			value: n
+		}) : (t.onOutcome(t.isSkillsEnabled && t.skillsError != null ? "skills-load-failed" : "skill-unavailable", e), l({ status: "failed" }), t.onConsume(["skill"]));
+	}, [
+		c.status,
+		r.isSkillsLoading,
+		r.skillsError,
+		r.isSkillsEnabled,
+		r.resolveSkill,
+		i.skillId
+	]), e(() => {
+		if (u.status !== "pending" || g.current) return;
+		let e = new AbortController(), t = i.promptId ?? "";
+		return (async () => {
+			let n, i;
+			try {
+				n = r.isPromptsEnabled ? await f.current.loadPrompt(t, e.signal) : void 0;
+			} catch (e) {
+				i = e;
+			}
+			e.signal.aborted || (g.current = !0, n ? d({
+				status: "resolved",
+				value: n
+			}) : (f.current.onOutcome("prompt-unavailable", t, i), d({ status: "failed" }), f.current.onConsume(["prompt"])));
+		})(), () => e.abort();
+	}, [
+		u.status,
+		r.isPromptsEnabled,
+		i.promptId
+	]), e(() => {
+		if (_.current || c.status === "pending" || u.status === "pending" || !c.value && !u.value) return;
+		_.current = !0;
+		let { sinks: e, onConsume: t } = f.current, n = u.value?.prompt, r = [];
+		c.value && n ? (u.value?.hasParameters ? (e.selectSkillByUrl(c.value.url), e.openParametersPopup(n)) : e.seedSkillMentions(`/${c.value.name} ${n.content}`, [{ url: c.value.url }]), r.push("skill", "prompt")) : c.value ? (e.selectSkillByUrl(c.value.url), r.push("skill")) : n && (u.value?.hasParameters ? e.openParametersPopup(n) : e.seedComposerText(n.content), r.push("prompt")), t(r);
+	}, [c, u]), {
+		isDeploymentOverrideActive: o === "pending" || o === "resolved",
+		isDeploymentPending: o === "pending"
+	};
+};
+//#endregion
+export { i as EntityPreselectionOutcome, r as EntityPreselectionSource, a as useEntityPreselection };

package/conversation/useMessageSelectionReply/useMessageSelectionReply.js

@@ -112,16 +112,10 @@ var o = "button,input,textarea,select,iframe,[role=\"button\"],[contenteditable=
 				"End",
 				"PageUp",
 				"PageDown"
-			].includes(e.key) || (e.ctrlKey || e.metaKey) && e.key.toLowerCase() === "a")) {
-				r = !0, O(), _.current = null;
-				return;
-			}
-			if (g.current) {
-				if (e.key === "Escape") {
-					O();
-					return;
-				}
-				if (e.key === "Tab" && !e.shiftKey && !h.current?.contains(document.activeElement)) {
+			].includes(e.key) || (e.ctrlKey || e.metaKey) && e.key.toLowerCase() === "a")) r = !0, O(), _.current = null;
+			else if (g.current) {
+				if (e.key === "Escape") O();
+				else if (e.key === "Tab" && !e.shiftKey && !h.current?.contains(document.activeElement)) {
 					let t = h.current?.querySelector("button");
 					t && (e.preventDefault(), t.focus());
 				}

package/conversation/useTranscribeAudio/useTranscribeAudio.d.ts

@@ -6,8 +6,15 @@ export interface TranscribeWithDeploymentParams {
     deployment: string;
     signal: AbortSignal;
 }
+/** Upload file MIME policy. */
+export declare enum UploadMimeTypePolicy {
+    Preserve = "preserve",
+    Normalize = "normalize"
+}
 /** Parameters for {@link useTranscribeAudio}. */
 export interface UseTranscribeAudioParams {
+    /** File upload MIME policy; defaults to preserve. */
+    uploadMimeTypePolicy?: UploadMimeTypePolicy;
     /** Already-configured generated-client instance used for the ASR-model path. */
     transcriptionApi?: Pick<TranscriptionApi, 'transcribeAudio'>;
     /** Already-configured generated-client instance used to upload the recording. */
@@ -39,5 +46,5 @@ export interface UseTranscribeAudioResult {
  * library's concern — callers translate `AudioTranscriptionErrorReason` at
  * the call site.
  */
-export declare const useTranscribeAudio: ({ transcriptionApi, filesApi, transcribeWithDeployment, bucket, asrModelId, selectedDeploymentId, maxSizeBytes, }: UseTranscribeAudioParams) => UseTranscribeAudioResult;
+export declare const useTranscribeAudio: ({ transcriptionApi, filesApi, transcribeWithDeployment, bucket, asrModelId, selectedDeploymentId, maxSizeBytes, uploadMimeTypePolicy, }: UseTranscribeAudioParams) => UseTranscribeAudioResult;
 //# sourceMappingURL=useTranscribeAudio.d.ts.map

package/conversation/useTranscribeAudio/useTranscribeAudio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTranscribeAudio.d.ts","sourceRoot":"","sources":["../../../src/conversation/useTranscribeAudio/useTranscribeAudio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAShF,6EAA6E;AAC7E,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,iDAAiD;AACjD,MAAM,WAAW,wBAAwB;IACvC,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;IAC7D,iFAAiF;IACjF,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACvC;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,CACzB,MAAM,EAAE,8BAA8B,KACnC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,uDAAuD;IACvD,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAClC,4FAA4F;IAC5F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,8EAA8E;IAC9E,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACvC,sGAAsG;IACtG,eAAe,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACvE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,mHAQhC,wBAAwB,KAAG,wBAyE7B,CAAC"}
+{"version":3,"file":"useTranscribeAudio.d.ts","sourceRoot":"","sources":["../../../src/conversation/useTranscribeAudio/useTranscribeAudio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAShF,6EAA6E;AAC7E,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,+BAA+B;AAC/B,oBAAY,oBAAoB;IAC9B,QAAQ,aAAa;IACrB,SAAS,cAAc;CACxB;AAED,iDAAiD;AACjD,MAAM,WAAW,wBAAwB;IACvC,qDAAqD;IACrD,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;IAC7D,iFAAiF;IACjF,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACvC;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,CACzB,MAAM,EAAE,8BAA8B,KACnC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,uDAAuD;IACvD,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAClC,4FAA4F;IAC5F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,8EAA8E;IAC9E,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACvC,sGAAsG;IACtG,eAAe,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACvE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,yIAShC,wBAAwB,KAAG,wBAmF7B,CAAC"}

package/conversation/useTranscribeAudio/useTranscribeAudio.js

@@ -3,42 +3,48 @@ import { withTranscriptionRetry as n } from "./transcription-retry.js";
 import { normalizeMimeType as r } from "@epam/ai-dial-chat-shared";
 import { useCallback as i } from "react";
 //#region src/conversation/useTranscribeAudio/useTranscribeAudio.ts
-var a = ({ transcriptionApi: a, filesApi: o, transcribeWithDeployment: s, bucket: c, asrModelId: l, selectedDeploymentId: u, maxSizeBytes: d }) => ({ transcribeAudio: i(async (i, f) => {
-	if (f.throwIfAborted(), !c || !l && !u) throw new e(t.Unavailable);
+var a = /* @__PURE__ */ function(e) {
+	return e.Preserve = "preserve", e.Normalize = "normalize", e;
+}({}), o = ({ transcriptionApi: a, filesApi: o, transcribeWithDeployment: s, bucket: c, asrModelId: l, selectedDeploymentId: u, maxSizeBytes: d, uploadMimeTypePolicy: f = "preserve" }) => ({ transcribeAudio: i(async (i, p) => {
+	if (p.throwIfAborted(), !c || !l && !u) throw new e(t.Unavailable);
 	if (i.size > d) throw new e(t.TooLarge, d);
 	try {
-		let d = `uploads/${(/* @__PURE__ */ new Date()).toISOString().slice(0, 7)}/${encodeURIComponent(i.name)}`, { url: p } = await o.uploadFile({
+		let d = r(i.type), m = f === "normalize" && i.type !== d ? new File([i], i.name, {
+			type: d,
+			lastModified: i.lastModified
+		}) : i, h = `uploads/${(/* @__PURE__ */ new Date()).toISOString().slice(0, 7)}/${encodeURIComponent(i.name)}`, { url: g } = await o.uploadFile({
 			bucket: c,
-			path: d,
-			file: i
-		}, { signal: f });
-		f.throwIfAborted();
-		let m = r(i.type);
+			path: h,
+			file: m
+		}, { signal: p });
+		p.throwIfAborted();
+		let _ = r(i.type);
 		if (l) {
 			if (!a) throw new e(t.Unavailable);
 			return await n(async () => (await a.transcribeAudio({ transcribeAudioDto: {
-				audioUrl: p,
-				mimeType: m
-			} }, { signal: f })).transcript ?? "", f);
+				audioUrl: g,
+				mimeType: _
+			} }, { signal: p })).transcript ?? "", p);
 		}
 		if (!u || !s) throw new e(t.Unavailable);
 		return await n(() => s({
-			audioUrl: p,
-			mimeType: m,
+			audioUrl: g,
+			mimeType: _,
 			deployment: u,
-			signal: f
-		}), f);
+			signal: p
+		}), p);
 	} catch (n) {
-		throw f.aborted || n instanceof e ? n : new e(t.Failed);
+		throw p.aborted || n instanceof e ? n : new e(t.Failed);
 	}
 }, [
 	c,
 	l,
 	u,
 	d,
+	f,
 	o,
 	a,
 	s
 ]) });
 //#endregion
-export { a as useTranscribeAudio };
+export { a as UploadMimeTypePolicy, o as useTranscribeAudio };

package/conversation/useVisibleConversationIdsReporter/useVisibleConversationIdsReporter.d.ts

@@ -0,0 +1,16 @@
+/** Parameters of `useVisibleConversationIdsReporter`. */
+export interface UseVisibleConversationIdsReporterParams {
+    /** Conversations the view lists, by their list resource id. */
+    items: readonly {
+        id: string;
+    }[];
+    /** Whether the view is shown; a hidden view reports `null` but keeps its last ids. */
+    isVisible: boolean;
+    /** Maps a list resource id to the id the rendered panel reports. */
+    toPanelConversationId: (id: string) => string;
+    /** Registers this view's visible list ids, or `null` to withdraw them; usually from `useConversationTitleEnrichmentController`. */
+    setVisibleConversationIds: (viewKey: string, ids: string[] | null) => void;
+}
+/** Returns the panel's visible-ids callback, which registers the matching list ids under this view while it is visible. */
+export declare const useVisibleConversationIdsReporter: ({ items, isVisible, toPanelConversationId, setVisibleConversationIds, }: UseVisibleConversationIdsReporterParams) => ((panelIds: string[]) => void);
+//# sourceMappingURL=useVisibleConversationIdsReporter.d.ts.map

package/conversation/useVisibleConversationIdsReporter/useVisibleConversationIdsReporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVisibleConversationIdsReporter.d.ts","sourceRoot":"","sources":["../../../src/conversation/useVisibleConversationIdsReporter/useVisibleConversationIdsReporter.ts"],"names":[],"mappings":"AAEA,yDAAyD;AACzD,MAAM,WAAW,uCAAuC;IACtD,+DAA+D;IAC/D,KAAK,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjC,sFAAsF;IACtF,SAAS,EAAE,OAAO,CAAC;IACnB,oEAAoE;IACpE,qBAAqB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9C,mIAAmI;IACnI,yBAAyB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,KAAK,IAAI,CAAC;CAC5E;AAOD,2HAA2H;AAC3H,eAAO,MAAM,iCAAiC,GAAI,yEAK/C,uCAAuC,KAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,CAoCzE,CAAC"}

package/conversation/useVisibleConversationIdsReporter/useVisibleConversationIdsReporter.js

@@ -0,0 +1,17 @@
+import { useCallback as e, useEffect as t, useId as n, useMemo as r, useRef as i } from "react";
+//#region src/conversation/useVisibleConversationIdsReporter/useVisibleConversationIdsReporter.ts
+var a = ({ items: a, isVisible: o, toPanelConversationId: s, setVisibleConversationIds: c }) => {
+	let l = n(), u = r(() => new Map(a.map((e) => [s(e.id), e.id])), [a, s]), d = i([]), f = i(o), p = e(() => {
+		c(l, f.current ? d.current : null);
+	}, [c, l]), m = e((e) => {
+		d.current = e.flatMap((e) => {
+			let t = u.get(e);
+			return t ? [t] : [];
+		}), p();
+	}, [u, p]);
+	return t(() => {
+		f.current = o, p();
+	}, [o, p]), t(() => () => c(l, null), [c, l]), m;
+};
+//#endregion
+export { a as useVisibleConversationIdsReporter };

package/conversation-overlay.js

@@ -1,2 +1 @@
-import { toOverlayMessages as e } from "./conversation/overlay-messages.js";
-export { e as toOverlayMessages };
+export { toOverlayMessages } from "./conversation/overlay-messages.js";

package/conversation-sources/stage-citations.d.ts

@@ -0,0 +1,9 @@
+import { Stage } from '@epam/ai-dial-chat-shared';
+/**
+ * Returns `stages` with citation markup in each stage's `content` prepared
+ * for rendering (hidden while streaming, unsupported shapes escaped), keeping
+ * every stage without `<cit` markup — and the array itself when none has
+ * any — by reference so memoized stage rows are not re-rendered.
+ */
+export declare const prepareStageCitations: (stages: Stage[], isStreaming: boolean) => Stage[];
+//# sourceMappingURL=stage-citations.d.ts.map

package/conversation-sources/stage-citations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-citations.d.ts","sourceRoot":"","sources":["../../src/conversation-sources/stage-citations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAGvD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,KAAK,EAAE,EACf,aAAa,OAAO,KACnB,KAAK,EAUP,CAAC"}