@epam/ai-dial-chat-hooks 1.1.0-dev.252 → 1.1.0-dev.253

package/conversation/useConversationHandlers/useConversationHandlers.d.ts

@@ -0,0 +1,66 @@
+import { ConversationsApi, FilesApi, RateApi, SendCompletionDtoModeEnum } from '@epam/ai-dial-chat-api-client';
+import { Attachment, Conversation, DisplayAttachment, MessageCustomContent, MessageRating, StarterOption } from '@epam/ai-dial-chat-shared';
+import { ConversationStateAccessor } from '../useConversationStream/useConversationStream';
+/** The exact `startStream` shape `useConversationStream` returns. */
+export type ConversationStreamStarter = (conversationPath: string, userContent: string, messageIndex: number, model: string, customContent?: MessageCustomContent, generationId?: string, mode?: SendCompletionDtoModeEnum) => void;
+/** Parameters for {@link useConversationHandlers}. */
+export interface UseConversationHandlersParams {
+    conversation: Conversation | null;
+    conversationId: string | undefined;
+    bucket: string | undefined;
+    isStreaming: boolean;
+    /** The `startStream` function returned by `useConversationStream`. */
+    startStream: ConversationStreamStarter;
+    /** Shared mutable channel for the displayed conversation — the same one passed to `useConversationStream`. */
+    state: ConversationStateAccessor;
+    /** Already-configured generated-client instance used to upload attachments. */
+    filesApi: Pick<FilesApi, 'uploadFile'>;
+    /** Already-configured generated-client instance used to save/delete the conversation. */
+    conversationsApi: Pick<ConversationsApi, 'saveConversation' | 'deleteConversation'>;
+    /** Already-configured generated-client instance used to rate a message. */
+    rateApi: Pick<RateApi, 'rateMessage'>;
+    /** Resolves the model id to send with the next completion. Re-evaluated on every call — never cached. */
+    resolveModelId: () => string;
+    /** Called when deleting the last message also deletes the whole conversation. */
+    onConversationDeleted?: () => void;
+    /** Called with batched filenames after a burst of network-error upload failures. */
+    showNetworkError?: (filenames: string[]) => void;
+    /** Tool toggle configuration values merged into every outgoing completion request. */
+    toolConfigurationValue?: Record<string, boolean>;
+}
+/** Return value of {@link useConversationHandlers}. */
+export interface UseConversationHandlersResult {
+    handleSend: (message: string, attachments: Attachment[]) => Promise<void>;
+    handleUploadAttachment: (attachment: Attachment) => Promise<string>;
+    handleRegenerateMessage: (messageIndex: number) => void;
+    handleDeleteMessage: (messageIndex: number) => void;
+    handleConfirmDelete: () => void;
+    handleRateMessage: (messageIndex: number, rating: MessageRating | null, comment?: string) => Promise<boolean>;
+    handleButtonSelect: (starter: StarterOption, propertyKey?: string, description?: string) => void;
+    handleConfirmStarter: () => void;
+    handleStartEdit: (messageIndex: number) => void;
+    handleCancelEdit: (messageIndex: number) => void;
+    handleEditMessage: (messageIndex: number, text: string, keptDisplayAttachments: DisplayAttachment[], newAttachments: Attachment[]) => Promise<void>;
+    editingMessageIndexes: Set<number>;
+    pendingDeleteIndex: number | null;
+    setPendingDeleteIndex: (index: number | null) => void;
+    pendingStarterContext: {
+        starter: StarterOption;
+        propertyKey?: string;
+        description?: string;
+    } | null;
+    setPendingStarterContext: (context: {
+        starter: StarterOption;
+        propertyKey?: string;
+        description?: string;
+    } | null) => void;
+}
+/**
+ * Composes send/regenerate/edit/delete/rate/starter-submission orchestration
+ * on top of the library's own `useAttachmentUpload` and the injected
+ * `startStream` (from `useConversationStream`). Optimistic message-pair
+ * insertion, delete confirmation, and rate revert-on-failure all mutate the
+ * shared `state` channel directly, in lockstep with the streaming hook.
+ */
+export declare const useConversationHandlers: ({ conversation, conversationId, bucket, isStreaming, startStream, state: { setConversation, conversationRef }, filesApi, conversationsApi, rateApi, resolveModelId, onConversationDeleted, showNetworkError, toolConfigurationValue, }: UseConversationHandlersParams) => UseConversationHandlersResult;
+//# sourceMappingURL=useConversationHandlers.d.ts.map

