@epam/statgpt-conversation-view 0.7.0-dev.34 → 0.7.0-dev.4

package/components/ConversationView/hooks/use-conversation-lifecycle.d.ts

@@ -0,0 +1,20 @@
+import { Conversation, ConversationInfo } from '@epam/ai-dial-shared';
+import { ConversationViewActions } from '../../../models/actions';
+export interface UseConversationLifecycleArgs {
+    actions: ConversationViewActions;
+    conversation: Conversation | null;
+    locale: string;
+    conversationsRoute?: string;
+    openUrl: (url: string) => void;
+    setConversations: (conversations: ConversationInfo[]) => void;
+}
+/**
+ * Conversation-level actions: duplicating the current (read-only) conversation
+ * — copying its attachments when the file actions are available, then creating
+ * the copy, refreshing the conversation list and navigating to it — and opening
+ * a fresh conversation from the onboarding footer.
+ */
+export declare const useConversationLifecycle: ({ actions, conversation, locale, conversationsRoute, openUrl, setConversations, }: UseConversationLifecycleArgs) => {
+    handleOpeningOfNewConversation: () => void;
+    duplicateConversation: () => Promise<void>;
+};

package/components/ConversationView/hooks/use-conversation-loader.d.ts

@@ -0,0 +1,24 @@
+import { Conversation } from '@epam/ai-dial-shared';
+import { Dispatch, SetStateAction } from 'react';
+import { ConversationViewActions } from '../../../models/actions';
+export interface UseConversationLoaderArgs {
+    conversationKey: string;
+    actions: ConversationViewActions;
+    setConversation: Dispatch<SetStateAction<Conversation | null>>;
+    setCrossDatasetAttachmentsState: () => void;
+    sendMessageToConversation: (content: string, data: Conversation | null, customChoiceId?: string) => void;
+    onConversationNotFound?: () => void;
+}
+/**
+ * Loads the conversation for the current `conversationKey`, derives its
+ * read-only flag, and sends the stored `prompt` to start the first turn when
+ * there are no user messages yet (an empty conversation, or one holding only a
+ * seed assistant message). Owns the `isLoading` / `isReadonlyConversation` UI
+ * state and clears the request cache around each load. On failure it marks the
+ * conversation read-only and calls `onConversationNotFound`. Re-fetches only
+ * when `conversationKey` changes.
+ */
+export declare const useConversationLoader: ({ conversationKey, actions, setConversation, setCrossDatasetAttachmentsState, sendMessageToConversation, onConversationNotFound, }: UseConversationLoaderArgs) => {
+    isLoading: boolean;
+    isReadonlyConversation: boolean;
+};

package/components/ConversationView/hooks/use-conversation-saver.d.ts

@@ -0,0 +1,13 @@
+import { Conversation } from '@epam/ai-dial-shared';
+import { ConversationViewActions } from '../../../models/actions';
+export interface UseConversationSaverArgs {
+    actions: ConversationViewActions;
+    conversationKey: string;
+}
+/**
+ * Persists the conversation back to the DIAL API via `actions.updateConversation`
+ * — only `name`, `messages` and `customViewState` are sent. Failures are logged
+ * and swallowed (the local state is left untouched). Shared by the streaming and
+ * message-feedback flows, which both flush local edits to the server.
+ */
+export declare const useConversationSaver: ({ actions, conversationKey, }: UseConversationSaverArgs) => (updatedConversation: Conversation) => Promise<void>;

package/components/ConversationView/hooks/use-conversation-streaming.d.ts

@@ -0,0 +1,35 @@
+import { Conversation } from '@epam/ai-dial-shared';
+import { Message } from '../../../../../dial-toolkit/src/index';
+import { HttpError } from '../../../../../shared-toolkit/src/index';
+import { Dispatch, SetStateAction } from 'react';
+import { StatusMessages } from '../../../types/texts';
+export interface UseConversationStreamingArgs {
+    conversation: Conversation | null;
+    setConversation: Dispatch<SetStateAction<Conversation | null>>;
+    saveConversation: (conversation: Conversation) => Promise<void>;
+    updateAssistantMessage: (assistantMessage: Message, partialMessage: Partial<Message>) => Message | undefined;
+    addUserMessageToConversation: (userMessage: Message) => void;
+    initializeAssistantMessage: () => Message;
+    isStreaming: boolean;
+    setIsStreaming: (isStreaming: boolean) => void;
+    statusMessages: StatusMessages;
+    isCrossDatasetModeOn: boolean;
+    token?: string | null;
+    handleInvalidStreaming?: (error: HttpError) => void;
+}
+/**
+ * The SSE streaming engine: starting/aborting a stream, merging partials,
+ * mapping transport errors to user-facing messages, persisting the finalized
+ * conversation, and the send / regenerate / edit entry points. Decoupled from
+ * the `conversation` prop for its core flow — every entry point receives the
+ * conversation as an explicit `data` argument; the prop is only read to derive
+ * the "retry last failed message" affordance.
+ */
+export declare const useConversationStreaming: ({ conversation, setConversation, saveConversation, updateAssistantMessage, addUserMessageToConversation, initializeAssistantMessage, isStreaming, setIsStreaming, statusMessages, isCrossDatasetModeOn, token, handleInvalidStreaming, }: UseConversationStreamingArgs) => {
+    sendMessageToConversation: (content: string, data: Conversation | null, customChoiceId?: string) => Promise<void>;
+    regenerateMessage: (message: Message, data: Conversation | null) => Promise<void>;
+    editMessage: (message: Message, data: Conversation | null) => Promise<void>;
+    onStopStreaming: () => void;
+    isLastMessageFailed: boolean;
+    regenerateLastMessage: (() => Promise<void>) | undefined;
+};

