@epam/ai-dial-chat-hooks 1.3.0-dev.14 → 1.3.0-dev.142

package/conversation/message-utils.d.ts

@@ -0,0 +1,67 @@
+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;
+/** 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,+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/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/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,35 @@
+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;
+}
+/**
+ * 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. List refreshes and persistence rollback do not retry the write.
+ */
+export declare const useActiveConversationSync: ({ activeConversationId, items, refreshConversations, markConversationViewed, conversationIdsMatch, toPanelConversationId, }: 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;CAC/C;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,GAAI,6HAOvC,+BAA+B,KAAG,MAAM,GAAG,SAkC7C,CAAC"}

package/conversation/useAsyncConfirmDialog/useAsyncConfirmDialog.d.ts

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

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

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

package/conversation/useAttachmentUpload/useAttachmentUpload.d.ts

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

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

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

package/conversation/useAttachmentUpload/useAttachmentUpload.js

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

package/conversation/useConversationComposerDraft/useConversationComposerDraft.d.ts

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

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

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

package/conversation/useConversationComposerDraft/useConversationComposerDraft.js

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

package/conversation/useConversationExport/useConversationExport.d.ts

@@ -0,0 +1,72 @@
+import { ConversationsApi, FilesApi } from '@epam/ai-dial-chat-api-client';
+import { ConversationTransferJob } from '@epam/ai-dial-chat-shared';
+import { ConversationExportMode, ConversationTransferErrorEvent, ConversationTransferSuccessEvent, ConversationTransferWarningEvent } from '../conversation-transfer/types';
+/**
+ * Default ceiling on the summed byte length of an export's attachments.
+ *
+ * The bound is on *input* bytes even though what it protects is peak heap:
+ * the archive pipeline holds roughly three copies at once — every attachment
+ * in memory, `zipSync`'s output buffer (already-compressed media barely
+ * shrinks), and the copy `buildDialArchive` makes before handing it to `Blob`.
+ * 512 MiB of input therefore peaks near 1.5 GiB, which fits a 64-bit desktop
+ * tab. Sizing this against the ~2 GiB single-`ArrayBuffer` ceiling would be
+ * the wrong bound — that limits one buffer, not the three held together.
+ */
+export declare const DEFAULT_MAX_ARCHIVE_BYTES: number;
+interface ExportErrorClassification {
+    isUnauthorized?: boolean;
+    isNotFound?: boolean;
+}
+/** Parameters for {@link useConversationExport}. */
+export interface UseConversationExportParams {
+    /** Already-configured generated-client instance used to read conversations. */
+    conversationsApi: Pick<ConversationsApi, 'getConversation' | 'listConversations'>;
+    /** Already-configured generated-client instance used to download attachments. */
+    filesApi: Pick<FilesApi, 'downloadFileRaw'>;
+    /** Resolves a conversation id to the bucket-qualified path `getConversation` expects. */
+    normalizeConversationPath: (conversationId: string) => string;
+    /** Classifies a thrown error as unauthorized/not-found. Host-owned error taxonomy; defaults to neither. */
+    classifyTransferError?: (error: unknown) => ExportErrorClassification;
+    /** Resolves a trace id for a failing request, for display in an error notification. */
+    resolveErrorTraceId?: (error: unknown) => Promise<string | undefined>;
+    /**
+     * Ceiling on the summed byte length of an export's attachments; a larger
+     * export fails with `FileTooLarge` instead of being zipped. Defaults to
+     * {@link DEFAULT_MAX_ARCHIVE_BYTES}.
+     */
+    maxArchiveBytes?: number;
+    /** Called when a job completes successfully. */
+    onSuccess?: (event: ConversationTransferSuccessEvent) => void;
+    /** Called when a job succeeds but had to skip something (e.g. an unreachable attachment). */
+    onWarning?: (event: ConversationTransferWarningEvent) => void;
+    /** Called when a job fails. */
+    onError?: (event: ConversationTransferErrorEvent) => void;
+}
+/** Return value of {@link useConversationExport}. */
+export interface UseConversationExportResult {
+    /** Export jobs, most recently added last. Multiple jobs can be in progress concurrently. */
+    jobs: ConversationTransferJob[];
+    /** Enqueues a single-conversation export job and starts it immediately. */
+    exportSingle: (conversationId: string, title: string, mode: ConversationExportMode) => Promise<void>;
+    /** Enqueues an export-all job and starts it immediately. */
+    exportAll: () => Promise<void>;
+    /** Aborts a job's underlying requests and marks it canceled, keeping it in `jobs`. */
+    cancelJob: (jobId: string) => void;
+    /** Removes a job from the queue. If still in progress, aborts its underlying requests. */
+    dismissJob: (jobId: string) => void;
+    /** Re-attempts a failed or canceled job in place (same job id, same parameters). */
+    retryJob: (jobId: string) => void;
+    /** Aborts all in-progress jobs and clears the entire queue. */
+    dismissAll: () => void;
+}
+/**
+ * Owns the export job queue: fetches conversation data through the injected
+ * generated-client operations, builds the JSON v5 / ZIP output via the pure
+ * export utils, reports determinate per-job progress and structured
+ * success/warning/error events, and tracks each job's lifecycle (in progress /
+ * success / failed / canceled) independently so multiple exports can run
+ * concurrently.
+ */
+export declare const useConversationExport: ({ conversationsApi, filesApi, normalizeConversationPath, classifyTransferError, resolveErrorTraceId, maxArchiveBytes, onSuccess, onWarning, onError, }: UseConversationExportParams) => UseConversationExportResult;
+export {};
+//# sourceMappingURL=useConversationExport.d.ts.map

package/conversation/useConversationExport/useConversationExport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversationExport.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationExport/useConversationExport.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAGL,KAAK,uBAAuB,EAI7B,MAAM,2BAA2B,CAAC;AAqBnC,OAAO,EACL,sBAAsB,EACtB,KAAK,8BAA8B,EACnC,KAAK,gCAAgC,EAErC,KAAK,gCAAgC,EAEtC,MAAM,gCAAgC,CAAC;AASxC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,QAAoB,CAAC;AA2E3D,UAAU,yBAAyB;IACjC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAsBD,oDAAoD;AACpD,MAAM,WAAW,2BAA2B;IAC1C,+EAA+E;IAC/E,gBAAgB,EAAE,IAAI,CACpB,gBAAgB,EAChB,iBAAiB,GAAG,mBAAmB,CACxC,CAAC;IACF,iFAAiF;IACjF,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IAC5C,yFAAyF;IACzF,yBAAyB,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9D,2GAA2G;IAC3G,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,yBAAyB,CAAC;IACtE,uFAAuF;IACvF,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACtE;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,gCAAgC,KAAK,IAAI,CAAC;IAC9D,6FAA6F;IAC7F,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,gCAAgC,KAAK,IAAI,CAAC;IAC9D,+BAA+B;IAC/B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,8BAA8B,KAAK,IAAI,CAAC;CAC3D;AAED,qDAAqD;AACrD,MAAM,WAAW,2BAA2B;IAC1C,4FAA4F;IAC5F,IAAI,EAAE,uBAAuB,EAAE,CAAC;IAChC,2EAA2E;IAC3E,YAAY,EAAE,CACZ,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,sBAAsB,KACzB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,sFAAsF;IACtF,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,0FAA0F;IAC1F,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,oFAAoF;IACpF,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,+DAA+D;IAC/D,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAAI,wJAUnC,2BAA2B,KAAG,2BAuchC,CAAC"}