package/conversation/useConversationHandlers/useConversationHandlers.d.ts.map

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

package/conversation/useConversationImport/useConversationImport.d.ts

@@ -0,0 +1,50 @@
+import { ConversationsApi, FilesApi } from '@epam/ai-dial-chat-api-client';
+import { ConversationTransferErrorEvent, ConversationTransferJob, ConversationTransferSuccessEvent, ConversationTransferWarningEvent } from '../conversation-transfer/types';
+/** Parameters for {@link useConversationImport}. */
+export interface UseConversationImportParams {
+    /** Already-configured generated-client instance used to persist imported conversations. */
+    conversationsApi: Pick<ConversationsApi, 'saveConversation'>;
+    /** Already-configured generated-client instance used to list/upload attachments. */
+    filesApi: Pick<FilesApi, 'listFiles' | 'uploadFile'>;
+    /** The current user's DIAL Core storage bucket. Import fails with `MissingBucket` when `undefined`. */
+    bucket: string | undefined;
+    /** Called after at least one conversation in a job was imported successfully. */
+    onImported?: () => Promise<void> | void;
+    /** Classifies a thrown error as unauthorized. Host-owned error taxonomy; defaults to never. */
+    classifyTransferError?: (error: unknown) => {
+        isUnauthorized?: boolean;
+    };
+    /** Resolves a trace id for a failing request, for display in an error notification. */
+    resolveErrorTraceId?: (error: unknown) => Promise<string | undefined>;
+    /** Called when a job completes with at least one successfully imported conversation. */
+    onSuccess?: (event: ConversationTransferSuccessEvent) => void;
+    /** Called when a job succeeds but had to skip an attachment. */
+    onWarning?: (event: ConversationTransferWarningEvent) => void;
+    /** Called when a job fails, or when some conversations within it failed. */
+    onError?: (event: ConversationTransferErrorEvent) => void;
+}
+/** Return value of {@link useConversationImport}. */
+export interface UseConversationImportResult {
+    /** Import jobs, most recently added last. Multiple jobs can be in progress concurrently. */
+    jobs: ConversationTransferJob[];
+    /** Parses the given file and starts importing it as a new job. */
+    importConversations: (file: File) => Promise<void>;
+    /** Removes a job from the queue. If still in progress, aborts its underlying requests. */
+    dismissJob: (jobId: string) => void;
+    /** Re-attempts a failed job in place (same job id, reusing the already-parsed file). */
+    retryJob: (jobId: string) => void;
+    /** Aborts all in-progress jobs and clears the entire queue. */
+    dismissAll: () => void;
+}
+/**
+ * Owns the import job queue: parses a selected export file (`.json` or
+ * `.dial`/`.zip`, v5 envelope, old- or new-chat origin) once per file, then
+ * re-uploads any archive attachments to `uploads/<YYYY-MM>/` —
+ * disambiguating a name collision with a ` (n)` suffix instead of rejecting
+ * it — rewrites attachment references (and renamed titles), regenerates each
+ * conversation's id/path with a fresh UUID (collision-free save, no replace
+ * dialog), and persists every conversation through the injected
+ * `conversationsApi`. One job per imported file, not per conversation.
+ */
+export declare const useConversationImport: ({ conversationsApi, filesApi, bucket, onImported, classifyTransferError, resolveErrorTraceId, onSuccess, onWarning, onError, }: UseConversationImportParams) => UseConversationImportResult;
+//# sourceMappingURL=useConversationImport.d.ts.map

