@epam/ai-dial-chat-hooks 1.3.0-dev.34 → 1.3.0-dev.342

package/conversation/get-model-id-from-conversation-id.d.ts

@@ -0,0 +1,38 @@
+import { DeploymentItemDto } from '@epam/ai-dial-chat-api-client';
+/**
+ * Extracts the deployment/model ID from a DIAL Core conversation ID.
+ *
+ * The backend builds conversation paths as `{deploymentId}__{title}` then runs
+ * `encodeDialResourcePath` which splits on `/` and encodes each segment. This
+ * means both the deployment ID and the title may introduce extra `/`-separated
+ * URL segments:
+ *
+ *   - Deployment `anthropic/claude-3`, title `My chat`
+ *     → `conversations/bucket/anthropic/claude-3__My%20chat`
+ *
+ *   - Deployment `uuid`, title `calc 6/2/2026` (title contains slashes)
+ *     → `conversations/bucket/uuid__calc%206/2/2026`
+ *
+ * The `__` separator is present in the first filename segment. Versioned
+ * application deployments use `{name}__{version}__{title}`, so the version
+ * suffix still belongs to the deployment ID.
+ *
+ * In regular model conversations, the separator is always present in exactly
+ * one segment — the first one that contains it. Segments before that segment
+ * are deployment ID path prefixes; segments from that point onward are the
+ * title (possibly overflowing into further `/`-separated segments).
+ *
+ * Returns `undefined` when the format is unrecognised.
+ */
+export declare const getModelIdFromConversationId: (id: string) => string | undefined;
+/**
+ * Returns every deployment id a conversation id may belong to, longest first,
+ * or an empty array when the format is unrecognised.
+ */
+export declare const getModelIdCandidatesFromConversationId: (id: string) => string[];
+/**
+ * Returns the deployment a conversation belongs to, resolved from its id
+ * alone, or `undefined` when no candidate matches `deployments`.
+ */
+export declare const findDeploymentForConversationId: (deployments: DeploymentItemDto[], conversationId: string) => DeploymentItemDto | undefined;
+//# sourceMappingURL=get-model-id-from-conversation-id.d.ts.map

package/conversation/get-model-id-from-conversation-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-model-id-from-conversation-id.d.ts","sourceRoot":"","sources":["../../src/conversation/get-model-id-from-conversation-id.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AA+CvE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,4BAA4B,GACvC,IAAI,MAAM,KACT,MAAM,GAAG,SA0CX,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sCAAsC,GACjD,IAAI,MAAM,KACT,MAAM,EAYR,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,+BAA+B,GAC1C,aAAa,iBAAiB,EAAE,EAChC,gBAAgB,MAAM,KACrB,iBAAiB,GAAG,SAGL,CAAC"}

package/conversation/get-model-id-from-conversation-id.js

@@ -8,7 +8,7 @@ var t = "__", n = /[-+]/, r = /^\d+$/, i = ".scheduler", a = "applications", o =
 	if (n.length < 3) return;
 	let r = n.slice(2), o = r[0] === i ? r.slice(2) : r, c = o.findIndex((e) => e.includes(t));
 	if (c === -1) return;