package/components/ConversationView/hooks/use-conversation-view.d.ts

@@ -0,0 +1,43 @@
+import { CustomViewState } from '../../../../../dial-toolkit/src/index';
+import { ConversationViewProps } from '../types';
+/**
+ * Orchestrates the ConversationView feature: reads the shared contexts once and
+ * composes the focused sub-hooks — saver → message mutations → streaming →
+ * feedback → lifecycle → loader, plus the standalone `useOnboardingSync`
+ * effects — then returns a flat view-model object consumed by the presentational
+ * layout. Mirrors the `useFilters` orchestration pattern. The only hard ordering
+ * constraint is that streaming is wired before the loader, since the loader
+ * auto-sends the first message via `sendMessageToConversation`.
+ */
+export declare const useConversationView: (props: ConversationViewProps) => {
+    isLoading: boolean;
+    isReadonlyConversation: boolean;
+    isStreaming: boolean;
+    isOpenedAdvancedView: boolean;
+    isShowOnboarding: boolean | undefined;
+    isAgentAvailable: boolean;
+    statusMessages: import('../../../types/texts').StatusMessages;
+    conversationViewState: CustomViewState | undefined;
+    messageServerActions: {
+        getFile: import('../../../types/actions').GetAttachmentContent;
+        putOnboardingFile: import('../../../types/actions').PutOnboardingFile;
+        getDataSet: import('../../../types/actions').GetDatasetDetails;
+        getDataSetData: import('../../../types/actions').GetDatasetData;
+        getConstraints: import('../../../types/actions').getConstraints;
+        updateCurrentDataQuery: (dataQuery?: import('../../../../../shared-toolkit/src/index').DataQuery) => void;
+        updateDataQueries: (dataQueries?: import('../../../../../shared-toolkit/src/index').DataQuery[]) => void;
+        updateDatasets: (datasets?: import('../../../../../sdmx-toolkit/src/index').Dataflow[]) => void;
+        downloadDataSet: import('../../../../../download-panel/src/types/actions').DownloadDatasetAction;
+    };
+    sendMessageToConversation: (content: string, data: import('@epam/ai-dial-shared').Conversation | null, customChoiceId?: string) => Promise<void>;
+    regenerateMessage: (message: import('../../../../../dial-toolkit/src/index').Message, data: import('@epam/ai-dial-shared').Conversation | null) => Promise<void>;
+    editMessage: (message: import('../../../../../dial-toolkit/src/index').Message, data: import('@epam/ai-dial-shared').Conversation | null) => Promise<void>;
+    onStopStreaming: () => void;
+    isLastMessageFailed: boolean;
+    regenerateLastMessage: (() => Promise<void>) | undefined;
+    rateResponse: (id: string, rate: import('@epam/ai-dial-shared').LikeState) => void;
+    handleCodeAttachmentUpdated: (messageId: string, newRawAttachment: import('@epam/ai-dial-shared').Attachment) => void;
+    duplicateConversation: () => Promise<void>;
+    handleOpeningOfNewConversation: () => void;
+};
+export type ConversationViewModel = ReturnType<typeof useConversationView>;

package/components/ConversationView/hooks/use-message-feedback.d.ts