package/conversation/useConversationImport/useConversationImport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversationImport.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationImport/useConversationImport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,gBAAgB,EAChB,QAAQ,EACT,MAAM,+BAA+B,CAAC;AAmBvC,OAAO,EAKL,KAAK,8BAA8B,EACnC,KAAK,uBAAuB,EAC5B,KAAK,gCAAgC,EACrC,KAAK,gCAAgC,EACtC,MAAM,gCAAgC,CAAC;AAgExC,oDAAoD;AACpD,MAAM,WAAW,2BAA2B;IAC1C,2FAA2F;IAC3F,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;IAC7D,oFAAoF;IACpF,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,YAAY,CAAC,CAAC;IACrD,uGAAuG;IACvG,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACxC,+FAA+F;IAC/F,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK;QAAE,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACzE,uFAAuF;IACvF,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACtE,wFAAwF;IACxF,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,gCAAgC,KAAK,IAAI,CAAC;IAC9D,gEAAgE;IAChE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,gCAAgC,KAAK,IAAI,CAAC;IAC9D,4EAA4E;IAC5E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,8BAA8B,KAAK,IAAI,CAAC;CAC3D;AA2GD,qDAAqD;AACrD,MAAM,WAAW,2BAA2B;IAC1C,4FAA4F;IAC5F,IAAI,EAAE,uBAAuB,EAAE,CAAC;IAChC,kEAAkE;IAClE,mBAAmB,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,0FAA0F;IAC1F,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,wFAAwF;IACxF,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,+DAA+D;IAC/D,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,GAAI,gIAUnC,2BAA2B,KAAG,2BAiPhC,CAAC"}

package/conversation/useConversationStream/apply-chunk.d.ts

@@ -0,0 +1,20 @@
+import { Message, StreamChunk } from '@epam/ai-dial-chat-shared';
+/**
+ * Applies a single SSE stream chunk to the message list.
+ *
+ *
+ * Attachments are accumulated: each chunk's attachments are appended to the
+ * existing array rather than replacing it.
+ *
+ * Annotations are merged by `index`: partial `body.title` and `body.quote`
+ * strings are concatenated across chunks, matching the same delta-merge
+ * semantics used for stages.
+ *
+ * `state` is overwritten (not merged) by each chunk that carries one,
+ * matching the DIAL stateful-app contract.
+ *
+ * @returns Updated message array, or `null` when the chunk carries no
+ *   actionable data (empty content, no form_schema, and no attachments).
+ */
+export declare const applyChunkToMessages: (messages: Message[], messageIndex: number, chunk: StreamChunk) => Message[] | null;
+//# sourceMappingURL=apply-chunk.d.ts.map

package/conversation/useConversationStream/apply-chunk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-chunk.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationStream/apply-chunk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,OAAO,EAGP,WAAW,EACZ,MAAM,2BAA2B,CAAC;AA2FnC;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,OAAO,EAAE,EACnB,cAAc,MAAM,EACpB,OAAO,WAAW,KACjB,OAAO,EAAE,GAAG,IAqEd,CAAC"}

package/conversation/useConversationStream/conversation-path.d.ts

@@ -0,0 +1,9 @@
+/** Decodes a percent-encoded path segment, leaving it unchanged if decoding fails. */
+export declare const safeDecodeURI: (path: string) => string;
+/**
+ * Strips the leading bucket segment from a conversation id and decodes any
+ * already-percent-encoded remainder back to raw, so callers that re-encode
+ * the result once (e.g. an API client) don't double-encode it on the wire.
+ */
+export declare const getConversationPath: (conversationId: string) => string;
+//# sourceMappingURL=conversation-path.d.ts.map

package/conversation/useConversationStream/conversation-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-path.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationStream/conversation-path.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MAM5C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,gBAAgB,MAAM,KAAG,MAO5D,CAAC"}

package/conversation/useConversationStream/generation-resume.d.ts

@@ -0,0 +1,10 @@
+import { Conversation } from '@epam/ai-dial-chat-shared';
+/**
+ * True when the conversation's last message is an unresolved assistant
+ * placeholder: the backend only persists a conversation at generation start
+ * (empty placeholder) and at generation end (final content, or a partial
+ * flagged `streamErrorMessage`/`wasStoppedByUser`), so this shape means a
+ * generation was still active elsewhere when the conversation was loaded.
+ */
+export declare const isAwaitingGenerationResume: (conversation: Conversation) => boolean;
+//# sourceMappingURL=generation-resume.d.ts.map

