@epam/ai-dial-chat-hooks 1.2.0-dev.75 → 1.2.0-dev.78

package/file-manager.d.ts

@@ -24,6 +24,7 @@ import { DiscardSharedItemDto } from '@epam/ai-dial-chat-api-client';
 import { DiscardSharedResponseDto } from '@epam/ai-dial-chat-api-client';
 import { DisplayAttachment } from '@epam/ai-dial-chat-shared';
 import { FileManagerColumnKey } from '@epam/ai-dial-react-file-manager';
+import { FileManagerSelectableNode } from '@epam/ai-dial-chat-shared';
 import { FileMetadataResponseDto } from '@epam/ai-dial-chat-api-client';
 import { FilesApi } from '@epam/ai-dial-chat-api-client';
 import { FileUploadBatchState } from '@epam/ai-dial-chat-shared';
@@ -521,7 +522,14 @@ export declare const mergeCreatedFolderIntoCache: (cache: Map<string, ListFilesI
 /** Formats MIME types as a human-readable, comma-separated list of dotted extensions (or the MIME type itself for wildcards). */
 export declare const mimeTypesToAttachmentExtensionLabels: (types: string[]) => string;
 
-/** Normalizes `*` to the all-files wildcard and drops any value that is not a valid `DialFileAcceptType`. */
+/**
+ * Normalizes `*` to the all-files wildcard, canonicalizes MIME aliases, and drops
+ * any value that is not a valid `DialFileAcceptType`.
+ *
+ * Aliases are resolved because a file picker matches an `accept` entry against its
+ * own MIME table: a declared `text/json` offers no `.json` file, while the
+ * `application/json` it denotes does.
+ */
 export declare const mimeTypesToDialFileAcceptTypes: (types?: string[]) => DialFileAcceptType[] | undefined;
 
 /**
@@ -1101,6 +1109,64 @@ export declare interface UseDialFileUploadBatchResult {
     clearUploadBatch: () => void;
 }
 
+/**
+ * Composes the file-manager tab/listing hooks into the stateful part of an attachment picker:
+ * active tab, selected paths, and hidden-path/MIME/size/folder row eligibility. Returns the
+ * existing `useDialFileManager` controller unchanged and the selection/tab/eligibility fields
+ * `FileManagerAttachModal` already consumes — it composes that modal, it does not replace it.
+ * Final attachment filtering, deduplication, and count enforcement stay owned by the modal.
+ */
+export declare const useFileAttachmentPicker: ({ fileManagerOptions, bucket, forbiddenSymbolsRegExp, tabLabels, allowedTabs, initialTab, allowedTypes, maxSelectableFileSize, canAttachFolders, }: UseFileAttachmentPickerOptions) => UseFileAttachmentPickerResult;
+
+/** Options accepted by {@link useFileAttachmentPicker}. */
+export declare interface UseFileAttachmentPickerOptions {
+    /**
+     * Configured `useDialFileManager` options besides the values this hook derives:
+     * `bucket`, `activeTab`, `rootLabel`, `variant`, and `forbiddenSymbolsRegExp`.
+     */
+    fileManagerOptions: Omit<UseDialFileManagerOptions, 'bucket' | 'activeTab' | 'rootLabel' | 'variant' | 'forbiddenSymbolsRegExp'>;
+    /** DIAL Core bucket to browse. */
+    bucket: string;
+    /** Regexp of characters forbidden in file/folder names, forwarded to `useDialFileManager`. */
+    forbiddenSymbolsRegExp?: RegExp;
+    /** Host-translated label per tab; also supplies the active tab's root-folder label. */
+    tabLabels: Record<DialFileManagerTabs, string>;
+    /** Tab ids the host's configuration allows. `undefined` allows every tab. */
+    allowedTabs?: string[];
+    /** Initial active tab. Defaults to `DialFileManagerTabs.MyFiles`. */
+    initialTab?: DialFileManagerTabs;
+    /** MIME types eligible for selection/upload. Empty or absent allows every type. */
+    allowedTypes?: string[];
+    /** Files at or below this size (bytes) remain eligible; absent allows any size. */
+    maxSelectableFileSize?: number;
+    /** Whether folder rows are eligible for selection. Defaults to `false`. */
+    canAttachFolders?: boolean;
+}
+
+/** Result returned by {@link useFileAttachmentPicker}. */
+export declare interface UseFileAttachmentPickerResult {
+    /** The composed file-manager controller; forward to `FileManagerAttachModal`'s `controller` prop. */
+    controller: UseDialFileManagerResult;
+    /** Active tab. */
+    activeTab: DialFileManagerTabs;
+    /** Tab list filtered to `allowedTabs`; forward to `FileManagerAttachModal`'s `tabs` prop. */
+    tabs: ToolbarOptions['tabs'];
+    /** Switches the active tab and clears the current selection. */
+    onTabChange: (tab: DialFileManagerTabs) => void;
+    /** Currently selected paths. */
+    selectedPaths: Set<string>;
+    /** Replaces the selection with a defensive copy of the given set. */
+    onSelectedPathsChange: (paths: Set<string>) => void;
+    /** Row eligibility predicate; forward to `FileManagerAttachModal`'s `isRowSelectable` prop. */
+    isRowSelectable: (node: {
+        data?: FileManagerSelectableNode | null;
+    }) => boolean;
+    /** MIME eligibility predicate; forward to `FileManagerAttachModal`'s `isFileTypeAllowed` prop. */
+    isFileTypeAllowed: (contentType: string) => boolean;
+    /** Accepted upload MIME types; forward to `FileManagerAttachModal`'s `allowedFileTypes` prop. */
+    allowedFileTypes: DialFileAcceptType[] | undefined;
+}
+
 export { useGridEditingScroll }
 
 export { UseGridEditingScrollOptions }

package/file-manager.js

@@ -24,5 +24,6 @@ import { useDialFileSharing as me } from "./files/useDialFileSharing/useDialFile
 import { useDialFileUploadBatch as he } from "./files/useDialFileUploadBatch/useDialFileUploadBatch.js";
 import { useDialFileManager as ge } from "./files/useDialFileManager/useDialFileManager.js";
 import { useDialFileManagerTabConfig as _e } from "./files/useDialFileManagerTabConfig/useDialFileManagerTabConfig.js";
-import { useGridEditingScroll as ve } from "@epam/ai-dial-chat-shared";
-export { m as COLUMNS_WITHOUT_AUTHOR, h as COLUMNS_WITH_AUTHOR, g as CORE_PERMISSION_MAP, _ as DATE_OPTIONS, x as DialFileManagerActionProfile, S as DialFileManagerVariant, u as DialFilesApiUploadMode, le as DownloadDestinationType, d as FileManagerNotificationReason, f as FileNameValidationErrorReason, p as FileOperationKind, v as PATH_SEPARATOR_REGEXP, y as RESERVED_MARKER_NAME, b as UPLOAD_CONCURRENCY, re as annotationToDisplayAttachment, ie as attachmentDtoToDisplayAttachment, ae as attachmentDtosToDisplayAttachments, H as buildFromCache, w as buildSharedItemVirtualPath, Z as createFilesApiClient, Q as createUploadFileWithProgress, C as deriveActionProfile, T as dialCorePathToRelative, oe as dialFileToAttachment, se as dialFilesToAttachments, ce as dialFolderPathToAttachment, U as fetchByTab, W as fetchForSearch, E as findDialFileByPath, G as findFirstSuccessfulCopyMoveItem, D as findFolderByVirtualPath, O as formatOperationFolderName, L as getParentFolderPath, ee as getUrlFileName, k as getVirtualPathName, A as hasDialFileWritePermission, j as hasForbiddenNameSymbols, M as isCopyMoveDuplicateAllowed, r as isDialFileAcceptType, e as isDialFileId, te as isExternalSourcePreviewable, N as isShareActionsAllowed, K as mapCorePermissions, q as mapFileMetadataToDialFile, J as mapSearchItem, Y as mergeCreatedFolderIntoCache, i as mimeTypesToAttachmentExtensionLabels, a as mimeTypesToDialFileAcceptTypes, o as mimeTypesToFileAccept, P as normalizeVirtualPath, $ as openAnnotationAttachment, F as parseNewFolderVirtualPath, B as prepareCopyItems, ue as prepareDownloadDestination, V as prepareMoveRenameItems, R as resolveDialFileApiPath, t as resolveDialFileBucketAndPath, ne as resolveExternalSourceContentType, I as resolveOwnerCoords, n as resolveRelativeDialFilePath, s as sanitizeFileName, c as splitFileNameExtension, l as trimFileNameToByteLimit, X as updateEntry, de as useDialFileListing, ge as useDialFileManager, _e as useDialFileManagerTabConfig, fe as useDialFileMetadata, pe as useDialFileMutations, me as useDialFileSharing, he as useDialFileUploadBatch, ve as useGridEditingScroll, z as virtualPathToApiPath };
+import { useFileAttachmentPicker as ve } from "./files/useFileAttachmentPicker/useFileAttachmentPicker.js";
+import { useGridEditingScroll as ye } from "@epam/ai-dial-chat-shared";
+export { m as COLUMNS_WITHOUT_AUTHOR, h as COLUMNS_WITH_AUTHOR, g as CORE_PERMISSION_MAP, _ as DATE_OPTIONS, x as DialFileManagerActionProfile, S as DialFileManagerVariant, u as DialFilesApiUploadMode, le as DownloadDestinationType, d as FileManagerNotificationReason, f as FileNameValidationErrorReason, p as FileOperationKind, v as PATH_SEPARATOR_REGEXP, y as RESERVED_MARKER_NAME, b as UPLOAD_CONCURRENCY, re as annotationToDisplayAttachment, ie as attachmentDtoToDisplayAttachment, ae as attachmentDtosToDisplayAttachments, H as buildFromCache, w as buildSharedItemVirtualPath, Z as createFilesApiClient, Q as createUploadFileWithProgress, C as deriveActionProfile, T as dialCorePathToRelative, oe as dialFileToAttachment, se as dialFilesToAttachments, ce as dialFolderPathToAttachment, U as fetchByTab, W as fetchForSearch, E as findDialFileByPath, G as findFirstSuccessfulCopyMoveItem, D as findFolderByVirtualPath, O as formatOperationFolderName, L as getParentFolderPath, ee as getUrlFileName, k as getVirtualPathName, A as hasDialFileWritePermission, j as hasForbiddenNameSymbols, M as isCopyMoveDuplicateAllowed, r as isDialFileAcceptType, e as isDialFileId, te as isExternalSourcePreviewable, N as isShareActionsAllowed, K as mapCorePermissions, q as mapFileMetadataToDialFile, J as mapSearchItem, Y as mergeCreatedFolderIntoCache, i as mimeTypesToAttachmentExtensionLabels, a as mimeTypesToDialFileAcceptTypes, o as mimeTypesToFileAccept, P as normalizeVirtualPath, $ as openAnnotationAttachment, F as parseNewFolderVirtualPath, B as prepareCopyItems, ue as prepareDownloadDestination, V as prepareMoveRenameItems, R as resolveDialFileApiPath, t as resolveDialFileBucketAndPath, ne as resolveExternalSourceContentType, I as resolveOwnerCoords, n as resolveRelativeDialFilePath, s as sanitizeFileName, c as splitFileNameExtension, l as trimFileNameToByteLimit, X as updateEntry, de as useDialFileListing, ge as useDialFileManager, _e as useDialFileManagerTabConfig, fe as useDialFileMetadata, pe as useDialFileMutations, me as useDialFileSharing, he as useDialFileUploadBatch, ve as useFileAttachmentPicker, ye as useGridEditingScroll, z as virtualPathToApiPath };

package/files/attachment-types.js

@@ -1,16 +1,17 @@
-import { extension as e } from "mime-types";
+import { normalizeMimeType as e } from "@epam/ai-dial-chat-shared";
+import { extension as t } from "mime-types";
 //#region src/files/attachment-types.ts
-var t = "*/*", n = (e) => e.startsWith(".") || e.includes("/"), r = (e) => {
-	if (e != null) return e.map((e) => e === "*" ? t : e).filter(n);
-}, i = (e) => {
-	let n = r(e);
-	if (!(n == null || n.length === 0) && !n.some((e) => e === t)) return n.join(",");
-}, a = (t) => t.map((t) => {
-	if (t.endsWith("/*")) return t;
-	let n = e(t);
-	if (n !== !1) return `.${n}`;
-	let r = t.split("/")[1];
-	return r == null ? t : `.${r.toLowerCase()}`;
+var n = "*/*", r = (e) => e.startsWith(".") || e.includes("/"), i = (t) => {
+	if (t != null) return t.map((t) => t === "*" ? n : t.startsWith(".") ? t : e(t)).filter(r);
+}, a = (e) => {
+	let t = i(e);
+	if (!(t == null || t.length === 0) && !t.some((e) => e === n)) return t.join(",");
+}, o = (n) => n.map((n) => {
+	if (n.endsWith("/*")) return n;
+	let r = e(n), i = t(r);
+	if (i !== !1) return `.${i}`;
+	let a = r.split("/")[1];
+	return a == null ? n : `.${a.toLowerCase()}`;
 }).join(", ");
 //#endregion
-export { n as isDialFileAcceptType, a as mimeTypesToAttachmentExtensionLabels, r as mimeTypesToDialFileAcceptTypes, i as mimeTypesToFileAccept };
+export { r as isDialFileAcceptType, o as mimeTypesToAttachmentExtensionLabels, i as mimeTypesToDialFileAcceptTypes, a as mimeTypesToFileAccept };

package/files/useFileAttachmentPicker/useFileAttachmentPicker.js

@@ -0,0 +1,43 @@
+import { mimeTypesToDialFileAcceptTypes as e } from "../attachment-types.js";
+import { DialFileManagerVariant as t } from "../file-manager-variant.js";
+import { useDialFileManager as n } from "../useDialFileManager/useDialFileManager.js";
+import { useDialFileManagerTabConfig as r } from "../useDialFileManagerTabConfig/useDialFileManagerTabConfig.js";
+import { isHiddenPath as i } from "@epam/ai-dial-chat-shared";
+import { useCallback as a, useMemo as o, useState as s } from "react";
+import { isMimeTypeAllowed as c } from "@epam/ai-dial-attachment-input";
+import { DialFileManagerTabs as l, DialFileNodeType as u, useDialFileManagerTabs as d } from "@epam/ai-dial-react-file-manager";
+//#region src/files/useFileAttachmentPicker/useFileAttachmentPicker.ts
+var f = ({ fileManagerOptions: f, bucket: p, forbiddenSymbolsRegExp: m, tabLabels: h, allowedTabs: g, initialTab: _, allowedTypes: v, maxSelectableFileSize: y, canAttachFolders: b = !1 }) => {
+	let { activeTab: x, handleTabChange: S, tabs: C } = d(h, _), [w, T] = s(() => /* @__PURE__ */ new Set()), E = a((e) => {
+		T(new Set(e));
+	}, []), D = a((e) => {
+		T(/* @__PURE__ */ new Set()), S(e);
+	}, [S]), { tabs: O } = r(x, D, C, g), k = h[x] || h[l.MyFiles], A = n({
+		...f,
+		bucket: p,
+		activeTab: x,
+		rootLabel: k,
+		variant: t.Attach,
+		forbiddenSymbolsRegExp: m
+	}), j = a((e) => v == null || v.length === 0 ? !0 : c(e, v), [v]);
+	return {
+		controller: A,
+		activeTab: x,
+		tabs: O,
+		onTabChange: D,
+		selectedPaths: w,
+		onSelectedPathsChange: E,
+		isRowSelectable: a((e) => {
+			let t = e.data;
+			return t == null || i(t.path) ? !1 : t.nodeType === u.FOLDER ? b : t.nodeType === u.ITEM ? !(t.contentType != null && !j(t.contentType) || y != null && t.contentLength != null && t.contentLength > y) : !1;
+		}, [
+			b,
+			j,
+			y
+		]),
+		isFileTypeAllowed: j,
+		allowedFileTypes: o(() => e(v), [v])
+	};
+};
+//#endregion
+export { f as useFileAttachmentPicker };

package/index.d.ts

@@ -61,6 +61,7 @@ import { DisplayAttachment } from '@epam/ai-dial-chat-shared';
 import { DropdownItem } from '@epam/ai-dial-ui-kit';
 import { ExportFolder } from '@epam/ai-dial-chat-shared';
 import { FileManagerColumnKey } from '@epam/ai-dial-react-file-manager';
+import { FileManagerSelectableNode } from '@epam/ai-dial-chat-shared';
 import { FileMetadataResponseDto } from '@epam/ai-dial-chat-api-client';
 import { FilesApi } from '@epam/ai-dial-chat-api-client';
 import { FileUploadBatchState } from '@epam/ai-dial-chat-shared';
@@ -752,6 +753,13 @@ export declare interface ChatStreamCompletionOptions {
     signal?: AbortSignal;
 }
 
+/**
+ * Classifies an import request's HTTP status into a semantic outcome: 400/413/422 are
+ * archive-content problems, 409 is a name collision, 429 is rate limiting, 502/503 mean the
+ * backend is unavailable, and anything else (including no status at all) is generic.
+ */
+export declare const classifySkillArchiveImportError: (status: number | undefined) => SkillArchiveImportErrorKind;
+
 /** Clears all cached fetch results. Call this when leaving a conversation. */
 export declare const clearAttachmentCache: () => void;
 
@@ -2452,7 +2460,14 @@ export declare interface MessagePair {
 /** Formats MIME types as a human-readable, comma-separated list of dotted extensions (or the MIME type itself for wildcards). */
 export declare const mimeTypesToAttachmentExtensionLabels: (types: string[]) => string;
 
-/** Normalizes `*` to the all-files wildcard and drops any value that is not a valid `DialFileAcceptType`. */
+/**
+ * Normalizes `*` to the all-files wildcard, canonicalizes MIME aliases, and drops
+ * any value that is not a valid `DialFileAcceptType`.
+ *
+ * Aliases are resolved because a file picker matches an `accept` entry against its
+ * own MIME table: a declared `text/json` offers no `.json` file, while the
+ * `application/json` it denotes does.
+ */
 export declare const mimeTypesToDialFileAcceptTypes: (types?: string[]) => DialFileAcceptType[] | undefined;
 
 /**
@@ -3363,6 +3378,28 @@ export declare interface SkillAboutDetails {
     skillPrompt?: string;
 }
 
+/** Semantic classification of an import request failure. */
+export declare enum SkillArchiveImportErrorKind {
+    Validation = "validation",
+    Collision = "collision",
+    RateLimited = "rateLimited",
+    ServiceUnavailable = "serviceUnavailable",
+    Generic = "generic"
+}
+
+/** Phase of a skill-archive import, driving the host's loading/success/error presentation. */
+export declare enum SkillArchiveImportStatus {
+    Idle = "idle",
+    Uploading = "uploading",
+    Success = "success",
+    Error = "error"
+}
+
+/** Reason a selected/dropped file was rejected before any request was made. */
+export declare enum SkillArchiveSelectionRejectionReason {
+    UnsupportedFilename = "unsupportedFilename"
+}
+
 /** Injected API port for skill detail fetching. Mirrors exact server-api wrapper signatures. */
 export declare interface SkillDetailsApi {
     /** Downloads a raw skill file, returning the raw fetch `Response`. */
@@ -5134,6 +5171,64 @@ export declare interface UseFavoriteEntitiesStateResult {
     toggleFavorite: (id: string, isFavorite: boolean, entityType?: FavoriteEntityType) => Promise<void>;
 }
 
+/**
+ * Composes the file-manager tab/listing hooks into the stateful part of an attachment picker:
+ * active tab, selected paths, and hidden-path/MIME/size/folder row eligibility. Returns the
+ * existing `useDialFileManager` controller unchanged and the selection/tab/eligibility fields
+ * `FileManagerAttachModal` already consumes — it composes that modal, it does not replace it.
+ * Final attachment filtering, deduplication, and count enforcement stay owned by the modal.
+ */
+export declare const useFileAttachmentPicker: ({ fileManagerOptions, bucket, forbiddenSymbolsRegExp, tabLabels, allowedTabs, initialTab, allowedTypes, maxSelectableFileSize, canAttachFolders, }: UseFileAttachmentPickerOptions) => UseFileAttachmentPickerResult;
+
+/** Options accepted by {@link useFileAttachmentPicker}. */
+export declare interface UseFileAttachmentPickerOptions {
+    /**
+     * Configured `useDialFileManager` options besides the values this hook derives:
+     * `bucket`, `activeTab`, `rootLabel`, `variant`, and `forbiddenSymbolsRegExp`.
+     */
+    fileManagerOptions: Omit<UseDialFileManagerOptions, 'bucket' | 'activeTab' | 'rootLabel' | 'variant' | 'forbiddenSymbolsRegExp'>;
+    /** DIAL Core bucket to browse. */
+    bucket: string;
+    /** Regexp of characters forbidden in file/folder names, forwarded to `useDialFileManager`. */
+    forbiddenSymbolsRegExp?: RegExp;
+    /** Host-translated label per tab; also supplies the active tab's root-folder label. */
+    tabLabels: Record<DialFileManagerTabs, string>;
+    /** Tab ids the host's configuration allows. `undefined` allows every tab. */
+    allowedTabs?: string[];
+    /** Initial active tab. Defaults to `DialFileManagerTabs.MyFiles`. */
+    initialTab?: DialFileManagerTabs;
+    /** MIME types eligible for selection/upload. Empty or absent allows every type. */
+    allowedTypes?: string[];
+    /** Files at or below this size (bytes) remain eligible; absent allows any size. */
+    maxSelectableFileSize?: number;
+    /** Whether folder rows are eligible for selection. Defaults to `false`. */
+    canAttachFolders?: boolean;
+}
+
+/** Result returned by {@link useFileAttachmentPicker}. */
+export declare interface UseFileAttachmentPickerResult {
+    /** The composed file-manager controller; forward to `FileManagerAttachModal`'s `controller` prop. */
+    controller: UseDialFileManagerResult;
+    /** Active tab. */
+    activeTab: DialFileManagerTabs;
+    /** Tab list filtered to `allowedTabs`; forward to `FileManagerAttachModal`'s `tabs` prop. */
+    tabs: ToolbarOptions['tabs'];
+    /** Switches the active tab and clears the current selection. */
+    onTabChange: (tab: DialFileManagerTabs) => void;
+    /** Currently selected paths. */
+    selectedPaths: Set<string>;
+    /** Replaces the selection with a defensive copy of the given set. */
+    onSelectedPathsChange: (paths: Set<string>) => void;
+    /** Row eligibility predicate; forward to `FileManagerAttachModal`'s `isRowSelectable` prop. */
+    isRowSelectable: (node: {
+        data?: FileManagerSelectableNode | null;
+    }) => boolean;
+    /** MIME eligibility predicate; forward to `FileManagerAttachModal`'s `isFileTypeAllowed` prop. */
+    isFileTypeAllowed: (contentType: string) => boolean;
+    /** Accepted upload MIME types; forward to `FileManagerAttachModal`'s `allowedFileTypes` prop. */
+    allowedFileTypes: DialFileAcceptType[] | undefined;
+}
+
 export { useGridEditingScroll }
 
 export { UseGridEditingScrollOptions }
@@ -5461,6 +5556,46 @@ export declare interface UseShareRecipientsCountResult {
     invalidateRecipientsCount: (itemId: string) => void;
 }
 
+/**
+ * Headless controller for the skill-archive upload flow: dialog visibility, the exact-filename
+ * precheck, in-flight exclusion, and import completion. The host supplies the configured request
+ * and observes completion/failure through the injected callbacks; the hook never imports app
+ * contexts, i18n, or a configured API client.
+ */
+export declare const useSkillArchiveImport: <TResult>({ importArchive, onImported, onError, manifestFileName, }: UseSkillArchiveImportOptions<TResult>) => UseSkillArchiveImportResult;
+
+/** Options accepted by {@link useSkillArchiveImport}. */
+export declare interface UseSkillArchiveImportOptions<TResult> {
+    /** Submits the selected archive; the host owns request configuration and the client. */
+    importArchive: (file: File) => Promise<TResult>;
+    /** Called once after a successful import (and any awaited host follow-up) settles. */
+    onImported: (result: TResult) => void | Promise<void>;
+    /** Called once when the import request, or the host's follow-up in {@link onImported}, fails. */
+    onError: (error: unknown, kind: SkillArchiveImportErrorKind) => void;
+    /** Exact filename treated as the skill manifest. Defaults to `'SKILL.md'`. */
+    manifestFileName?: string;
+}
+
+/** Result returned by {@link useSkillArchiveImport}. */
+export declare interface UseSkillArchiveImportResult {
+    /** Whether the upload dialog is open. */
+    isDialogOpen: boolean;
+    /** Current phase of the import. */
+    status: SkillArchiveImportStatus;
+    /** Reason the current/last selection was rejected locally; `undefined` once cleared. */
+    selectionRejectionReason: SkillArchiveSelectionRejectionReason | undefined;
+    /** Classified failure of the last import request; `undefined` outside a request failure. */
+    errorKind: SkillArchiveImportErrorKind | undefined;
+    /** Opens the dialog, unless an import is already in flight. */
+    openDialog: () => void;
+    /** Closes the dialog and clears any rejection reason. */
+    closeDialog: () => void;
+    /** Wire to the dialog drop zone's `onChange`. */
+    handleFilesSelected: (files: File[]) => void;
+    /** Wire to the dialog drop zone's `onReject`. */
+    handleFilesRejected: () => void;
+}
+
 /**
  * Headless data pipeline behind a skill details side panel: resolves the
  * selected skill from the listings, maps it to a catalog item with its

package/index.js

@@ -70,69 +70,71 @@ import { useSkillEditorSubmit as kn } from "./skill/useSkillEditorSubmit.js";
 import { useSkillFileActions as An } from "./skill/useSkillFileActions.js";
 import { SkillPreviewErrorKind as jn, useSkillFilePreview as Mn } from "./skill/useSkillFilePreview.js";
 import { useSkillsState as Nn } from "./skill/useSkillsState/useSkillsState.js";
-import { RecipientsCountStatus as Pn, useShareRecipientsCount as Fn } from "./useShareRecipientsCount/useShareRecipientsCount.js";
-import { deriveConversationRowActionState as In } from "./conversation/deriveConversationRowActionState/deriveConversationRowActionState.js";
-import { useActiveConversationSync as Ln } from "./conversation/useActiveConversationSync/useActiveConversationSync.js";
-import { useAsyncConfirmDialog as Rn } from "./conversation/useAsyncConfirmDialog/useAsyncConfirmDialog.js";
-import { useConversationLookupMaps as zn } from "./conversation/useConversationLookupMaps/useConversationLookupMaps.js";
-import { getConversationSource as Bn, useConversationPanelItems as Vn } from "./conversation/useConversationPanelItems/useConversationPanelItems.js";
-import { useImportFilePicker as Hn } from "./conversation/useImportFilePicker/useImportFilePicker.js";
-import { sanitizeFileName as Un, splitFileNameExtension as Wn, trimFileNameToByteLimit as Gn } from "./files/file-name.js";
-import { useAttachmentUpload as Kn } from "./conversation/useAttachmentUpload/useAttachmentUpload.js";
-import { AudioTranscriptionError as qn, AudioTranscriptionErrorReason as Jn } from "./conversation/useTranscribeAudio/audio-transcription-error.js";
-import { useTranscribeAudio as Yn } from "./conversation/useTranscribeAudio/useTranscribeAudio.js";
-import { DEFAULT_MAX_ARCHIVE_BYTES as Xn, useConversationExport as Zn } from "./conversation/useConversationExport/useConversationExport.js";
-import { attachmentToDto as Qn, attachmentsToDtos as $n } from "./conversation/useConversationHandlers/attachment-to-dto.js";
-import { createMessagePair as er } from "./conversation/useConversationHandlers/message-factory.js";
-import { hasActiveToolConfig as tr, isAnswerIncomplete as nr, isMessageChanged as rr, shouldRerunGenerationOnEdit as ir } from "./conversation/useConversationHandlers/message-utils.js";
-import { getStarterConversationText as ar, getStarterDisplayText as or, getStarterSubmitText as sr } from "./conversation/useConversationHandlers/starter-option.js";
-import { getConversationPath as cr } from "./conversation/useConversationStream/conversation-path.js";
-import { useConversationHandlers as lr } from "./conversation/useConversationHandlers/useConversationHandlers.js";
-import { useConversationImport as ur } from "./conversation/useConversationImport/useConversationImport.js";
-import { useConversationScroll as dr } from "./conversation/useConversationScroll/useConversationScroll.js";
-import { applyChunkToMessages as fr, mergeStages as pr } from "./conversation/useConversationStream/apply-chunk.js";
-import { isAwaitingGenerationResume as mr } from "./conversation/useConversationStream/generation-resume.js";
-import { useConversationStream as hr } from "./conversation/useConversationStream/useConversationStream.js";
-import { useConversationSources as gr } from "./conversation-sources/useConversationSources/useConversationSources.js";
-import { DialFilesApiUploadMode as _r } from "./files/dial-files-api.js";
-import { FileManagerNotificationReason as vr, FileNameValidationErrorReason as yr, FileOperationKind as br } from "./files/dial-file-manager.types.js";
-import { COLUMNS_WITHOUT_AUTHOR as xr, COLUMNS_WITH_AUTHOR as Sr, CORE_PERMISSION_MAP as Cr, DATE_OPTIONS as wr, PATH_SEPARATOR_REGEXP as Tr, RESERVED_MARKER_NAME as Er, UPLOAD_CONCURRENCY as Dr } from "./files/dial-file-manager.model.js";
-import { DialFileManagerActionProfile as Or, DialFileManagerVariant as kr, deriveActionProfile as Ar } from "./files/file-manager-variant.js";
-import { buildSharedItemVirtualPath as jr, dialCorePathToRelative as Mr, findDialFileByPath as Nr, findFolderByVirtualPath as Pr, formatOperationFolderName as Fr, getVirtualPathName as Ir, hasDialFileWritePermission as Lr, hasForbiddenNameSymbols as Rr, isCopyMoveDuplicateAllowed as zr, isShareActionsAllowed as Br, normalizeVirtualPath as Vr, parseNewFolderVirtualPath as Hr, resolveOwnerCoords as Ur } from "./files/dial-file-manager-path.util.js";
-import { getParentFolderPath as Wr, resolveDialFileApiPath as Gr, virtualPathToApiPath as Kr } from "./files/resolve-dial-file-api-path.js";
-import { prepareCopyItems as qr, prepareMoveRenameItems as Jr } from "./files/dial-file-manager-copy-move.util.js";
-import { buildFromCache as Yr, fetchByTab as Xr, fetchForSearch as Zr, findFirstSuccessfulCopyMoveItem as Qr, mapCorePermissions as $r, mapFileMetadataToDialFile as ei, mapSearchItem as ti, mergeCreatedFolderIntoCache as ni, updateEntry as ri } from "./files/dial-file-manager-mapping.util.js";
-import { createFilesApiClient as ii } from "./files/create-files-api.js";
-import { createUploadFileWithProgress as ai } from "./files/create-upload-file-with-progress.js";
-import { openAnnotationAttachment as oi } from "./files/annotation.js";
-import { annotationToOoxmlCanvasContent as si, annotationToPdfCanvasContent as ci, clearAttachmentCache as li, hasAttachmentTextSource as ui, referenceAttachmentToPdfCanvasContent as di, resolveCodeCanvasContent as fi, resolveGroupedVisualizerCanvasContent as pi, resolveHtmlCanvasContent as mi, resolveImageCanvasContent as hi, resolveJsonCanvasContent as gi, resolveMarkdownCanvasContent as _i, resolveOoxmlCanvasContent as vi, resolvePdfCanvasContent as yi, resolveTextCanvasContent as bi, resolveVisualizerCanvasContent as xi } from "./files/attachment-canvas.js";
-import { getUrlFileName as Si, isExternalSourcePreviewable as Ci, resolveExternalSourceContentType as wi } from "./files/source-content.js";
-import { annotationToDisplayAttachment as Ti, attachmentDtoToDisplayAttachment as Ei, attachmentDtosToDisplayAttachments as Di } from "./files/attachment-dto-to-display.js";
-import { dialFileToAttachment as Oi, dialFilesToAttachments as ki, dialFolderPathToAttachment as Ai } from "./files/dial-file-to-attachment.js";
-import { DownloadDestinationType as ji } from "./files/download-destination.js";
-import { prepareDownloadDestination as Mi } from "./files/prepare-download-destination.js";
-import { useDialFileListing as Ni } from "./files/useDialFileListing/useDialFileListing.js";
-import { useDialFileMetadata as Pi } from "./files/useDialFileMetadata/useDialFileMetadata.js";
-import { useDialFileMutations as Fi } from "./files/useDialFileMutations/useDialFileMutations.js";
-import { useDialFileSharing as Ii } from "./files/useDialFileSharing/useDialFileSharing.js";
-import { useDialFileUploadBatch as Li } from "./files/useDialFileUploadBatch/useDialFileUploadBatch.js";
-import { useDialFileManager as Ri } from "./files/useDialFileManager/useDialFileManager.js";
-import { useDialFileManagerTabConfig as zi } from "./files/useDialFileManagerTabConfig/useDialFileManagerTabConfig.js";
-import { isCustomAppSchema as Bi, isQuickAppSchema as Vi } from "./shared/application-schema.js";
-import { getBrowserTimezone as Hi } from "./shared/browser-timezone.js";
-import { isValidAbsoluteUrl as Ui, isValidFeaturesData as Wi, parseFeaturesData as Gi } from "./shared/custom-apps.js";
-import { buildExternalServiceScopeId as Ki, getExternalServiceFallbackName as qi, parseExternalServiceUrl as Ji } from "./shared/external-services.js";
-import { useChatSettingsFormConfig as Yi } from "./useChatSettingsFormConfig/useChatSettingsFormConfig.js";
-import { usePageFileDrag as Xi } from "./usePageFileDrag/usePageFileDrag.js";
-import { useViewportWidth as Zi } from "./useViewportWidth/useViewportWidth.js";
-import { usePanelMaxWidth as Qi } from "./usePanelMaxWidth/usePanelMaxWidth.js";
-import { useShareLink as $i } from "./useShareLink/useShareLink.js";
-import { useToolsMenu as ea } from "./useToolsMenu/useToolsMenu.js";
-import { useUsageData as ta } from "./usage/useUsageData/useUsageData.js";
-import { McpAppResourceFetchError as na, createMcpAppsApiClient as ra } from "./mcp-apps/mcp-apps-api-client.js";
-import { useMcpAppTools as ia } from "./mcp-apps/useMcpAppTools/useMcpAppTools.js";
-import { useMcpAppHostContext as aa } from "./mcp-apps/useMcpAppHostContext/useMcpAppHostContext.js";
-import { useMcpAppHostAdapter as oa } from "./mcp-apps/useMcpAppHostAdapter/useMcpAppHostAdapter.js";
-import { useOpenMcpAppCanvas as sa } from "./mcp-apps/useOpenMcpAppCanvas/useOpenMcpAppCanvas.js";
-import { useGridEditingScroll as ca } from "@epam/ai-dial-chat-shared";
-export { x as AttachmentValidationErrorReason, qn as AudioTranscriptionError, Jn as AudioTranscriptionErrorReason, R as AuthenticationType, xr as COLUMNS_WITHOUT_AUTHOR, Sr as COLUMNS_WITH_AUTHOR, Cr as CORE_PERMISSION_MAP, $e as CatalogPrimaryActionType, T as ConversationExportMode, E as ConversationTransferErrorCode, D as ConversationTransferWarningCode, wr as DATE_OPTIONS, Lt as DEFAULT_GENERATION_CONFLICT_MESSAGE, Xn as DEFAULT_MAX_ARCHIVE_BYTES, Or as DialFileManagerActionProfile, kr as DialFileManagerVariant, _r as DialFilesApiUploadMode, ji as DownloadDestinationType, k as EXPORT_APP_NAME, O as ExportFileNameKind, kt as FavoriteEntityType, vr as FileManagerNotificationReason, yr as FileNameValidationErrorReason, br as FileOperationKind, Rt as GenerationConflictError, na as McpAppResourceFetchError, Re as McpResourceKind, at as OAuthResourceKind, Tr as PATH_SEPARATOR_REGEXP, cn as PROMPT_CONTENT_MAX_LENGTH, ln as PROMPT_COUNTER_ANNOUNCE_THRESHOLD, un as PROMPT_DESCRIPTION_MAX_LENGTH, dn as PROMPT_NAME_MAX_LENGTH, we as PUBLIC_SKILL_BUCKET, fn as PromptFieldError, ae as PromptSource, Er as RESERVED_MARKER_NAME, Pn as RecipientsCountStatus, ue as SKILL_FILE_UPLOAD_MAX_BYTES, Te as SKILL_LISTING_MAX_PAGES, Ee as SKILL_LISTING_PAGE_SIZE, de as SKILL_MANIFEST_FILE, De as SKILL_MANIFEST_MAX_BYTES, fe as SKILL_UPLOAD_MAX_FILES, pe as SKILL_UPLOAD_MAX_TOTAL_BYTES, Dn as SkillEditorLoadState, jn as SkillPreviewErrorKind, Oe as SkillSource, ot as TOOLSET_REDIRECT_STATE_KEY, st as ToolsetAuthStatus, ct as ToolsetAuthTypes, lt as ToolsetCredentialsLevel, Tt as ToolsetLoginOutcomeType, ut as ToolsetOAuthCallbackQuery, dt as ToolsetOAuthChannelControlType, ft as ToolsetOAuthFailureReason, pt as ToolsetOAuthInitiationResultType, mt as ToolsetOAuthResultType, Dr as UPLOAD_CONCURRENCY, yn as UnsupportedTriggerReason, ht as WithLogin, Ti as annotationToDisplayAttachment, si as annotationToOoxmlCanvasContent, ci as annotationToPdfCanvasContent, bn as apSchedulerDayToJsDay, W as appendLocaleCode, fr as applyChunkToMessages, Ei as attachmentDtoToDisplayAttachment, Di as attachmentDtosToDisplayAttachments, Qn as attachmentToDto, $n as attachmentsToDtos, G as buildAdditionalLocaleOptions, Mt as buildAnnouncementSignature, ze as buildApplicationMcpUrl, N as buildChatCompletionsUrl, Be as buildConnectApi, P as buildDeploymentConnectApi, Ki as buildExternalServiceScopeId, Yr as buildFromCache, an as buildPromptExportEnvelope, on as buildPromptExportFileName, se as buildPromptOverview, pn as buildPromptPath, F as buildResponsesUrl, jr as buildSharedItemVirtualPath, Ae as buildSkillContentTree, me as buildSkillFilesPayload, he as buildSkillManifest, ge as buildSkillManifestForSubmit, _e as buildSkillManifestFromFrontmatter, je as buildSkillOverview, bt as buildToolsetAuthorizeUrl, Ve as buildToolsetMcpUrl, li as clearAttachmentCache, K as composeLocalePayload, zt as createChatStreamApi, i as createCsrfMiddleware, Gt as createDeploymentChangedMessage, ii as createFilesApiClient, ra as createMcpAppsApiClient, er as createMessagePair, j as createPublishApiClient, a as createUnauthorizedMiddleware, ai as createUploadFileWithProgress, V as decodeToolsetId, q as decomposeLocalizedFields, Ar as deriveActionProfile, Je as deriveAvailableTabIds, In as deriveConversationRowActionState, Ye as deriveFavoriteItems, Mr as dialCorePathToRelative, Oi as dialFileToAttachment, ki as dialFilesToAttachments, Ai as dialFolderPathToAttachment, m as downloadAttachment, gt as emitToolsetLoginSuccess, I as encodeDeploymentId, H as encodeToolsetId, Xr as fetchByTab, Zr as fetchForSearch, Xe as filterCatalogItemsBySelector, Ze as filterHiddenOwnedItems, L as findDeploymentByIdOrReference, Nr as findDialFileByPath, Qr as findFirstSuccessfulCopyMoveItem, Pr as findFolderByVirtualPath, Vt as formatAppVersion, X as formatCalendarDate, C as formatDateYM, w as formatDateYMD, Fr as formatOperationFolderName, A as formatQuotedNameList, e as getApiErrorDetails, t as getApiErrorMessage, n as getApiErrorStatus, Hi as getBrowserTimezone, cr as getConversationPath, Bn as getConversationSource, qi as getExternalServiceFallbackName, Kt as getLastDeploymentId, qt as getLastUserMessageToolConfiguration, Ut as getModelIdFromConversationId, Wr as getParentFolderPath, Ue as getPublicCatalogEntityFolderPath, Qt as getQuickAppConversationStarters, mn as getRemainingCharacters, ar as getStarterConversationText, or as getStarterDisplayText, tn as getStarterPopulateText, sr as getStarterSubmitText, nn as getStartersFromSchema, Wt as getTimeOfDayGreeting, vt as getToolsetOAuthChannelName, xt as getToolsetRedirectUri, Si as getUrlFileName, Ir as getVirtualPathName, tr as hasActiveToolConfig, Nt as hasAnnouncementContent, ui as hasAttachmentTextSource, Lr as hasDialFileWritePermission, Rr as hasForbiddenNameSymbols, Pt as hasStructuredAnnouncement, o as includesIgnoreCase, St as initiateOAuthLogin, nr as isAnswerIncomplete, mr as isAwaitingGenerationResume, r as isConversationNotFoundError, zr as isCopyMoveDuplicateAllowed, Bi as isCustomAppSchema, _ as isDialFileAcceptType, d as isDialFileId, h as isDownloadableAttachment, Ci as isExternalSourcePreviewable, rr as isMessageChanged, Jt as isMessageStreaming, ce as isOrganisationPromptItem, We as isPublicCatalogEntityId, U as isPublicToolsetId, Vi as isQuickAppSchema, Br as isShareActionsAllowed, Ui as isValidAbsoluteUrl, Wi as isValidFeaturesData, ve as isValidSkillRelativePath, xn as jsDayToApSchedulerDay, $r as mapCorePermissions, Q as mapDeploymentDetailsDtoToEntityDetails, z as mapDeploymentLimitsDtoToCatalogLimits, B as mapDeploymentLimitsToInput, te as mapDeploymentToCatalogItem, ne as mapDeploymentToolsetCredentials, $ as mapEntityDetailsToCatalogDetails, ei as mapFileMetadataToDialFile, Sn as mapFormValuesToCreateBody, Cn as mapFormValuesToUpdateBody, le as mapPromptToCatalogItem, Ge as mapPublishConversationResultDto, Ke as mapPublishHistoryEntryDto, wn as mapScheduledTaskDtoToFormValues, ti as mapSearchItem, Me as mapSkillToCatalogItem, $t as mapStages, ee as mapToolsetCredentials, re as mapToolsetToCatalogItem, ni as mergeCreatedFolderIntoCache, pr as mergeStages, Yt as messageHasStages, v as mimeTypesToAttachmentExtensionLabels, y as mimeTypesToDialFileAcceptTypes, b as mimeTypesToFileAccept, ye as nameFromPath, Ct as navigateToolsetOAuthPopup, Xt as normalizeResponseFormat, be as normalizeSkillName, Vr as normalizeVirtualPath, oi as openAnnotationAttachment, wt as openToolsetOAuthPopup, Z as padTwoDigits, Ji as parseExternalServiceUrl, Gi as parseFeaturesData, Hr as parseNewFolderVirtualPath, oe as parsePromptResourceUrl, xe as parseSkillManifest, nt as parseSkillManifestDocument, ke as parseSkillResourceUrl, qr as prepareCopyItems, Mi as prepareDownloadDestination, Jr as prepareMoveRenameItems, Ne as readSkillFileBytes, Pe as readSkillFilePreviewBytes, Fe as readSkillManifest, Qe as reconcileFilterTopics, di as referenceAttachmentToPdfCanvasContent, et as resolveCatalogPrimaryAction, fi as resolveCodeCanvasContent, ie as resolveDeploymentFolder, Gr as resolveDialFileApiPath, f as resolveDialFileBucketAndPath, wi as resolveExternalSourceContentType, pi as resolveGroupedVisualizerCanvasContent, mi as resolveHtmlCanvasContent, hi as resolveImageCanvasContent, gi as resolveJsonCanvasContent, J as resolveLocalizedText, _i as resolveMarkdownCanvasContent, He as resolveMcpResourceKind, vi as resolveOoxmlCanvasContent, Ur as resolveOwnerCoords, yi as resolvePdfCanvasContent, p as resolveRelativeDialFilePath, Ie as resolveSkillFileDownloadPath, Le as resolveSkillManifestFileId, bi as resolveTextCanvasContent, xi as resolveVisualizerCanvasContent, s as safeDecodeURI, c as safeDecodeURIComponent, Ft as sanitizeAnnouncementHtml, It as sanitizeAnnouncementMessageHtml, Un as sanitizeFileName, Ht as sanitizeFooterHtml, sn as serializePromptExport, ir as shouldRerunGenerationOnEdit, Bt as shouldWatchForDisplayNameUpdate, Se as skillFileBytesToBlob, En as skillFileToAttachment, Wn as splitFileNameExtension, l as stripSurroundingSlashes, u as stripTrailingSlashes, _t as subscribeToolsetLoginSuccess, Y as toBaseLocale, Zt as toOverlayMessages, qe as toPublishEntityType, M as toPublishRuleDto, en as toStage, Gn as trimFileNameToByteLimit, Ce as unpackSkillArchive, ri as updateEntry, Ln as useActiveConversationSync, Rn as useAsyncConfirmDialog, g as useAttachmentAction, Kn as useAttachmentUpload, S as useAttachmentValidation, tt as useCatalogEditNavigation, it as useCatalogItemDetails, Dt as useCatalogToolsetCredentials, Yi as useChatSettingsFormConfig, Zn as useConversationExport, lr as useConversationHandlers, ur as useConversationImport, zn as useConversationLookupMaps, Vn as useConversationPanelItems, dr as useConversationScroll, gr as useConversationSources, hr as useConversationStream, Ni as useDialFileListing, Ri as useDialFileManager, zi as useDialFileManagerTabConfig, Pi as useDialFileMetadata, Fi as useDialFileMutations, Ii as useDialFileSharing, Li as useDialFileUploadBatch, At as useFavoriteEntitiesState, ca as useGridEditingScroll, Hn as useImportFilePicker, oa as useMcpAppHostAdapter, aa as useMcpAppHostContext, ia as useMcpAppTools, rn as useOAuthCallbackCompletion, sa as useOpenMcpAppCanvas, Xi as usePageFileDrag, Qi as usePanelMaxWidth, vn as usePromptsState, jt as usePublishFolders, $i as useShareLink, Fn as useShareRecipientsCount, Ot as useSkillDetailsPanelData, On as useSkillEditorLoad, kn as useSkillEditorSubmit, An as useSkillFileActions, Mn as useSkillFilePreview, rt as useSkillItemDetails, Nn as useSkillsState, ea as useToolsMenu, Et as useToolsetLogin, Yn as useTranscribeAudio, ta as useUsageData, Zi as useViewportWidth, hn as validatePromptContent, gn as validatePromptDescription, _n as validatePromptName, Tn as validateSkillFileBatch, Kr as virtualPathToApiPath, yt as waitForToolsetOAuthResult };
+import { SkillArchiveImportErrorKind as Pn, SkillArchiveImportStatus as Fn, SkillArchiveSelectionRejectionReason as In, classifySkillArchiveImportError as Ln, useSkillArchiveImport as Rn } from "./skill/useSkillArchiveImport/useSkillArchiveImport.js";
+import { RecipientsCountStatus as zn, useShareRecipientsCount as Bn } from "./useShareRecipientsCount/useShareRecipientsCount.js";
+import { deriveConversationRowActionState as Vn } from "./conversation/deriveConversationRowActionState/deriveConversationRowActionState.js";
+import { useActiveConversationSync as Hn } from "./conversation/useActiveConversationSync/useActiveConversationSync.js";
+import { useAsyncConfirmDialog as Un } from "./conversation/useAsyncConfirmDialog/useAsyncConfirmDialog.js";
+import { useConversationLookupMaps as Wn } from "./conversation/useConversationLookupMaps/useConversationLookupMaps.js";
+import { getConversationSource as Gn, useConversationPanelItems as Kn } from "./conversation/useConversationPanelItems/useConversationPanelItems.js";
+import { useImportFilePicker as qn } from "./conversation/useImportFilePicker/useImportFilePicker.js";
+import { sanitizeFileName as Jn, splitFileNameExtension as Yn, trimFileNameToByteLimit as Xn } from "./files/file-name.js";
+import { useAttachmentUpload as Zn } from "./conversation/useAttachmentUpload/useAttachmentUpload.js";
+import { AudioTranscriptionError as Qn, AudioTranscriptionErrorReason as $n } from "./conversation/useTranscribeAudio/audio-transcription-error.js";
+import { useTranscribeAudio as er } from "./conversation/useTranscribeAudio/useTranscribeAudio.js";
+import { DEFAULT_MAX_ARCHIVE_BYTES as tr, useConversationExport as nr } from "./conversation/useConversationExport/useConversationExport.js";
+import { attachmentToDto as rr, attachmentsToDtos as ir } from "./conversation/useConversationHandlers/attachment-to-dto.js";
+import { createMessagePair as ar } from "./conversation/useConversationHandlers/message-factory.js";
+import { hasActiveToolConfig as or, isAnswerIncomplete as sr, isMessageChanged as cr, shouldRerunGenerationOnEdit as lr } from "./conversation/useConversationHandlers/message-utils.js";
+import { getStarterConversationText as ur, getStarterDisplayText as dr, getStarterSubmitText as fr } from "./conversation/useConversationHandlers/starter-option.js";
+import { getConversationPath as pr } from "./conversation/useConversationStream/conversation-path.js";
+import { useConversationHandlers as mr } from "./conversation/useConversationHandlers/useConversationHandlers.js";
+import { useConversationImport as hr } from "./conversation/useConversationImport/useConversationImport.js";
+import { useConversationScroll as gr } from "./conversation/useConversationScroll/useConversationScroll.js";
+import { applyChunkToMessages as _r, mergeStages as vr } from "./conversation/useConversationStream/apply-chunk.js";
+import { isAwaitingGenerationResume as yr } from "./conversation/useConversationStream/generation-resume.js";
+import { useConversationStream as br } from "./conversation/useConversationStream/useConversationStream.js";
+import { useConversationSources as xr } from "./conversation-sources/useConversationSources/useConversationSources.js";
+import { DialFilesApiUploadMode as Sr } from "./files/dial-files-api.js";
+import { FileManagerNotificationReason as Cr, FileNameValidationErrorReason as wr, FileOperationKind as Tr } from "./files/dial-file-manager.types.js";
+import { COLUMNS_WITHOUT_AUTHOR as Er, COLUMNS_WITH_AUTHOR as Dr, CORE_PERMISSION_MAP as Or, DATE_OPTIONS as kr, PATH_SEPARATOR_REGEXP as Ar, RESERVED_MARKER_NAME as jr, UPLOAD_CONCURRENCY as Mr } from "./files/dial-file-manager.model.js";
+import { DialFileManagerActionProfile as Nr, DialFileManagerVariant as Pr, deriveActionProfile as Fr } from "./files/file-manager-variant.js";
+import { buildSharedItemVirtualPath as Ir, dialCorePathToRelative as Lr, findDialFileByPath as Rr, findFolderByVirtualPath as zr, formatOperationFolderName as Br, getVirtualPathName as Vr, hasDialFileWritePermission as Hr, hasForbiddenNameSymbols as Ur, isCopyMoveDuplicateAllowed as Wr, isShareActionsAllowed as Gr, normalizeVirtualPath as Kr, parseNewFolderVirtualPath as qr, resolveOwnerCoords as Jr } from "./files/dial-file-manager-path.util.js";
+import { getParentFolderPath as Yr, resolveDialFileApiPath as Xr, virtualPathToApiPath as Zr } from "./files/resolve-dial-file-api-path.js";
+import { prepareCopyItems as Qr, prepareMoveRenameItems as $r } from "./files/dial-file-manager-copy-move.util.js";
+import { buildFromCache as ei, fetchByTab as ti, fetchForSearch as ni, findFirstSuccessfulCopyMoveItem as ri, mapCorePermissions as ii, mapFileMetadataToDialFile as ai, mapSearchItem as oi, mergeCreatedFolderIntoCache as si, updateEntry as ci } from "./files/dial-file-manager-mapping.util.js";
+import { createFilesApiClient as li } from "./files/create-files-api.js";
+import { createUploadFileWithProgress as ui } from "./files/create-upload-file-with-progress.js";
+import { openAnnotationAttachment as di } from "./files/annotation.js";
+import { annotationToOoxmlCanvasContent as fi, annotationToPdfCanvasContent as pi, clearAttachmentCache as mi, hasAttachmentTextSource as hi, referenceAttachmentToPdfCanvasContent as gi, resolveCodeCanvasContent as _i, resolveGroupedVisualizerCanvasContent as vi, resolveHtmlCanvasContent as yi, resolveImageCanvasContent as bi, resolveJsonCanvasContent as xi, resolveMarkdownCanvasContent as Si, resolveOoxmlCanvasContent as Ci, resolvePdfCanvasContent as wi, resolveTextCanvasContent as Ti, resolveVisualizerCanvasContent as Ei } from "./files/attachment-canvas.js";
+import { getUrlFileName as Di, isExternalSourcePreviewable as Oi, resolveExternalSourceContentType as ki } from "./files/source-content.js";
+import { annotationToDisplayAttachment as Ai, attachmentDtoToDisplayAttachment as ji, attachmentDtosToDisplayAttachments as Mi } from "./files/attachment-dto-to-display.js";
+import { dialFileToAttachment as Ni, dialFilesToAttachments as Pi, dialFolderPathToAttachment as Fi } from "./files/dial-file-to-attachment.js";
+import { DownloadDestinationType as Ii } from "./files/download-destination.js";
+import { prepareDownloadDestination as Li } from "./files/prepare-download-destination.js";
+import { useDialFileListing as Ri } from "./files/useDialFileListing/useDialFileListing.js";
+import { useDialFileMetadata as zi } from "./files/useDialFileMetadata/useDialFileMetadata.js";
+import { useDialFileMutations as Bi } from "./files/useDialFileMutations/useDialFileMutations.js";
+import { useDialFileSharing as Vi } from "./files/useDialFileSharing/useDialFileSharing.js";
+import { useDialFileUploadBatch as Hi } from "./files/useDialFileUploadBatch/useDialFileUploadBatch.js";
+import { useDialFileManager as Ui } from "./files/useDialFileManager/useDialFileManager.js";
+import { useDialFileManagerTabConfig as Wi } from "./files/useDialFileManagerTabConfig/useDialFileManagerTabConfig.js";
+import { useFileAttachmentPicker as Gi } from "./files/useFileAttachmentPicker/useFileAttachmentPicker.js";
+import { isCustomAppSchema as Ki, isQuickAppSchema as qi } from "./shared/application-schema.js";
+import { getBrowserTimezone as Ji } from "./shared/browser-timezone.js";
+import { isValidAbsoluteUrl as Yi, isValidFeaturesData as Xi, parseFeaturesData as Zi } from "./shared/custom-apps.js";
+import { buildExternalServiceScopeId as Qi, getExternalServiceFallbackName as $i, parseExternalServiceUrl as ea } from "./shared/external-services.js";
+import { useChatSettingsFormConfig as ta } from "./useChatSettingsFormConfig/useChatSettingsFormConfig.js";
+import { usePageFileDrag as na } from "./usePageFileDrag/usePageFileDrag.js";
+import { useViewportWidth as ra } from "./useViewportWidth/useViewportWidth.js";
+import { usePanelMaxWidth as ia } from "./usePanelMaxWidth/usePanelMaxWidth.js";
+import { useShareLink as aa } from "./useShareLink/useShareLink.js";
+import { useToolsMenu as oa } from "./useToolsMenu/useToolsMenu.js";
+import { useUsageData as sa } from "./usage/useUsageData/useUsageData.js";
+import { McpAppResourceFetchError as ca, createMcpAppsApiClient as la } from "./mcp-apps/mcp-apps-api-client.js";
+import { useMcpAppTools as ua } from "./mcp-apps/useMcpAppTools/useMcpAppTools.js";
+import { useMcpAppHostContext as da } from "./mcp-apps/useMcpAppHostContext/useMcpAppHostContext.js";
+import { useMcpAppHostAdapter as fa } from "./mcp-apps/useMcpAppHostAdapter/useMcpAppHostAdapter.js";
+import { useOpenMcpAppCanvas as pa } from "./mcp-apps/useOpenMcpAppCanvas/useOpenMcpAppCanvas.js";
+import { useGridEditingScroll as ma } from "@epam/ai-dial-chat-shared";
+export { x as AttachmentValidationErrorReason, Qn as AudioTranscriptionError, $n as AudioTranscriptionErrorReason, R as AuthenticationType, Er as COLUMNS_WITHOUT_AUTHOR, Dr as COLUMNS_WITH_AUTHOR, Or as CORE_PERMISSION_MAP, $e as CatalogPrimaryActionType, T as ConversationExportMode, E as ConversationTransferErrorCode, D as ConversationTransferWarningCode, kr as DATE_OPTIONS, Lt as DEFAULT_GENERATION_CONFLICT_MESSAGE, tr as DEFAULT_MAX_ARCHIVE_BYTES, Nr as DialFileManagerActionProfile, Pr as DialFileManagerVariant, Sr as DialFilesApiUploadMode, Ii as DownloadDestinationType, k as EXPORT_APP_NAME, O as ExportFileNameKind, kt as FavoriteEntityType, Cr as FileManagerNotificationReason, wr as FileNameValidationErrorReason, Tr as FileOperationKind, Rt as GenerationConflictError, ca as McpAppResourceFetchError, Re as McpResourceKind, at as OAuthResourceKind, Ar as PATH_SEPARATOR_REGEXP, cn as PROMPT_CONTENT_MAX_LENGTH, ln as PROMPT_COUNTER_ANNOUNCE_THRESHOLD, un as PROMPT_DESCRIPTION_MAX_LENGTH, dn as PROMPT_NAME_MAX_LENGTH, we as PUBLIC_SKILL_BUCKET, fn as PromptFieldError, ae as PromptSource, jr as RESERVED_MARKER_NAME, zn as RecipientsCountStatus, ue as SKILL_FILE_UPLOAD_MAX_BYTES, Te as SKILL_LISTING_MAX_PAGES, Ee as SKILL_LISTING_PAGE_SIZE, de as SKILL_MANIFEST_FILE, De as SKILL_MANIFEST_MAX_BYTES, fe as SKILL_UPLOAD_MAX_FILES, pe as SKILL_UPLOAD_MAX_TOTAL_BYTES, Pn as SkillArchiveImportErrorKind, Fn as SkillArchiveImportStatus, In as SkillArchiveSelectionRejectionReason, Dn as SkillEditorLoadState, jn as SkillPreviewErrorKind, Oe as SkillSource, ot as TOOLSET_REDIRECT_STATE_KEY, st as ToolsetAuthStatus, ct as ToolsetAuthTypes, lt as ToolsetCredentialsLevel, Tt as ToolsetLoginOutcomeType, ut as ToolsetOAuthCallbackQuery, dt as ToolsetOAuthChannelControlType, ft as ToolsetOAuthFailureReason, pt as ToolsetOAuthInitiationResultType, mt as ToolsetOAuthResultType, Mr as UPLOAD_CONCURRENCY, yn as UnsupportedTriggerReason, ht as WithLogin, Ai as annotationToDisplayAttachment, fi as annotationToOoxmlCanvasContent, pi as annotationToPdfCanvasContent, bn as apSchedulerDayToJsDay, W as appendLocaleCode, _r as applyChunkToMessages, ji as attachmentDtoToDisplayAttachment, Mi as attachmentDtosToDisplayAttachments, rr as attachmentToDto, ir as attachmentsToDtos, G as buildAdditionalLocaleOptions, Mt as buildAnnouncementSignature, ze as buildApplicationMcpUrl, N as buildChatCompletionsUrl, Be as buildConnectApi, P as buildDeploymentConnectApi, Qi as buildExternalServiceScopeId, ei as buildFromCache, an as buildPromptExportEnvelope, on as buildPromptExportFileName, se as buildPromptOverview, pn as buildPromptPath, F as buildResponsesUrl, Ir as buildSharedItemVirtualPath, Ae as buildSkillContentTree, me as buildSkillFilesPayload, he as buildSkillManifest, ge as buildSkillManifestForSubmit, _e as buildSkillManifestFromFrontmatter, je as buildSkillOverview, bt as buildToolsetAuthorizeUrl, Ve as buildToolsetMcpUrl, Ln as classifySkillArchiveImportError, mi as clearAttachmentCache, K as composeLocalePayload, zt as createChatStreamApi, i as createCsrfMiddleware, Gt as createDeploymentChangedMessage, li as createFilesApiClient, la as createMcpAppsApiClient, ar as createMessagePair, j as createPublishApiClient, a as createUnauthorizedMiddleware, ui as createUploadFileWithProgress, V as decodeToolsetId, q as decomposeLocalizedFields, Fr as deriveActionProfile, Je as deriveAvailableTabIds, Vn as deriveConversationRowActionState, Ye as deriveFavoriteItems, Lr as dialCorePathToRelative, Ni as dialFileToAttachment, Pi as dialFilesToAttachments, Fi as dialFolderPathToAttachment, m as downloadAttachment, gt as emitToolsetLoginSuccess, I as encodeDeploymentId, H as encodeToolsetId, ti as fetchByTab, ni as fetchForSearch, Xe as filterCatalogItemsBySelector, Ze as filterHiddenOwnedItems, L as findDeploymentByIdOrReference, Rr as findDialFileByPath, ri as findFirstSuccessfulCopyMoveItem, zr as findFolderByVirtualPath, Vt as formatAppVersion, X as formatCalendarDate, C as formatDateYM, w as formatDateYMD, Br as formatOperationFolderName, A as formatQuotedNameList, e as getApiErrorDetails, t as getApiErrorMessage, n as getApiErrorStatus, Ji as getBrowserTimezone, pr as getConversationPath, Gn as getConversationSource, $i as getExternalServiceFallbackName, Kt as getLastDeploymentId, qt as getLastUserMessageToolConfiguration, Ut as getModelIdFromConversationId, Yr as getParentFolderPath, Ue as getPublicCatalogEntityFolderPath, Qt as getQuickAppConversationStarters, mn as getRemainingCharacters, ur as getStarterConversationText, dr as getStarterDisplayText, tn as getStarterPopulateText, fr as getStarterSubmitText, nn as getStartersFromSchema, Wt as getTimeOfDayGreeting, vt as getToolsetOAuthChannelName, xt as getToolsetRedirectUri, Di as getUrlFileName, Vr as getVirtualPathName, or as hasActiveToolConfig, Nt as hasAnnouncementContent, hi as hasAttachmentTextSource, Hr as hasDialFileWritePermission, Ur as hasForbiddenNameSymbols, Pt as hasStructuredAnnouncement, o as includesIgnoreCase, St as initiateOAuthLogin, sr as isAnswerIncomplete, yr as isAwaitingGenerationResume, r as isConversationNotFoundError, Wr as isCopyMoveDuplicateAllowed, Ki as isCustomAppSchema, _ as isDialFileAcceptType, d as isDialFileId, h as isDownloadableAttachment, Oi as isExternalSourcePreviewable, cr as isMessageChanged, Jt as isMessageStreaming, ce as isOrganisationPromptItem, We as isPublicCatalogEntityId, U as isPublicToolsetId, qi as isQuickAppSchema, Gr as isShareActionsAllowed, Yi as isValidAbsoluteUrl, Xi as isValidFeaturesData, ve as isValidSkillRelativePath, xn as jsDayToApSchedulerDay, ii as mapCorePermissions, Q as mapDeploymentDetailsDtoToEntityDetails, z as mapDeploymentLimitsDtoToCatalogLimits, B as mapDeploymentLimitsToInput, te as mapDeploymentToCatalogItem, ne as mapDeploymentToolsetCredentials, $ as mapEntityDetailsToCatalogDetails, ai as mapFileMetadataToDialFile, Sn as mapFormValuesToCreateBody, Cn as mapFormValuesToUpdateBody, le as mapPromptToCatalogItem, Ge as mapPublishConversationResultDto, Ke as mapPublishHistoryEntryDto, wn as mapScheduledTaskDtoToFormValues, oi as mapSearchItem, Me as mapSkillToCatalogItem, $t as mapStages, ee as mapToolsetCredentials, re as mapToolsetToCatalogItem, si as mergeCreatedFolderIntoCache, vr as mergeStages, Yt as messageHasStages, v as mimeTypesToAttachmentExtensionLabels, y as mimeTypesToDialFileAcceptTypes, b as mimeTypesToFileAccept, ye as nameFromPath, Ct as navigateToolsetOAuthPopup, Xt as normalizeResponseFormat, be as normalizeSkillName, Kr as normalizeVirtualPath, di as openAnnotationAttachment, wt as openToolsetOAuthPopup, Z as padTwoDigits, ea as parseExternalServiceUrl, Zi as parseFeaturesData, qr as parseNewFolderVirtualPath, oe as parsePromptResourceUrl, xe as parseSkillManifest, nt as parseSkillManifestDocument, ke as parseSkillResourceUrl, Qr as prepareCopyItems, Li as prepareDownloadDestination, $r as prepareMoveRenameItems, Ne as readSkillFileBytes, Pe as readSkillFilePreviewBytes, Fe as readSkillManifest, Qe as reconcileFilterTopics, gi as referenceAttachmentToPdfCanvasContent, et as resolveCatalogPrimaryAction, _i as resolveCodeCanvasContent, ie as resolveDeploymentFolder, Xr as resolveDialFileApiPath, f as resolveDialFileBucketAndPath, ki as resolveExternalSourceContentType, vi as resolveGroupedVisualizerCanvasContent, yi as resolveHtmlCanvasContent, bi as resolveImageCanvasContent, xi as resolveJsonCanvasContent, J as resolveLocalizedText, Si as resolveMarkdownCanvasContent, He as resolveMcpResourceKind, Ci as resolveOoxmlCanvasContent, Jr as resolveOwnerCoords, wi as resolvePdfCanvasContent, p as resolveRelativeDialFilePath, Ie as resolveSkillFileDownloadPath, Le as resolveSkillManifestFileId, Ti as resolveTextCanvasContent, Ei as resolveVisualizerCanvasContent, s as safeDecodeURI, c as safeDecodeURIComponent, Ft as sanitizeAnnouncementHtml, It as sanitizeAnnouncementMessageHtml, Jn as sanitizeFileName, Ht as sanitizeFooterHtml, sn as serializePromptExport, lr as shouldRerunGenerationOnEdit, Bt as shouldWatchForDisplayNameUpdate, Se as skillFileBytesToBlob, En as skillFileToAttachment, Yn as splitFileNameExtension, l as stripSurroundingSlashes, u as stripTrailingSlashes, _t as subscribeToolsetLoginSuccess, Y as toBaseLocale, Zt as toOverlayMessages, qe as toPublishEntityType, M as toPublishRuleDto, en as toStage, Xn as trimFileNameToByteLimit, Ce as unpackSkillArchive, ci as updateEntry, Hn as useActiveConversationSync, Un as useAsyncConfirmDialog, g as useAttachmentAction, Zn as useAttachmentUpload, S as useAttachmentValidation, tt as useCatalogEditNavigation, it as useCatalogItemDetails, Dt as useCatalogToolsetCredentials, ta as useChatSettingsFormConfig, nr as useConversationExport, mr as useConversationHandlers, hr as useConversationImport, Wn as useConversationLookupMaps, Kn as useConversationPanelItems, gr as useConversationScroll, xr as useConversationSources, br as useConversationStream, Ri as useDialFileListing, Ui as useDialFileManager, Wi as useDialFileManagerTabConfig, zi as useDialFileMetadata, Bi as useDialFileMutations, Vi as useDialFileSharing, Hi as useDialFileUploadBatch, At as useFavoriteEntitiesState, Gi as useFileAttachmentPicker, ma as useGridEditingScroll, qn as useImportFilePicker, fa as useMcpAppHostAdapter, da as useMcpAppHostContext, ua as useMcpAppTools, rn as useOAuthCallbackCompletion, pa as useOpenMcpAppCanvas, na as usePageFileDrag, ia as usePanelMaxWidth, vn as usePromptsState, jt as usePublishFolders, aa as useShareLink, Bn as useShareRecipientsCount, Rn as useSkillArchiveImport, Ot as useSkillDetailsPanelData, On as useSkillEditorLoad, kn as useSkillEditorSubmit, An as useSkillFileActions, Mn as useSkillFilePreview, rt as useSkillItemDetails, Nn as useSkillsState, oa as useToolsMenu, Et as useToolsetLogin, er as useTranscribeAudio, sa as useUsageData, ra as useViewportWidth, hn as validatePromptContent, gn as validatePromptDescription, _n as validatePromptName, Tn as validateSkillFileBatch, Zr as virtualPathToApiPath, yt as waitForToolsetOAuthResult };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@epam/ai-dial-chat-hooks",
   "description": "Framework-level React hooks extracted from AI DIAL Chat for building custom chat interfaces",
-  "version": "1.2.0-dev.75",
+  "version": "1.2.0-dev.78",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -106,7 +106,7 @@
     }
   },
   "dependencies": {
-    "@epam/ai-dial-chat-api-client": "1.2.0-dev.75",
+    "@epam/ai-dial-chat-api-client": "1.2.0-dev.78",
     "dompurify": "3.4.15",
     "fflate": "^0.8.3",
     "lru-cache": "^10.4.3",
@@ -115,20 +115,20 @@
   },
   "peerDependencies": {
     "react": "^19.2.8",
-    "@epam/ai-dial-attachment-canvas": "1.2.0-dev.75",
-    "@epam/ai-dial-attachment-input": "1.2.0-dev.75",
-    "@epam/ai-dial-builder-form": "1.2.0-dev.75",
-    "@epam/ai-dial-catalog": "1.2.0-dev.75",
-    "@epam/ai-dial-chat-overlay": "1.2.0-dev.75",
-    "@epam/ai-dial-chat-shared": "1.2.0-dev.75",
-    "@epam/ai-dial-mcp-apps": "1.2.0-dev.75",
-    "@epam/ai-dial-publish-panel": "1.2.0-dev.75",
-    "@epam/ai-dial-quotations": "1.2.0-dev.75",
+    "@epam/ai-dial-attachment-canvas": "1.2.0-dev.78",
+    "@epam/ai-dial-attachment-input": "1.2.0-dev.78",
+    "@epam/ai-dial-builder-form": "1.2.0-dev.78",
+    "@epam/ai-dial-catalog": "1.2.0-dev.78",
+    "@epam/ai-dial-chat-overlay": "1.2.0-dev.78",
+    "@epam/ai-dial-chat-shared": "1.2.0-dev.78",
+    "@epam/ai-dial-mcp-apps": "1.2.0-dev.78",
+    "@epam/ai-dial-publish-panel": "1.2.0-dev.78",
+    "@epam/ai-dial-quotations": "1.2.0-dev.78",
     "@epam/ai-dial-react-file-manager": "^0.3.0-dev.2",
-    "@epam/ai-dial-scheduled-tasks": "1.2.0-dev.75",
-    "@epam/ai-dial-share": "1.2.0-dev.75",
-    "@epam/ai-dial-skill-editor": "1.2.0-dev.75",
-    "@epam/ai-dial-source-panel": "1.2.0-dev.75",
+    "@epam/ai-dial-scheduled-tasks": "1.2.0-dev.78",
+    "@epam/ai-dial-share": "1.2.0-dev.78",
+    "@epam/ai-dial-skill-editor": "1.2.0-dev.78",
+    "@epam/ai-dial-source-panel": "1.2.0-dev.78",
     "@epam/ai-dial-ui-kit": "^0.15.0-dev.9",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@epam/pdf-highlighter-kit": "^0.0.19",

package/skill/useSkillArchiveImport/useSkillArchiveImport.js

@@ -0,0 +1,75 @@
+import { getApiErrorStatus as e } from "../../api-error/api-error.js";
+import { useCallback as t, useEffect as n, useRef as r, useState as i } from "react";
+//#region src/skill/useSkillArchiveImport/useSkillArchiveImport.ts
+var a = "SKILL.md", o = /* @__PURE__ */ function(e) {
+	return e.Idle = "idle", e.Uploading = "uploading", e.Success = "success", e.Error = "error", e;
+}({}), s = /* @__PURE__ */ function(e) {
+	return e.Validation = "validation", e.Collision = "collision", e.RateLimited = "rateLimited", e.ServiceUnavailable = "serviceUnavailable", e.Generic = "generic", e;
+}({}), c = /* @__PURE__ */ function(e) {
+	return e.UnsupportedFilename = "unsupportedFilename", e;
+}({}), l = (e) => {
+	switch (e) {
+		case 400:
+		case 413:
+		case 422: return "validation";
+		case 409: return "collision";
+		case 429: return "rateLimited";
+		case 502:
+		case 503: return "serviceUnavailable";
+		default: return "generic";
+	}
+}, u = (e, t) => e.toLowerCase().endsWith(".md") && e !== t, d = ({ importArchive: o, onImported: s, onError: c, manifestFileName: d = a }) => {
+	let [f, p] = i(!1), [m, h] = i("idle"), [g, _] = i(void 0), [v, y] = i(void 0), b = r(!1), x = r(!0);
+	n(() => (x.current = !0, () => {
+		x.current = !1;
+	}), []);
+	let S = t(async (t) => {
+		b.current = !0, h("uploading"), y(void 0);
+		try {
+			let e = await o(t);
+			if (!x.current || (await s(e), !x.current)) return;
+			h("success");
+		} catch (t) {
+			if (!x.current) return;
+			let n = l(e(t));
+			h("error"), y(n), c(t, n);
+		} finally {
+			b.current = !1;
+		}
+	}, [
+		o,
+		s,
+		c
+	]), C = t(() => {
+		b.current || (_(void 0), p(!0));
+	}, []), w = t(() => {
+		p(!1), _(void 0);
+	}, []), T = t(() => {
+		h("error"), _("unsupportedFilename");
+	}, []);
+	return {
+		isDialogOpen: f,
+		status: m,
+		selectionRejectionReason: g,
+		errorKind: v,
+		openDialog: C,
+		closeDialog: w,
+		handleFilesSelected: t((e) => {
+			let t = e[0];
+			if (!(!t || b.current)) {
+				if (u(t.name, d)) {
+					T();
+					return;
+				}
+				_(void 0), p(!1), S(t);
+			}
+		}, [
+			d,
+			T,
+			S
+		]),
+		handleFilesRejected: T
+	};
+};
+//#endregion
+export { s as SkillArchiveImportErrorKind, o as SkillArchiveImportStatus, c as SkillArchiveSelectionRejectionReason, l as classifySkillArchiveImportError, d as useSkillArchiveImport };

package/skill-editor.d.ts

@@ -43,6 +43,13 @@ export declare const buildSkillManifestForSubmit: (frontmatter: Record<string, u
  */
 export declare const buildSkillManifestFromFrontmatter: (baseFrontmatter: Record<string, unknown>, name: string, description: string, instructions: string) => string;
 
+/**
+ * Classifies an import request's HTTP status into a semantic outcome: 400/413/422 are
+ * archive-content problems, 409 is a name collision, 429 is rate limiting, 502/503 mean the
+ * backend is unavailable, and anything else (including no status at all) is generic.
+ */
+export declare const classifySkillArchiveImportError: (status: number | undefined) => SkillArchiveImportErrorKind;
+
 /**
  * Client-side mirror of the backend's `isValidSkillRelativePath`
  * (`apps/chat-api/src/skills/utils/skill-path.util.ts`), used only for
@@ -122,6 +129,28 @@ export declare interface SkillAboutDetails {
     skillPrompt?: string;
 }
 
+/** Semantic classification of an import request failure. */
+export declare enum SkillArchiveImportErrorKind {
+    Validation = "validation",
+    Collision = "collision",
+    RateLimited = "rateLimited",
+    ServiceUnavailable = "serviceUnavailable",
+    Generic = "generic"
+}
+
+/** Phase of a skill-archive import, driving the host's loading/success/error presentation. */
+export declare enum SkillArchiveImportStatus {
+    Idle = "idle",
+    Uploading = "uploading",
+    Success = "success",
+    Error = "error"
+}
+
+/** Reason a selected/dropped file was rejected before any request was made. */
+export declare enum SkillArchiveSelectionRejectionReason {
+    UnsupportedFilename = "unsupportedFilename"
+}
+
 /** Already-configured DIAL Core download operations `useSkillEditorLoad` needs. */
 export declare interface SkillEditorLoadClient {
     /** Downloads the whole-skill ZIP archive. */
@@ -346,6 +375,46 @@ export declare interface UnpackedSkillArchive {
  */
 export declare const unpackSkillArchive: (bytes: Uint8Array) => UnpackedSkillArchive;
 
+/**
+ * Headless controller for the skill-archive upload flow: dialog visibility, the exact-filename
+ * precheck, in-flight exclusion, and import completion. The host supplies the configured request
+ * and observes completion/failure through the injected callbacks; the hook never imports app
+ * contexts, i18n, or a configured API client.
+ */
+export declare const useSkillArchiveImport: <TResult>({ importArchive, onImported, onError, manifestFileName, }: UseSkillArchiveImportOptions<TResult>) => UseSkillArchiveImportResult;
+
+/** Options accepted by {@link useSkillArchiveImport}. */
+export declare interface UseSkillArchiveImportOptions<TResult> {
+    /** Submits the selected archive; the host owns request configuration and the client. */
+    importArchive: (file: File) => Promise<TResult>;
+    /** Called once after a successful import (and any awaited host follow-up) settles. */
+    onImported: (result: TResult) => void | Promise<void>;
+    /** Called once when the import request, or the host's follow-up in {@link onImported}, fails. */
+    onError: (error: unknown, kind: SkillArchiveImportErrorKind) => void;
+    /** Exact filename treated as the skill manifest. Defaults to `'SKILL.md'`. */
+    manifestFileName?: string;
+}
+
+/** Result returned by {@link useSkillArchiveImport}. */
+export declare interface UseSkillArchiveImportResult {
+    /** Whether the upload dialog is open. */
+    isDialogOpen: boolean;
+    /** Current phase of the import. */
+    status: SkillArchiveImportStatus;
+    /** Reason the current/last selection was rejected locally; `undefined` once cleared. */
+    selectionRejectionReason: SkillArchiveSelectionRejectionReason | undefined;
+    /** Classified failure of the last import request; `undefined` outside a request failure. */
+    errorKind: SkillArchiveImportErrorKind | undefined;
+    /** Opens the dialog, unless an import is already in flight. */
+    openDialog: () => void;
+    /** Closes the dialog and clears any rejection reason. */
+    closeDialog: () => void;
+    /** Wire to the dialog drop zone's `onChange`. */
+    handleFilesSelected: (files: File[]) => void;
+    /** Wire to the dialog drop zone's `onReject`. */
+    handleFilesRejected: () => void;
+}
+
 /**
  * Owns the edit-mode skill download/unpack/parse flow: the in-memory
  * supporting-file map, the loaded manifest values and frontmatter, the

package/skill-editor.js

@@ -5,4 +5,5 @@ import { skillFileToAttachment as g } from "./skill/skill-file-preview.js";
 import { SkillEditorLoadState as _, useSkillEditorLoad as v } from "./skill/useSkillEditorLoad.js";
 import { useSkillEditorSubmit as y } from "./skill/useSkillEditorSubmit.js";
 import { useSkillFileActions as b } from "./skill/useSkillFileActions.js";
-export { e as SKILL_FILE_UPLOAD_MAX_BYTES, t as SKILL_MANIFEST_FILE, n as SKILL_UPLOAD_MAX_FILES, r as SKILL_UPLOAD_MAX_TOTAL_BYTES, _ as SkillEditorLoadState, i as buildSkillFilesPayload, a as buildSkillManifest, o as buildSkillManifestForSubmit, s as buildSkillManifestFromFrontmatter, c as isValidSkillRelativePath, l as nameFromPath, u as normalizeSkillName, d as parseSkillManifest, m as parseSkillManifestDocument, f as skillFileBytesToBlob, g as skillFileToAttachment, p as unpackSkillArchive, v as useSkillEditorLoad, y as useSkillEditorSubmit, b as useSkillFileActions, h as validateSkillFileBatch };
+import { SkillArchiveImportErrorKind as x, SkillArchiveImportStatus as S, SkillArchiveSelectionRejectionReason as C, classifySkillArchiveImportError as w, useSkillArchiveImport as T } from "./skill/useSkillArchiveImport/useSkillArchiveImport.js";
+export { e as SKILL_FILE_UPLOAD_MAX_BYTES, t as SKILL_MANIFEST_FILE, n as SKILL_UPLOAD_MAX_FILES, r as SKILL_UPLOAD_MAX_TOTAL_BYTES, x as SkillArchiveImportErrorKind, S as SkillArchiveImportStatus, C as SkillArchiveSelectionRejectionReason, _ as SkillEditorLoadState, i as buildSkillFilesPayload, a as buildSkillManifest, o as buildSkillManifestForSubmit, s as buildSkillManifestFromFrontmatter, w as classifySkillArchiveImportError, c as isValidSkillRelativePath, l as nameFromPath, u as normalizeSkillName, d as parseSkillManifest, m as parseSkillManifestDocument, f as skillFileBytesToBlob, g as skillFileToAttachment, p as unpackSkillArchive, T as useSkillArchiveImport, v as useSkillEditorLoad, y as useSkillEditorSubmit, b as useSkillFileActions, h as validateSkillFileBatch };