@@ -0,0 +1,19 @@
+import { Attachment, Conversation, LikeState } from '@epam/ai-dial-shared';
+import { Dispatch, SetStateAction } from 'react';
+import { ConversationViewActions } from '../../../models/actions';
+export interface UseMessageFeedbackArgs {
+    actions: ConversationViewActions;
+    conversation: Conversation | null;
+    setConversation: Dispatch<SetStateAction<Conversation | null>>;
+    saveConversation: (conversation: Conversation) => Promise<void>;
+}
+/**
+ * Per-message feedback actions: rating a response (thumbs up/down) and
+ * replacing a Python code attachment after an in-place edit. Both persist the
+ * resulting conversation. `rateResponse` mutates `conversation.messages` in
+ * place — preserved as-is from the original component.
+ */
+export declare const useMessageFeedback: ({ actions, conversation, setConversation, saveConversation, }: UseMessageFeedbackArgs) => {
+    handleCodeAttachmentUpdated: (messageId: string, newRawAttachment: Attachment) => void;
+    rateResponse: (id: string, rate: LikeState) => void;
+};

package/components/ConversationView/hooks/use-message-mutations.d.ts

@@ -0,0 +1,17 @@
+import { Conversation } from '@epam/ai-dial-shared';
+import { Message } from '../../../../../dial-toolkit/src/index';
+import { Dispatch, SetStateAction } from 'react';
+export interface UseMessageMutationsArgs {
+    setConversation: Dispatch<SetStateAction<Conversation | null>>;
+}
+/**
+ * Local message-state mutations on the in-memory conversation: appending the
+ * user message, seeding an empty assistant message, and merging updates
+ * (streamed partials, or an error message) into that assistant message by id.
+ * Touches React state only — no persistence or network.
+ */
+export declare const useMessageMutations: ({ setConversation, }: UseMessageMutationsArgs) => {
+    addUserMessageToConversation: (userMessage: Message) => void;
+    initializeAssistantMessage: () => Message;
+    updateAssistantMessage: (assistantMessage: Message, partialMessage: Partial<Message>) => Message | undefined;
+};

package/components/ConversationView/hooks/use-onboarding-sync.d.ts

@@ -0,0 +1,11 @@
+import { ConversationViewActions } from '../../../models/actions';
+export interface UseOnboardingSyncArgs {
+    actions: ConversationViewActions;
+}
+/**
+ * Onboarding side-effects: uploading the onboarding file once its schema is
+ * available, and advancing past the "open advanced view" tooltip step when the
+ * advanced view is already open (so the user isn't prompted to open something
+ * they've already opened).
+ */
+export declare const useOnboardingSync: ({ actions }: UseOnboardingSyncArgs) => void;

package/components/ConversationView/types.d.ts

@@ -0,0 +1,45 @@
+import { Conversation, ConversationInfo } from '@epam/ai-dial-shared';
+import { DataQuery, FormatNumbersType, HttpError } from '../../../../shared-toolkit/src/index';
+import { LimitMessages } from '../../../../ui-components/src/index';
+import { Dispatch, ReactNode, SetStateAction } from 'react';
+import { ShareConversationProps } from '../../../../share-conversation/src/models/share-conversation';
+import { ConversationViewActions } from '../../models/actions';
+import { AttachmentsConfig } from '../../models/attachments';
+import { AttachmentsStyles } from '../../models/attachments-styles';
+import { EditMessageTitles, InputMessageStyles, MessageActionIcons, MessageActionTitles, MessageStyles } from '../../models/message';
+import { MetadataSettings } from '../../models/metadata';
+import { ConversationViewTitles } from '../../models/titles';
+export interface ConversationViewProps {
+    conversationKey: string;
+    conversation: Conversation | null;
+    actions: ConversationViewActions;
+    messageStyles?: MessageStyles;
+    attachmentsStyles?: AttachmentsStyles;
+    inputMessageStyles: InputMessageStyles;
+    shareConversationProps?: ShareConversationProps;
+    showConversationHeaderAdvancedView?: boolean;
+    formattingSettings?: FormatNumbersType;
+    metadataSettings?: MetadataSettings;
+    titles?: ConversationViewTitles;
+    expandStagesIcon?: ReactNode;
+    locale: string;
+    conversationsRoute?: string;
+    token?: string | null;
+    dataQuery?: DataQuery;
+    signOutTitle?: string;
+    setConversation: Dispatch<SetStateAction<Conversation | null>>;
+    setConversations: (conversations: ConversationInfo[]) => void;
+    openUrl: (url: string) => void;
+    signOutAction?: () => void;
+    handleInvalidStreaming?: (error: HttpError) => void;
+    onConversationNotFound?: () => void;
+    messageActionsIcons?: MessageActionIcons;
+    messageActionsTitles?: MessageActionTitles;
+    editMessageTitles: EditMessageTitles;
+    scrollBottomIcon?: ReactNode;
+    isFinalMessage?: boolean;
+    limitMessages: LimitMessages;
+    attachmentsConfig?: AttachmentsConfig;
+    headerRightSlot?: ReactNode;
+    children?: ReactNode;
+}