package/conversation/useConversationStream/generation-resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation-resume.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationStream/generation-resume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE3E;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GACrC,cAAc,YAAY,KACzB,OASF,CAAC"}

package/conversation/useConversationStream/useConversationStream.d.ts

@@ -0,0 +1,78 @@
+import { SendCompletionDtoModeEnum } from '@epam/ai-dial-chat-api-client';
+import { Conversation, MessageCustomContent, StreamChunk } from '@epam/ai-dial-chat-shared';
+import { Dispatch, MutableRefObject, SetStateAction } from 'react';
+/** Options accepted by {@link ConversationStreamTransport.streamCompletion}. */
+export interface StreamCompletionOptions {
+    onChunk: (chunk: StreamChunk) => void;
+    onComplete: () => void | Promise<void>;
+    onError: (error: Error) => void;
+    signal: AbortSignal;
+}
+/**
+ * Host-owned transport for the DIAL Core completion protocol. Implemented at
+ * the app edge — never hardcodes an `/api` path, CSRF handling, or a
+ * `server-api` import; the library only depends on this interface's shape.
+ */
+export interface ConversationStreamTransport {
+    /** Starts a completion; delivers chunks/completion/error through `options`, aborted via `options.signal`. */
+    streamCompletion(path: string, message: string | undefined, model: string, options: StreamCompletionOptions, customContent?: MessageCustomContent, generationId?: string, mode?: SendCompletionDtoModeEnum, messageIndex?: number, clientChannelId?: string): void;
+    /** Requests the backend stop an active generation. */
+    stopCompletion(params: {
+        generationId: string;
+        path: string;
+    }): Promise<void>;
+    /** Opens a stream of resource-update events for `path`, until aborted via `signal`. */
+    watchConversation(path: string, signal: AbortSignal): Promise<ReadableStream<Uint8Array>>;
+    /** Reloads the persisted conversation by its full (bucket-qualified) id. */
+    getConversation(conversationId: string, signal?: AbortSignal): Promise<Conversation>;
+}
+/** Host-owned generation lifecycle, backing cross-navigation `AbortController` ownership. */
+export interface ConversationGenerationLifecycle {
+    /** Starts (or replaces) tracking for a generation on `path`, returning its `AbortController`. */
+    startGeneration: (path: string, generationId: string) => AbortController;
+    /** Marks the generation identified by `path`/`generationId` complete, if it is still the active one. */
+    completeGeneration: (path: string, generationId: string) => void;
+}
+/** Optional host-owned client-channel connection, used to nudge tool-signin delivery. */
+export interface ConversationStreamChannel {
+    channelId: string | null;
+    ensureConnected: () => void;
+}
+/** Optional host-owned overlay generation-lifecycle notifications. Each method is independently optional. */
+export interface ConversationStreamOverlayNotifier {
+    notifyGenerationStart?: () => void;
+    notifyGenerationEnd?: () => void;
+    notifyStopGenerating?: () => void;
+}
+/** Shared mutable channel through which the displayed conversation's state is read/written. */
+export interface ConversationStateAccessor {
+    setConversation: Dispatch<SetStateAction<Conversation | null>>;
+    conversationRef: MutableRefObject<Conversation | null>;
+}
+/** Parameters for {@link useConversationStream}. */
+export interface UseConversationStreamParams {
+    conversationId: string | undefined;
+    state: ConversationStateAccessor;
+    transport: ConversationStreamTransport;
+    generation: ConversationGenerationLifecycle;
+    channel?: ConversationStreamChannel;
+    overlay?: ConversationStreamOverlayNotifier;
+    onStopError?: (error: Error) => void;
+}
+/** Return value of {@link useConversationStream}. */
+export interface UseConversationStreamResult {
+    startStream: (conversationId: string, userContent: string, messageIndex: number, model: string, customContent?: MessageCustomContent, generationId?: string, mode?: SendCompletionDtoModeEnum) => void;
+    handleStop: () => void;
+    resumeIfAwaitingGeneration: (currentConversationId: string, conversation: Conversation) => void;
+    isStreaming: boolean;
+    canStopStreaming: boolean;
+}
+/**
+ * Owns completion-streaming state: per-path streaming/stoppable tracking,
+ * stale-chunk rejection, reload-after-complete, backend-driven stop, and
+ * hard-refresh resume detection — all driven through the injected
+ * `transport`/`generation`/`channel`/`overlay` capabilities rather than any
+ * app context or `server-api` import.
+ */
+export declare const useConversationStream: ({ conversationId, state: { setConversation, conversationRef }, transport, generation: { startGeneration, completeGeneration }, channel, overlay, onStopError, }: UseConversationStreamParams) => UseConversationStreamResult;
+//# sourceMappingURL=useConversationStream.d.ts.map

