@epam/ai-dial-chat-hooks 1.3.0-dev.32 → 1.3.0-dev.321

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/useImportFilePicker/useImportFilePicker.d.ts

@@ -0,0 +1,32 @@
+import { ChangeEvent, RefObject } from 'react';
+/** Parameters for `useImportFilePicker`. */
+export interface UseImportFilePickerParams {
+    /**
+     * MIME types / file-extension filter string passed to the hidden input's
+     * `accept` attribute. The host resolves any platform-specific policy before
+     * passing this value.
+     */
+    accept?: string;
+    /** Called with the selected `File` after the user confirms their choice. */
+    onFileSelected: (file: File) => void;
+}
+/** Controls returned by `useImportFilePicker`. */
+export interface UseImportFilePickerResult {
+    /** Ref to attach to the hidden `<input type="file">` element. */
+    inputRef: RefObject<HTMLInputElement | null>;
+    /** Programmatically opens the native file picker by clicking the hidden input. */
+    triggerImport: () => void;
+    /** `onChange` handler for the hidden input; calls `onFileSelected` and resets the value. */
+    handleFileChange: (event: ChangeEvent<HTMLInputElement>) => void;
+}
+/**
+ * Manages the hidden `<input type="file">` pattern used to trigger a native
+ * file-picker without a visible control.
+ *
+ * The host renders `<input ref={inputRef} type="file" onChange={handleFileChange} />`
+ * and calls `triggerImport()` when the user initiates an import action. The
+ * hook sets the `accept` attribute via a layout effect so re-selecting the
+ * same file always fires `onChange` (the value is reset after each selection).
+ */
+export declare const useImportFilePicker: ({ accept, onFileSelected, }: UseImportFilePickerParams) => UseImportFilePickerResult;
+//# sourceMappingURL=useImportFilePicker.d.ts.map

package/conversation/useImportFilePicker/useImportFilePicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useImportFilePicker.d.ts","sourceRoot":"","sources":["../../../src/conversation/useImportFilePicker/useImportFilePicker.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,4CAA4C;AAC5C,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,cAAc,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;CACtC;AAED,kDAAkD;AAClD,MAAM,WAAW,yBAAyB;IACxC,iEAAiE;IACjE,QAAQ,EAAE,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC7C,kFAAkF;IAClF,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,4FAA4F;IAC5F,gBAAgB,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;CAClE;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,GAAI,6BAGjC,yBAAyB,KAAG,yBA6B9B,CAAC"}

package/conversation/useMessageSelectionReply/useMessageSelectionReply.d.ts

@@ -0,0 +1,42 @@
+import { Attachment } from '@epam/ai-dial-chat-shared';
+/** A stable snapshot of one eligible native text selection. */
+export interface MessageSelectionReplySnapshot {
+    /** Scope that owned the selection when it was captured. */
+    conversationId: string;
+    /** Message text root containing the captured range. */
+    body: HTMLDivElement;
+    /** Captured native range. */
+    range: Range;
+    /** Native selected text preserved for the generated file. */
+    text: string;
+    /** Visible fragment of the selected range. */
+    rect: DOMRect;
+}
+/** Parameters accepted by {@link useMessageSelectionReply}. */
+export interface UseMessageSelectionReplyParams {
+    /** Identifier used to discard selection and queued files after a scope change. */
+    conversationId: string;
+    /** Whether the host currently permits a Reply attachment. */
+    enabled: boolean;
+    /** Files from the host's ordinary page-drop queue. */
+    droppedFiles: File[];
+    /** Acknowledges the captured page-drop batch after the composer accepts it. */
+    onDroppedFilesConsumed: () => void;
+}
+/**
+ * Captures eligible message text and creates Reply files for an existing composer
+ * attachment flow without acquiring host deployment, upload or localization knowledge.
+ */
+export declare const useMessageSelectionReply: ({ conversationId, enabled, droppedFiles, onDroppedFilesConsumed, }: UseMessageSelectionReplyParams) => {
+    contentRef: (node: HTMLDivElement | null) => (() => void) | undefined;
+    actionRef: import('react').RefObject<HTMLDivElement | null>;
+    selection: MessageSelectionReplySnapshot | null;
+    onReply: () => void;
+    dismiss: () => void;
+    pendingFiles: File[];
+    onFilesConsumed: () => void;
+    focusRequestId: number | undefined;
+    onAttachmentsChange: (attachments: Attachment[]) => void;
+    addedRevision: number;
+};
+//# sourceMappingURL=useMessageSelectionReply.d.ts.map

package/conversation/useMessageSelectionReply/useMessageSelectionReply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMessageSelectionReply.d.ts","sourceRoot":"","sources":["../../../src/conversation/useMessageSelectionReply/useMessageSelectionReply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAU5D,+DAA+D;AAC/D,MAAM,WAAW,6BAA6B;IAC5C,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,IAAI,EAAE,cAAc,CAAC;IACrB,6BAA6B;IAC7B,KAAK,EAAE,KAAK,CAAC;IACb,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,IAAI,EAAE,OAAO,CAAC;CACf;AAED,+DAA+D;AAC/D,MAAM,WAAW,8BAA8B;IAC7C,kFAAkF;IAClF,cAAc,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,YAAY,EAAE,IAAI,EAAE,CAAC;IACrB,+EAA+E;IAC/E,sBAAsB,EAAE,MAAM,IAAI,CAAC;CACpC;AA2CD;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GAAI,oEAKtC,8BAA8B;uBAyBtB,cAAc,GAAG,IAAI;;;;;;;;uCA6QwB,UAAU,EAAE;;CA0BnE,CAAC"}

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/audio-transcription-error.d.ts