-	let l = o[c], u = o.slice(0, c).filter(Boolean), d = s(l, u.at(-2) === a), f = [...u, d].filter(Boolean);
+	let l = o[c], u = o.slice(0, c).filter(Boolean), d = s(l, u.slice(0, -1).includes(a)), f = [...u, d].filter(Boolean);
 	return f.length > 0 ? f.join("/") : void 0;
 }, l = (e) => {
 	let t = c(e);

package/conversation/greeting.d.ts

@@ -0,0 +1,18 @@
+/** Pre-translated greeting phrase strings for each time-of-day period. */
+export interface GreetingTranslations {
+    morningWithName: string;
+    morningNoName: string;
+    afternoonWithName: string;
+    afternoonNoName: string;
+    eveningWithName: string;
+    eveningNoName: string;
+    nightWithName: string;
+    nightNoName: string;
+}
+/**
+ * Returns a time-of-day greeting string.
+ * Hour ranges: morning 5–11, afternoon 12–16, evening 17–20, night 21–4.
+ * When firstName is provided the with-name variant is returned; otherwise the no-name variant.
+ */
+export declare const getTimeOfDayGreeting: (hour: number, translations: GreetingTranslations, firstName?: string) => string;
+//# sourceMappingURL=greeting.d.ts.map

package/conversation/greeting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"greeting.d.ts","sourceRoot":"","sources":["../../src/conversation/greeting.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,MAAM,EACZ,cAAc,oBAAoB,EAClC,YAAY,MAAM,KACjB,MAeF,CAAC"}

package/conversation/message-factory.d.ts

@@ -0,0 +1,7 @@
+import { StatusMessage } from '@epam/ai-dial-chat-shared';
+/**
+ * Creates a status message recording a deployment change in the conversation timeline.
+ * Status messages are never forwarded to DIAL Core.
+ */
+export declare const createDeploymentChangedMessage: (previousDeploymentId: string | null, newDeploymentId: string) => StatusMessage;
+//# sourceMappingURL=message-factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"message-factory.d.ts","sourceRoot":"","sources":["../../src/conversation/message-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,aAAa,EAEd,MAAM,2BAA2B,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,8BAA8B,GACzC,sBAAsB,MAAM,GAAG,IAAI,EACnC,iBAAiB,MAAM,KACtB,aAcF,CAAC"}

package/conversation/message-utils.d.ts

@@ -0,0 +1,73 @@
+import { DeploymentConfigurationSchema, Message, ResponseFormat } from '@epam/ai-dial-chat-shared';
+/**
+ * Returns `true` when `message` is the actively-streaming assistant response.
+ * Only the last message in the list can be streaming, and only while
+ * `isAssistantTyping` is `true`.
+ */
+export declare const isMessageStreaming: (message: Message, messageIndex: number, totalMessages: number, isAssistantTyping: boolean) => boolean;
+/**
+ * Returns the deployment the conversation was last running on: scanning
+ * backwards, the `new_deployment_id` of a `model_changed` status message or
+ * the `deploymentId` a message carries in its own right, whichever comes
+ * later. `null` when neither is present.
+ *
+ * Reading only the status messages loses the switch whenever a regenerate or
+ * an edit truncates past one: the marker is appended at the end of the
+ * timeline, so truncating at an earlier message drops it, and the model the
+ * user picked reverted on the next page load even though the answer had been
+ * regenerated on it ([#8712](https://github.com/epam/ai-dial-chat/issues/8712)). The assistant message the backend writes
+ * carries the deployment that produced it, which survives that truncation
+ * because it *is* the regenerated message.
+ */
+export declare const getLastDeploymentId: (messages: Message[]) => string | null;
+/**
+ * Returns, for each message, the deployment it ran on: its own `deploymentId`,
+ * otherwise the model set by the latest preceding `model_changed` status
+ * message, otherwise `initialModelId`.
+ */
+export declare const getEffectiveDeploymentIds: (messages: readonly Message[], initialModelId?: string) => (string | undefined)[];
+/** True when `message` is an assistant message carrying at least one stage. */
+export declare const messageHasStages: (message: Message) => boolean;
+/**
+ * Returns the `configuration_value` stored on the last user message, or
+ * `undefined` if none exists. Used to restore the tools menu toggle state
+ * when a conversation is (re-)loaded, mirroring `getLastDeploymentId`.
+ */
+export declare const getLastUserMessageToolConfiguration: (messages: Message[]) => Record<string, unknown> | undefined;
+/**
+ * Returns the boolean values an assistant message's `form_schema` sets, keyed
+ * by property name, or `undefined` when no property resolves to a boolean.
+ * Lets a DIAL app switch a tools-menu toggle (e.g. `deep_research`) per
+ * message — on while a run is in progress, off once its result is delivered.
+ * Not filtered by tool id: `restoreToolConfiguration` ignores unknown ids.
+ */
+export declare const getToolConfigurationFromFormSchema: (formSchema: DeploymentConfigurationSchema | undefined) => Record<string, boolean> | undefined;
+/**
+ * Returns the tool configuration a (re-)loaded conversation should show: the
+ * last user message's `configuration_value`, overlaid in order by the
+ * `form_schema` values of the assistant messages after it. An app that turned
+ * a toggle off in its final response must not see it re-armed on reload just
+ * because the user message that started the run had it on.
+ */
+export declare const getLatestToolConfiguration: (messages: Message[]) => Record<string, unknown> | undefined;
+/**
+ * Returns the tool values the conversation's last message sets through its
+ * `form_schema`, restricted to `toolIds`, plus a key identifying that exact
+ * application. `undefined` when the last message is not an assistant message
+ * or sets no known tool.
+ *
+ * Streamed chunks and reloads re-create an identical `form_schema`; comparing
+ * keys rather than object identity applies an app's value once and leaves a
+ * later user toggle alone until the app sends a different value.
+ */
+export declare const getFormSchemaToolSyncKey: (conversationId: string, messages: Message[], toolIds: readonly string[]) => {
+    key: string;
+    values: Record<string, boolean>;
+} | undefined;
+/**
+ * Normalises a stored response-format string to the current enum. Legacy data
+ * may contain `'Markdown'` or `'PlainText'` (capital-first) instead of the
+ * current enum values `'markdown'` / `'plain_text'`.
+ */
+export declare const normalizeResponseFormat: (value: string | undefined) => ResponseFormat;
+//# sourceMappingURL=message-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"message-utils.d.ts","sourceRoot":"","sources":["../../src/conversation/message-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,6BAA6B,EAElC,OAAO,EAEP,cAAc,EAGf,MAAM,2BAA2B,CAAC;AAEnC;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC7B,SAAS,OAAO,EAChB,cAAc,MAAM,EACpB,eAAe,MAAM,EACrB,mBAAmB,OAAO,KACzB,OAGqC,CAAC;AAEzC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB,GAAI,UAAU,OAAO,EAAE,KAAG,MAAM,GAAG,IAYlE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GACpC,UAAU,SAAS,OAAO,EAAE,EAC5B,iBAAiB,MAAM,KACtB,CAAC,MAAM,GAAG,SAAS,CAAC,EActB,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,GAAI,SAAS,OAAO,KAAG,OAED,CAAC;AAEpD;;;;GAIG;AACH,eAAO,MAAM,mCAAmC,GAC9C,UAAU,OAAO,EAAE,KAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAO5B,CAAC;AA2BF;;;;;;GAMG;AACH,eAAO,MAAM,kCAAkC,GAC7C,YAAY,6BAA6B,GAAG,SAAS,KACpD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAQ5B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GACrC,UAAU,OAAO,EAAE,KAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAkB5B,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,GACnC,gBAAgB,MAAM,EACtB,UAAU,OAAO,EAAE,EACnB,SAAS,SAAS,MAAM,EAAE,KACzB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,SAoBrD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAClC,OAAO,MAAM,GAAG,SAAS,KACxB,cAIF,CAAC"}

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,53 @@
+import { ConversationListItemDto } from '@epam/ai-dial-chat-api-client';
+/** 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[];
+/** Returns a DIAL Core run's `{bucket}/{scheduleId}` group key, or `undefined` when the item is not a scheduled-task run. */
+export declare const getScheduledTaskRunGroupKey: (item: ConversationListItemDto) => string | undefined;
+/** Returns whether a DIAL Core conversation may be hidden behind a newer run: not pinned, shared with or published to the user. */
+export declare const isScheduledTaskRunCollapsible: (item: ConversationListItemDto) => boolean;
+//# 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,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAG7E,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;AAIJ,6HAA6H;AAC7H,eAAO,MAAM,2BAA2B,GACtC,MAAM,uBAAuB,KAC5B,MAAM,GAAG,SAQX,CAAC;AAEF,mIAAmI;AACnI,eAAO,MAAM,6BAA6B,GACxC,MAAM,uBAAuB,KAC5B,OAM4D,CAAC"}

package/conversation/scheduled-task-grouping.js

@@ -0,0 +1,45 @@
+import { safeDecodeURIComponent as e } from "../shared/string-utils.js";
+//#region src/conversation/scheduled-task-grouping.ts
+var t = (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;
+}, n = (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;
+}), r = (e, r) => {
+	let i = /* @__PURE__ */ new Map(), a = [];
+	for (let n of e) {
+		if (!r.isCollapsible(n)) continue;
+		let e = r.getGroupKey(n);
+		if (e === void 0) continue;
+		a.push({
+			item: n,
+			groupKey: e
+		});
+		let o = i.get(e);
+		(!o || t(n, o) < 0) && i.set(e, n);
+	}
+	return {
+		...r,
+		items: e,
+		collapsed: n(e, i, r),
+		runs: a.map((e) => ({
+			...e,
+			isRepresentative: i.get(e.groupKey) === e.item
+		}))
+	};
+}, i = (e, t) => {
+	if (t === void 0) return e.collapsed;
+	let r = e.runs.find(({ item: n }) => e.conversationIdsMatch(n.id, t));
+	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), n(e.items, i, e);
+}, a = (e, t) => i(r(e, t), t.activeConversationId), o = "conversations", s = (t) => {
+	if (!t.isScheduledTask || !t.scheduleId) return;
+	let n = e(t.id).split("/");
+	if (n[0] === o && n[1]) return `${n[1]}/${t.scheduleId}`;
+}, c = (e) => !e.isPinned && !e.sharedWithMe && !e.publishedWithMe;
+//#endregion
+export { i as applyActiveScheduledTaskRun, a as collapseScheduledTaskConversations, s as getScheduledTaskRunGroupKey, r as groupScheduledTaskConversations, c as isScheduledTaskRunCollapsible };

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