package/conversation/useConversationStream/useConversationStream.d.ts.map

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

package/index.d.ts

@@ -1,6 +1,21 @@
 export * from './attachment/useAttachmentAction/useAttachmentAction';
+export * from './attachment/useAttachmentValidation/useAttachmentValidation';
+export { EXPORT_APP_NAME } from './conversation/conversation-transfer/export-conversation';
+export { formatDateYM, formatDateYMD, } from './conversation/conversation-transfer/date';
+export { formatQuotedNameList } from './conversation/conversation-transfer/import-conversation';
+export * from './conversation/conversation-transfer/types';
 export * from './conversation/useAttachmentUpload/useAttachmentUpload';
+export * from './conversation/useConversationExport/useConversationExport';
+export { attachmentsToDtos, attachmentToDto, } from './conversation/useConversationHandlers/attachment-to-dto';
+export { createMessagePair, type MessagePair, } from './conversation/useConversationHandlers/message-factory';
+export { hasActiveToolConfig, isMessageChanged, } from './conversation/useConversationHandlers/message-utils';
+export { getStarterConversationText, getStarterSubmitText, } from './conversation/useConversationHandlers/starter-option';
+export * from './conversation/useConversationHandlers/useConversationHandlers';
+export * from './conversation/useConversationImport/useConversationImport';
 export * from './conversation/useConversationScroll/useConversationScroll';
+export { getConversationPath } from './conversation/useConversationStream/conversation-path';
+export { isAwaitingGenerationResume } from './conversation/useConversationStream/generation-resume';
+export * from './conversation/useConversationStream/useConversationStream';
 export * from './conversation-sources/useConversationSources/useConversationSources';
 export * from './usePageFileDrag/usePageFileDrag';
 export * from './usePanelMaxWidth/usePanelMaxWidth';

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sDAAsD,CAAC;AACrE,cAAc,wDAAwD,CAAC;AACvE,cAAc,4DAA4D,CAAC;AAC3E,cAAc,sEAAsE,CAAC;AACrF,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mDAAmD,CAAC;AAClE,cAAc,qCAAqC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sDAAsD,CAAC;AACrE,cAAc,8DAA8D,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,0DAA0D,CAAC;AAC3F,OAAO,EACL,YAAY,EACZ,aAAa,GACd,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0DAA0D,CAAC;AAChG,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wDAAwD,CAAC;AACvE,cAAc,4DAA4D,CAAC;AAC3E,OAAO,EACL,iBAAiB,EACjB,eAAe,GAChB,MAAM,0DAA0D,CAAC;AAClE,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,GACjB,MAAM,wDAAwD,CAAC;AAChE,OAAO,EACL,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,sDAAsD,CAAC;AAC9D,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,uDAAuD,CAAC;AAC/D,cAAc,gEAAgE,CAAC;AAC/E,cAAc,4DAA4D,CAAC;AAC3E,cAAc,4DAA4D,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,EAAE,0BAA0B,EAAE,MAAM,wDAAwD,CAAC;AACpG,cAAc,4DAA4D,CAAC;AAC3E,cAAc,sEAAsE,CAAC;AACrF,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mDAAmD,CAAC;AAClE,cAAc,qCAAqC,CAAC"}