@@ -0,0 +1,19 @@
+/** Reason a {@link useTranscribeAudio} call failed, translation-free — the host maps it to text. */
+export declare enum AudioTranscriptionErrorReason {
+    /** No usable ASR model or deployment is configured for the current bucket. */
+    Unavailable = "unavailable",
+    /** The recording exceeds the caller's configured size limit. */
+    TooLarge = "tooLarge",
+    /** Recognition is rate-limited, unavailable, or exhausted short gateway retries. */
+    Busy = "busy",
+    /** Recognition failed for any other reason. */
+    Failed = "failed"
+}
+/** Thrown by `transcribeAudio`; carries a machine-readable `reason` instead of translated text. */
+export declare class AudioTranscriptionError extends Error {
+    readonly reason: AudioTranscriptionErrorReason;
+    /** The size limit that was exceeded, present only when `reason` is `TooLarge`. */
+    readonly limitBytes?: number;
+    constructor(reason: AudioTranscriptionErrorReason, limitBytes?: number);
+}
+//# sourceMappingURL=audio-transcription-error.d.ts.map

package/conversation/useTranscribeAudio/audio-transcription-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-transcription-error.d.ts","sourceRoot":"","sources":["../../../src/conversation/useTranscribeAudio/audio-transcription-error.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,oBAAY,6BAA6B;IACvC,8EAA8E;IAC9E,WAAW,gBAAgB;IAC3B,gEAAgE;IAChE,QAAQ,aAAa;IACrB,oFAAoF;IACpF,IAAI,SAAS;IACb,+CAA+C;IAC/C,MAAM,WAAW;CAClB;AAED,mGAAmG;AACnG,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,MAAM,EAAE,6BAA6B,CAAC;IAC/C,kFAAkF;IAClF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,MAAM,EAAE,6BAA6B,EAAE,UAAU,CAAC,EAAE,MAAM;CAMvE"}

package/conversation/useTranscribeAudio/transcription-retry.d.ts

@@ -0,0 +1,2 @@
+export declare const withTranscriptionRetry: (recognize: () => Promise<string>, signal: AbortSignal) => Promise<string>;
+//# sourceMappingURL=transcription-retry.d.ts.map

package/conversation/useTranscribeAudio/transcription-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcription-retry.d.ts","sourceRoot":"","sources":["../../../src/conversation/useTranscribeAudio/transcription-retry.ts"],"names":[],"mappings":"AAiCA,eAAO,MAAM,sBAAsB,GACjC,WAAW,MAAM,OAAO,CAAC,MAAM,CAAC,EAChC,QAAQ,WAAW,KAClB,OAAO,CAAC,MAAM,CAmChB,CAAC"}

package/conversation/useTranscribeAudio/useTranscribeAudio.d.ts

@@ -0,0 +1,50 @@
+import { FilesApi, TranscriptionApi } from '@epam/ai-dial-chat-api-client';
+/** Request shape the host's selected-deployment recognition call accepts. */
+export interface TranscribeWithDeploymentParams {
+    audioUrl: string;
+    mimeType: string;
+    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. */
+    filesApi: Pick<FilesApi, 'uploadFile'>;
+    /**
+     * Host-configured call for the selected-deployment path. The generated
+     * chat-completions client cannot express this endpoint's `custom_content`
+     * request shape, so the host supplies its own raw request.
+     */
+    transcribeWithDeployment?: (params: TranscribeWithDeploymentParams) => Promise<string>;
+    /** DIAL Core bucket the recording is uploaded into. */
+    bucket: string | undefined | null;
+    /** Recognizes via `transcriptionApi` when set; otherwise `selectedDeploymentId` is used. */
+    asrModelId?: string;
+    /** Deployment id used for recognition when `asrModelId` is not set. */
+    selectedDeploymentId?: string | null;
+    /** Recordings larger than this are rejected with `TooLarge` before upload. */
+    maxSizeBytes: number;
+}
+/** Return value of {@link useTranscribeAudio}. */
+export interface UseTranscribeAudioResult {
+    /** Uploads and recognizes one complete recording; rejects with an {@link AudioTranscriptionError}. */
+    transcribeAudio: (file: File, signal: AbortSignal) => Promise<string>;
+}
+/**
+ * Uploads a complete voice recording to DIAL Core storage and recognizes it,
+ * preferring the configured ASR model and falling back to the selected
+ * deployment. Retries transient upstream failures. Error text is not this
+ * library's concern — callers translate `AudioTranscriptionErrorReason` at
+ * the call site.
+ */
+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

@@ -0,0 +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,+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"}