@epam/ai-dial-chat-hooks 1.1.0-dev.287 → 1.1.0-dev.293

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.1.0-dev.287",
+  "version": "1.1.0-dev.293",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -23,20 +23,20 @@
   },
   "peerDependencies": {
     "react": "^19.2.6",
-    "@epam/ai-dial-attachment-canvas": "1.1.0-dev.287",
-    "@epam/ai-dial-attachment-input": "1.1.0-dev.287",
-    "@epam/ai-dial-catalog": "1.1.0-dev.287",
-    "@epam/ai-dial-chat-api-client": "1.1.0-dev.287",
-    "@epam/ai-dial-chat-overlay": "1.1.0-dev.287",
-    "@epam/ai-dial-chat-shared": "1.1.0-dev.287",
-    "@epam/ai-dial-deployment-creation-form": "1.1.0-dev.287",
-    "@epam/ai-dial-publish-panel": "1.1.0-dev.287",
-    "@epam/ai-dial-quotations": "1.1.0-dev.287",
+    "@epam/ai-dial-attachment-canvas": "1.1.0-dev.293",
+    "@epam/ai-dial-attachment-input": "1.1.0-dev.293",
+    "@epam/ai-dial-catalog": "1.1.0-dev.293",
+    "@epam/ai-dial-chat-api-client": "1.1.0-dev.293",
+    "@epam/ai-dial-chat-overlay": "1.1.0-dev.293",
+    "@epam/ai-dial-chat-shared": "1.1.0-dev.293",
+    "@epam/ai-dial-deployment-creation-form": "1.1.0-dev.293",
+    "@epam/ai-dial-publish-panel": "1.1.0-dev.293",
+    "@epam/ai-dial-quotations": "1.1.0-dev.293",
     "@epam/ai-dial-react-file-manager": "*",
-    "@epam/ai-dial-scheduled-tasks": "1.1.0-dev.287",
-    "@epam/ai-dial-share": "1.1.0-dev.287",
-    "@epam/ai-dial-skill-editor": "1.1.0-dev.287",
-    "@epam/ai-dial-source-panel": "1.1.0-dev.287",
+    "@epam/ai-dial-scheduled-tasks": "1.1.0-dev.293",
+    "@epam/ai-dial-share": "1.1.0-dev.293",
+    "@epam/ai-dial-skill-editor": "1.1.0-dev.293",
+    "@epam/ai-dial-source-panel": "1.1.0-dev.293",
     "@epam/ai-dial-ui-kit": "*",
     "ag-grid-community": "^35.3.0",
     "fflate": "^0.8.3"

package/prompt/usePromptsState/usePromptsState.d.ts

@@ -0,0 +1,34 @@
+import { PromptFolderResponseDto, PromptListResponseDto, PromptResponseDto } from '@epam/ai-dial-chat-api-client';
+/** Parameters for {@link usePromptsState}. */
+export interface UsePromptsStateParams {
+    /** Fetches the aggregate prompt listing from the server. */
+    listPrompts: () => Promise<PromptListResponseDto>;
+}
+/** Result returned by {@link usePromptsState}. */
+export interface UsePromptsStateResult {
+    /** The caller's own prompts. */
+    prompts: PromptResponseDto[];
+    /** Folders in the caller's own prompt namespace. */
+    folders: PromptFolderResponseDto[];
+    /** Prompts other users have shared with the caller. */
+    sharedWithMe: PromptResponseDto[];
+    /** Organisation-wide (public) prompts, read-only for every user. */
+    publicPrompts: PromptResponseDto[];
+    /** Folders in the organisation prompt namespace. */
+    publicFolders: PromptFolderResponseDto[];
+    /** True until the aggregate prompt listing has settled. */
+    isLoading: boolean;
+    /** Rejection reason of the most recent failed list request, or `null`. */
+    error: unknown;
+    /** Re-reads personal, shared-with-me, and organisation prompts. */
+    refetch: () => Promise<void>;
+    /** Compatibility alias for the aggregate refetch — same function reference as `refetch`. */
+    refetchPublicPrompts: () => Promise<void>;
+}
+/**
+ * Fetches all prompt namespaces (personal, shared, public) with a single
+ * aggregate request. Exposes `refetch` / `refetchPublicPrompts` for
+ * manual refresh. Does not import any app context, routing, or i18n.
+ */
+export declare const usePromptsState: ({ listPrompts, }: UsePromptsStateParams) => UsePromptsStateResult;
+//# sourceMappingURL=usePromptsState.d.ts.map

package/prompt/usePromptsState/usePromptsState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePromptsState.d.ts","sourceRoot":"","sources":["../../../src/prompt/usePromptsState/usePromptsState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,+BAA+B,CAAC;AAGvC,8CAA8C;AAC9C,MAAM,WAAW,qBAAqB;IACpC,4DAA4D;IAC5D,WAAW,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACnD;AAED,kDAAkD;AAClD,MAAM,WAAW,qBAAqB;IACpC,gCAAgC;IAChC,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,oDAAoD;IACpD,OAAO,EAAE,uBAAuB,EAAE,CAAC;IACnC,uDAAuD;IACvD,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,oEAAoE;IACpE,aAAa,EAAE,iBAAiB,EAAE,CAAC;IACnC,oDAAoD;IACpD,aAAa,EAAE,uBAAuB,EAAE,CAAC;IACzC,2DAA2D;IAC3D,SAAS,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,KAAK,EAAE,OAAO,CAAC;IACf,mEAAmE;IACnE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,4FAA4F;IAC5F,oBAAoB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,kBAE7B,qBAAqB,KAAG,qBA6E1B,CAAC"}

package/shared/string-utils.d.ts

@@ -1,11 +1,4 @@
-/** Characters prohibited in conversation names: tab, ", :, ;, /, \, ,, =, {, }, %, & */
-export declare const PROHIBITED_CONVERSATION_NAME_CHARS_RE: RegExp;
-/** Strips characters DIAL Core rejects in a conversation name. */
-export declare const sanitizeConversationName: (name: string) => string;
-/** Strips trailing `.` characters from a name. */
-export declare const stripTrailingDots: (name: string) => string;
-/** Returns the UTF-8 byte length of a string (may exceed its character/code-unit length). */
-export declare const getUtf8ByteLength: (str: string) => number;
+export { getUtf8ByteLength, sanitizeConversationName, stripTrailingDots, PROHIBITED_CONVERSATION_NAME_CHARS_RE, } from '@epam/ai-dial-chat-shared';
 /** Case-insensitive substring match. */
 export declare const includesIgnoreCase: (str: string, query: string) => boolean;
 /** Decodes a URI-encoded path segment, returning the original string if decoding fails. */

package/shared/string-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"string-utils.d.ts","sourceRoot":"","sources":["../../src/shared/string-utils.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,eAAO,MAAM,qCAAqC,QAAsB,CAAC;AAEzE,kEAAkE;AAClE,eAAO,MAAM,wBAAwB,GAAI,MAAM,MAAM,KAAG,MACC,CAAC;AAE1D,kDAAkD;AAClD,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,MACvB,CAAC;AAE3B,6FAA6F;AAC7F,eAAO,MAAM,iBAAiB,GAAI,KAAK,MAAM,KAAG,MACN,CAAC;AAE3C,wCAAwC;AACxC,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,EAAE,OAAO,MAAM,KAAG,OACf,CAAC;AAElD,2FAA2F;AAC3F,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MAM5C,CAAC;AAEF,iGAAiG;AACjG,eAAO,MAAM,sBAAsB,SATC,MAAM,KAAG,MASM,CAAC;AAEpD,+DAA+D;AAC/D,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,KAAG,MACvB,CAAC"}
+{"version":3,"file":"string-utils.d.ts","sourceRoot":"","sources":["../../src/shared/string-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,iBAAiB,EACjB,qCAAqC,GACtC,MAAM,2BAA2B,CAAC;AAEnC,wCAAwC;AACxC,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,EAAE,OAAO,MAAM,KAAG,OACf,CAAC;AAElD,2FAA2F;AAC3F,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MAM5C,CAAC;AAEF,iGAAiG;AACjG,eAAO,MAAM,sBAAsB,SATC,MAAM,KAAG,MASM,CAAC;AAEpD,+DAA+D;AAC/D,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,KAAG,MACvB,CAAC"}

package/skill/skill-file-batch-validation.d.ts

@@ -0,0 +1,70 @@
+import { SkillFileBatchError, SkillFileUploadCandidate, SkillFileValidationResult } from '@epam/ai-dial-skill-editor';
+/** A recognized, structurally valid manifest candidate from a staged batch. */
+export interface SkillManifestImportCandidate {
+    /** The `SkillFileUploadCandidate.id` this manifest came from. */
+    candidateId: string;
+    /** The imported manifest's `name` field. */
+    name: string;
+    /** The imported manifest's `description` field. */
+    description: string;
+    /** The imported manifest's full parsed frontmatter, including unknown fields. */
+    frontmatter: Record<string, unknown>;
+    /** The imported manifest's instructions body. */
+    instructions: string;
+}
+/** Localized messages the batch validator needs, resolved by the caller. */
+export interface SkillFileBatchValidationMessages {
+    /** Shown when a required field (e.g. a candidate's path) is empty. */
+    required: string;
+    /** Shown when a candidate's path collides with a reserved entry name. */
+    pathReserved: string;
+    /** Shown when a candidate's path fails DIAL's relative-path rules. */
+    pathInvalid: string;
+    /** Shown when a candidate's path duplicates another candidate or an existing file. */
+    pathDuplicate: string;
+    /** Shown when a candidate exceeds the per-file size limit; receives the formatted limit. */
+    fileTooLarge: (maxSize: string) => string;
+    /** Shown when a root-level `SKILL.md`-like path has the wrong casing. */
+    manifestCasingInvalid: string;
+    /** Shown when the batch stages more than one root `SKILL.md`. */
+    manifestDuplicate: string;
+    /** Shown when a root `SKILL.md`'s bytes are not valid UTF-8. */
+    manifestInvalidUtf8: string;
+    /** Shown when a root `SKILL.md`'s frontmatter is missing or missing `name`/`description`. */
+    manifestInvalidFrontmatter: string;
+    /** Shown when the batch's projected total package size exceeds the limit. */
+    totalSizeExceeded: string;
+    /** Shown when the batch's projected total file count exceeds the limit. */
+    totalCountExceeded: string;
+}
+/** Snapshot of editor state the batch validator projects new totals against. */
+export interface SkillFileBatchValidationContext {
+    /** Paths already present in the editor's supporting-file tree. */
+    existingPaths: string[];
+    /** Sum of the bytes already held for existing supporting files. */
+    existingTotalBytes: number;
+    /** UTF-8 byte length of the currently generated/loaded root `SKILL.md`. */
+    manifestByteLength: number;
+    /** Localized messages. */
+    messages: SkillFileBatchValidationMessages;
+}
+/** Result of validating a whole staged batch. */
+export interface SkillFileBatchValidationOutcome {
+    /** One result per candidate, in the same order as the input. */
+    results: SkillFileValidationResult[];
+    /** Batch-level errors (projected total size/count, multiple manifests). */
+    batchErrors: SkillFileBatchError[];
+    /** The single accepted manifest import, when the batch has exactly one valid `SKILL.md`. */
+    manifestCandidate?: SkillManifestImportCandidate;
+}
+/**
+ * Validates a whole staged upload batch against per-file limits, path
+ * safety, in-batch/against-existing duplicates, and projected total
+ * size/count — mirroring the BFF's authoritative `SkillsPackageService`
+ * limits for immediate feedback (the server remains the final gate). Reads
+ * each candidate's bytes only where required (the root `SKILL.md` manifest,
+ * to decode and parse its frontmatter) — never for an ordinary supporting
+ * file, whose size is checked via `File.size` alone.
+ */
+export declare const validateSkillFileBatch: (candidates: SkillFileUploadCandidate[], context: SkillFileBatchValidationContext) => Promise<SkillFileBatchValidationOutcome>;
+//# sourceMappingURL=skill-file-batch-validation.d.ts.map

package/skill/skill-file-batch-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-file-batch-validation.d.ts","sourceRoot":"","sources":["../../src/skill/skill-file-batch-validation.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC/B,MAAM,4BAA4B,CAAC;AAUpC,+EAA+E;AAC/E,MAAM,WAAW,4BAA4B;IAC3C,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,4EAA4E;AAC5E,MAAM,WAAW,gCAAgC;IAC/C,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,aAAa,EAAE,MAAM,CAAC;IACtB,4FAA4F;IAC5F,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1C,yEAAyE;IACzE,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iEAAiE;IACjE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,6FAA6F;IAC7F,0BAA0B,EAAE,MAAM,CAAC;IACnC,6EAA6E;IAC7E,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,gFAAgF;AAChF,MAAM,WAAW,+BAA+B;IAC9C,kEAAkE;IAClE,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,mEAAmE;IACnE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2EAA2E;IAC3E,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0BAA0B;IAC1B,QAAQ,EAAE,gCAAgC,CAAC;CAC5C;AAED,iDAAiD;AACjD,MAAM,WAAW,+BAA+B;IAC9C,gEAAgE;IAChE,OAAO,EAAE,yBAAyB,EAAE,CAAC;IACrC,2EAA2E;IAC3E,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,4FAA4F;IAC5F,iBAAiB,CAAC,EAAE,4BAA4B,CAAC;CAClD;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,GACjC,YAAY,wBAAwB,EAAE,EACtC,SAAS,+BAA+B,KACvC,OAAO,CAAC,+BAA+B,CA6HzC,CAAC"}

package/skill/skill.d.ts

@@ -1,3 +1,5 @@
+import { SkillFileTreeNode } from '@epam/ai-dial-skill-editor';
+import { SkillFileContent } from './skill-file-preview';
 /** Root manifest filename required at the top of every skill archive (mirrors `SKILL_MANIFEST_FILE` in `apps/chat-api/src/skills/utils/skill-path.util.ts`). */
 export declare const SKILL_MANIFEST_FILE = "SKILL.md";
 /**
@@ -85,4 +87,28 @@ export interface UnpackedSkillArchive {
  * bytes. Throws if the archive has no root `SKILL.md` entry.
  */
 export declare const unpackSkillArchive: (bytes: Uint8Array) => UnpackedSkillArchive;
+/** Returns a skill relative path's final segment (its display name in the file tree). */
+export declare const nameFromPath: (path: string) => string;
+/** Wraps raw bytes in a `Blob`, copying them so the source buffer can be reused. */
+export declare const skillFileBytesToBlob: (bytes: Uint8Array) => Blob;
+/**
+ * Builds `SKILL.md`'s content for a create or edit submission: reassigns
+ * onto the loaded/imported frontmatter when one exists (so unrecognized
+ * fields survive), otherwise builds a fresh manifest from just `name`/
+ * `description`/`instructions`.
+ */
+export declare const buildSkillManifestForSubmit: (frontmatter: Record<string, unknown>, name: string, description: string, instructions: string) => string;
+/** The ordered supporting-file paths and `Blob` payload `createSkill`/`updateSkill` expect. */
+export interface SkillFilesPayload {
+    /** Relative paths, positionally paired with `files`. */
+    filePaths: string[];
+    /** File contents, positionally paired with `filePaths`. */
+    files: Blob[];
+}
+/**
+ * Builds the ordered supporting-file paths and `Blob` payload
+ * `createSkill`/`updateSkill` expect from the editor's file tree and
+ * in-memory content map.
+ */
+export declare const buildSkillFilesPayload: (files: SkillFileTreeNode[], filesContent: Map<string, SkillFileContent>) => SkillFilesPayload;
 //# sourceMappingURL=skill.d.ts.map

package/skill/skill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/skill/skill.ts"],"names":[],"mappings":"AAGA,gKAAgK;AAChK,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAE9C;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,UAAY,CAAC;AAErD;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,WAAa,CAAC;AAEvD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAQ1C;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAI,cAAc,MAAM,KAAG,OAsB/D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,KAAG,MAIvB,CAAC;AAE7B,4DAA4D;AAC5D,MAAM,WAAW,mBAAmB;IAClC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,sCAIhC,mBAAmB,KAAG,MAGxB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iCAAiC,GAC5C,iBAAiB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,MAAM,MAAM,EACZ,aAAa,MAAM,EACnB,cAAc,MAAM,KACnB,MAIF,CAAC;AAEF,mGAAmG;AACnG,MAAM,WAAW,mBAAmB;IAClC,mFAAmF;IACnF,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,mEAAmE;IACnE,YAAY,EAAE,MAAM,CAAC;CACtB;AAMD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC7B,cAAc,MAAM,KACnB,mBASF,CAAC;AAEF,4GAA4G;AAC5G,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAChC;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,UAAU,KAAG,oBAmBtD,CAAC"}
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/skill/skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,gKAAgK;AAChK,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAE9C;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,UAAY,CAAC;AAErD;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,WAAa,CAAC;AAEvD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAQ1C;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAI,cAAc,MAAM,KAAG,OAsB/D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,KAAG,MAIvB,CAAC;AAE7B,4DAA4D;AAC5D,MAAM,WAAW,mBAAmB;IAClC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,sCAIhC,mBAAmB,KAAG,MAGxB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iCAAiC,GAC5C,iBAAiB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,MAAM,MAAM,EACZ,aAAa,MAAM,EACnB,cAAc,MAAM,KACnB,MAIF,CAAC;AAEF,mGAAmG;AACnG,MAAM,WAAW,mBAAmB;IAClC,mFAAmF;IACnF,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,mEAAmE;IACnE,YAAY,EAAE,MAAM,CAAC;CACtB;AAMD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC7B,cAAc,MAAM,KACnB,mBASF,CAAC;AAEF,4GAA4G;AAC5G,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAChC;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,UAAU,KAAG,oBAmBtD,CAAC;AAEF,yFAAyF;AACzF,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,MAG3C,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,oBAAoB,GAAI,OAAO,UAAU,KAAG,IACtB,CAAC;AAEpC;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,GACtC,aAAa,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,MAAM,MAAM,EACZ,aAAa,MAAM,EACnB,cAAc,MAAM,KACnB,MAQ0D,CAAC;AAE9D,+FAA+F;AAC/F,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,2DAA2D;IAC3D,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,OAAO,iBAAiB,EAAE,EAC1B,cAAc,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,KAC1C,iBAYF,CAAC"}

package/skill/useSkillEditorLoad.d.ts

@@ -0,0 +1,74 @@
+import { SkillFileListResponseDto } from '@epam/ai-dial-chat-api-client';
+import { SkillEditorValues, SkillFileTreeNode } from '@epam/ai-dial-skill-editor';
+import { Dispatch, SetStateAction } from 'react';
+import { SkillFileContent } from './skill-file-preview';
+/** Edit-mode load state for a skill-authoring form; create mode never leaves `Loaded`. */
+export declare enum SkillEditorLoadState {
+    /** The edit-mode download/parse flow is in flight. */
+    Loading = "loading",
+    /** The skill loaded successfully (or create mode, which starts here). */
+    Loaded = "loaded",
+    /** The download/parse flow failed for a reason other than 403/404. */
+    Error = "error",
+    /** The caller lacks permission to read the skill. */
+    Forbidden = "forbidden",
+    /** The skill no longer exists at the given path. */
+    NotFound = "not-found"
+}
+/** Already-configured DIAL Core download operations `useSkillEditorLoad` needs. */
+export interface SkillEditorLoadClient {
+    /** Downloads the whole-skill ZIP archive. */
+    downloadSkill: (bucket: string, path: string) => Promise<Response>;
+    /** Downloads one file within the skill (the manifest or a supporting file). */
+    downloadSkillFile: (bucket: string, path: string, filePath: string) => Promise<Response>;
+    /** Lists the skill's files when the whole-skill ZIP route is unusable. */
+    listSkillFiles: (params: {
+        bucket: string;
+        path?: string;
+        filePath: string;
+        recursive?: boolean;
+    }) => Promise<SkillFileListResponseDto>;
+}
+/** Parameters accepted by {@link useSkillEditorLoad}. */
+export interface UseSkillEditorLoadParams {
+    /** Whether the form is editing an existing skill rather than creating a new one. */
+    isEditMode: boolean;
+    /** DIAL Core bucket holding the skill. Load is skipped until this resolves. */
+    bucket: string | undefined;
+    /** Path to the skill within `bucket`. */
+    skillPath: string | null | undefined;
+    /** Already-configured download operations. */
+    client: SkillEditorLoadClient;
+}
+/** Return value of {@link useSkillEditorLoad}. */
+export interface UseSkillEditorLoadResult {
+    /** Current load-state machine value driving the form's presentation. */
+    loadState: SkillEditorLoadState;
+    /** The loaded (or, in create mode, seeded) manifest values. */
+    loadedValues: SkillEditorValues | undefined;
+    /** Updates `loadedValues`, e.g. after a manifest import. */
+    setLoadedValues: Dispatch<SetStateAction<SkillEditorValues | undefined>>;
+    /** The loaded supporting-file tree. */
+    files: SkillFileTreeNode[];
+    /** Updates `files`, e.g. after a batch commit or node removal. */
+    setFiles: Dispatch<SetStateAction<SkillFileTreeNode[]>>;
+    /** In-memory bytes for every supporting file, keyed by relative path. */
+    filesContentRef: React.MutableRefObject<Map<string, SkillFileContent>>;
+    /** The loaded manifest's full parsed frontmatter, including fields the form never renders. */
+    frontmatterRef: React.MutableRefObject<Record<string, unknown>>;
+    /** The concurrency ETag from the load, sent back as `If-Match` on save. */
+    etagRef: React.MutableRefObject<string | undefined>;
+    /** The skill path the currently loaded state belongs to. */
+    loadedPathRef: React.MutableRefObject<string | undefined>;
+    /** Re-attempts the edit-mode download (load-error retry or post-conflict reload). */
+    retryLoad: () => void;
+}
+/**
+ * Owns the edit-mode skill download/unpack/parse flow: the in-memory
+ * supporting-file map, the loaded manifest values and frontmatter, the
+ * concurrency ETag, and the load-state machine driving the form's
+ * loading/error/forbidden/not-found presentation. Create mode never leaves
+ * `'loaded'` and starts with empty state.
+ */
+export declare const useSkillEditorLoad: ({ isEditMode, bucket, skillPath, client, }: UseSkillEditorLoadParams) => UseSkillEditorLoadResult;
+//# sourceMappingURL=useSkillEditorLoad.d.ts.map

package/skill/useSkillEditorLoad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillEditorLoad.d.ts","sourceRoot":"","sources":["../../src/skill/useSkillEditorLoad.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EAEzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAUtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,0FAA0F;AAC1F,oBAAY,oBAAoB;IAC9B,sDAAsD;IACtD,OAAO,YAAY;IACnB,yEAAyE;IACzE,MAAM,WAAW;IACjB,sEAAsE;IACtE,KAAK,UAAU;IACf,qDAAqD;IACrD,SAAS,cAAc;IACvB,oDAAoD;IACpD,QAAQ,cAAc;CACvB;AAED,mFAAmF;AACnF,MAAM,WAAW,qBAAqB;IACpC,6CAA6C;IAC7C,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnE,+EAA+E;IAC/E,iBAAiB,EAAE,CACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvB,0EAA0E;IAC1E,cAAc,EAAE,CAAC,MAAM,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,KAAK,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACzC;AA8FD,yDAAyD;AACzD,MAAM,WAAW,wBAAwB;IACvC,oFAAoF;IACpF,UAAU,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,yCAAyC;IACzC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,8CAA8C;IAC9C,MAAM,EAAE,qBAAqB,CAAC;CAC/B;AAED,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACvC,wEAAwE;IACxE,SAAS,EAAE,oBAAoB,CAAC;IAChC,+DAA+D;IAC/D,YAAY,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC5C,4DAA4D;IAC5D,eAAe,EAAE,QAAQ,CAAC,cAAc,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAC,CAAC;IACzE,uCAAuC;IACvC,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,kEAAkE;IAClE,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC;IACxD,yEAAyE;IACzE,eAAe,EAAE,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACvE,8FAA8F;IAC9F,cAAc,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChE,2EAA2E;IAC3E,OAAO,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACpD,4DAA4D;IAC5D,aAAa,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC1D,qFAAqF;IACrF,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,4CAKhC,wBAAwB,KAAG,wBAwG7B,CAAC"}

package/skill/useSkillEditorSubmit.d.ts

@@ -0,0 +1,105 @@
+import { SkillUploadResponseDto } from '@epam/ai-dial-chat-api-client';
+import { SkillEditorErrors, SkillEditorValues, SkillFileTreeNode } from '@epam/ai-dial-skill-editor';
+import { NotificationVariant } from '@epam/ai-dial-ui-kit';
+import { SkillFileContent } from './skill-file-preview';
+type SubmitPhase = 'idle' | 'submitting' | 'success' | 'failure';
+/** Already-configured DIAL Core write operations `useSkillEditorSubmit` needs. */
+export interface SkillEditorSubmitClient {
+    /** Creates a new skill. */
+    createSkill: (bucket: string, path: string, skillManifest: string, filePaths: string[], files: Blob[]) => Promise<SkillUploadResponseDto>;
+    /** Updates an existing skill, sending `ifMatch` as the concurrency guard. */
+    updateSkill: (bucket: string, path: string, skillManifest: string, filePaths: string[], files: Blob[], ifMatch: string) => Promise<SkillUploadResponseDto>;
+}
+/** Localized messages `useSkillEditorSubmit` needs. */
+export interface SkillEditorSubmitMessages {
+    /** Shown when a required field is empty. */
+    required: string;
+    /** Shown when the normalized skill name fails DIAL's naming rules. */
+    nameInvalid: string;
+    /** Shown when the skill name already exists (409), or defensively on an unreachable create-mode 412. */
+    nameConflict: string;
+    /** Shown when the submitted package exceeds the server's size limit (413). */
+    archiveTooLarge: string;
+    /** Shown when the backend is temporarily unavailable (503). */
+    serviceUnavailable: string;
+    /** Fallback shown for a 400 whose response body carries no message. */
+    pathInvalid: string;
+    /** Generic fallback shown for any other error status. */
+    saveError: string;
+    /** Notification title on a successful create. */
+    saveSuccessTitle: string;
+    /** Notification message on a successful create, given the created name. */
+    createSuccess: (name: string) => string;
+    /** Notification title on a successful update. */
+    updateSuccessTitle: string;
+    /** Notification message on a successful update, given the skill's name. */
+    updateSuccess: (name: string) => string;
+    /** Shown when a save hits a stale-ETag conflict (412) in edit mode. */
+    conflictMessage: string;
+}
+/** A host notification `useSkillEditorSubmit` asks to be shown. */
+export interface SkillEditorSubmitNotification {
+    /** Notification style. */
+    variant: NotificationVariant;
+    /** Optional heading. */
+    title?: string;
+    /** Body text. */
+    message: string;
+    /** W3C trace ID, when the triggering error carried one. */
+    requestId?: string;
+}
+/** Parameters accepted by {@link useSkillEditorSubmit}. */
+export interface UseSkillEditorSubmitParams {
+    /** DIAL Core bucket the skill is saved to. */
+    bucket: string | undefined;
+    /** Whether the form is editing an existing skill rather than creating a new one. */
+    isEditMode: boolean;
+    /** The editor's current supporting-file tree. */
+    files: SkillFileTreeNode[];
+    /** In-memory bytes for every supporting file, keyed by relative path. */
+    filesContentRef: React.MutableRefObject<Map<string, SkillFileContent>>;
+    /** The loaded (or imported) manifest's full parsed frontmatter. */
+    frontmatterRef: React.MutableRefObject<Record<string, unknown>>;
+    /** The path the currently loaded edit-mode state belongs to. */
+    loadedPathRef: React.MutableRefObject<string | undefined>;
+    /** The concurrency ETag from the load, sent back as `If-Match` on save. */
+    etagRef: React.MutableRefObject<string | undefined>;
+    /** Where to navigate on a successful save. */
+    returnUrl: string;
+    /** Refetches the host's skill listing after a successful save. */
+    refetchSkills: () => Promise<void>;
+    /** Already-configured create/update operations. */
+    client: SkillEditorSubmitClient;
+    /** Localized messages, resolved by the host. */
+    messages: SkillEditorSubmitMessages;
+    /** Called with `returnUrl` after a successful save. */
+    onNavigate: (url: string) => void;
+    /** Called to surface a host notification (success toast or unexpected-error toast). */
+    onNotify: (notification: SkillEditorSubmitNotification) => void;
+}
+/** Return value of {@link useSkillEditorSubmit}. */
+export interface UseSkillEditorSubmitResult {
+    /** Current submit-phase. */
+    phase: SubmitPhase;
+    /** Inline field validation errors. */
+    errors: SkillEditorErrors;
+    /** General submit-time error, distinct from a stale-edit `conflict`. */
+    submitError: string | undefined;
+    /** Present when the last save hit a stale-ETag conflict. */
+    conflict: {
+        message: string;
+    } | undefined;
+    /** Clears `conflict`, e.g. once the host has reloaded the latest skill. */
+    clearConflict: () => void;
+    /** Validates and submits the given form values. */
+    handleSubmit: (values: SkillEditorValues) => Promise<void>;
+}
+/**
+ * Owns the Skill Editor's create/edit submission flow: field validation,
+ * building and (in edit mode) merging the `SKILL.md` manifest, calling
+ * `client.createSkill`/`client.updateSkill`, and mapping the resulting
+ * success/error/conflict outcomes to presentable state.
+ */
+export declare const useSkillEditorSubmit: ({ bucket, isEditMode, files, filesContentRef, frontmatterRef, loadedPathRef, etagRef, returnUrl, refetchSkills, client, messages, onNavigate, onNotify, }: UseSkillEditorSubmitParams) => UseSkillEditorSubmitResult;
+export {};
+//# sourceMappingURL=useSkillEditorSubmit.d.ts.map

package/skill/useSkillEditorSubmit.d.ts.map

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

package/skill/useSkillFileActions.d.ts

@@ -0,0 +1,53 @@
+import { SkillEditorFileActions, SkillEditorValues, SkillFileTreeNode } from '@epam/ai-dial-skill-editor';
+import { Dispatch, SetStateAction } from 'react';
+import { SkillFileBatchValidationMessages } from './skill-file-batch-validation';
+import { SkillFileContent } from './skill-file-preview';
+/** Localized messages `useSkillFileActions` needs beyond per-candidate batch validation. */
+export interface SkillFileActionsMessages extends SkillFileBatchValidationMessages {
+    /** Returned as the commit error when an imported manifest's `name` doesn't match the skill being edited. */
+    manifestNameMismatch: string;
+    /** Returned as the commit error when the user declines the manifest-import confirmation. */
+    manifestImportDeclined: string;
+    /** Generic fallback commit error for a batch with invalid candidates but no specific batch error. */
+    saveError: string;
+}
+/** Parameters accepted by {@link useSkillFileActions}. */
+export interface UseSkillFileActionsParams {
+    /** The editor's current supporting-file tree. */
+    files: SkillFileTreeNode[];
+    /** Updates `files`. */
+    setFiles: Dispatch<SetStateAction<SkillFileTreeNode[]>>;
+    /** In-memory bytes for every supporting file, keyed by relative path. */
+    filesContentRef: React.MutableRefObject<Map<string, SkillFileContent>>;
+    /** The loaded (or imported) manifest's full parsed frontmatter. */
+    frontmatterRef: React.MutableRefObject<Record<string, unknown>>;
+    /** The seeded baseline manifest values, used to approximate the projected total size. */
+    loadedValues: SkillEditorValues | undefined;
+    /** Updates `loadedValues` after a manifest import. */
+    setLoadedValues: Dispatch<SetStateAction<SkillEditorValues | undefined>>;
+    /** Whether the form is editing an existing skill rather than creating a new one. */
+    isEditMode: boolean;
+    /** Whether the form currently diverges from its seeded baseline. */
+    isDirty: boolean;
+    /** Updates the currently selected file-tree node path. */
+    setSelectedPath: Dispatch<SetStateAction<string>>;
+    /** Localized messages, resolved by the host. */
+    messages: SkillFileActionsMessages;
+}
+/** Return value of {@link useSkillFileActions}. */
+export interface UseSkillFileActionsResult {
+    /** File-tree mutation operations, passed straight to `SkillEditor`'s `fileActions` prop. */
+    fileActions: SkillEditorFileActions;
+    /** Whether the "replace Skill metadata?" confirmation prompt should be shown. */
+    pendingManifestImport: boolean;
+    /** Resolves the in-flight manifest-import confirmation with the user's choice. */
+    resolveManifestImport: (accepted: boolean) => void;
+}
+/**
+ * Owns the Skill Editor's batch file upload workflow: validating a staged
+ * batch, committing it atomically (supporting files plus an optional
+ * `SKILL.md` manifest import, with a confirmation gate), and removing
+ * already-committed nodes.
+ */
+export declare const useSkillFileActions: ({ files, setFiles, filesContentRef, frontmatterRef, loadedValues, setLoadedValues, isEditMode, isDirty, setSelectedPath, messages, }: UseSkillFileActionsParams) => UseSkillFileActionsResult;
+//# sourceMappingURL=useSkillFileActions.d.ts.map

package/skill/useSkillFileActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillFileActions.d.ts","sourceRoot":"","sources":["../../src/skill/useSkillFileActions.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EAEvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAStD,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,4FAA4F;AAC5F,MAAM,WAAW,wBAAyB,SAAQ,gCAAgC;IAChF,4GAA4G;IAC5G,oBAAoB,EAAE,MAAM,CAAC;IAC7B,4FAA4F;IAC5F,sBAAsB,EAAE,MAAM,CAAC;IAC/B,qGAAqG;IACrG,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,0DAA0D;AAC1D,MAAM,WAAW,yBAAyB;IACxC,iDAAiD;IACjD,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,uBAAuB;IACvB,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC;IACxD,yEAAyE;IACzE,eAAe,EAAE,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACvE,mEAAmE;IACnE,cAAc,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChE,yFAAyF;IACzF,YAAY,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC5C,sDAAsD;IACtD,eAAe,EAAE,QAAQ,CAAC,cAAc,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAC,CAAC;IACzE,oFAAoF;IACpF,UAAU,EAAE,OAAO,CAAC;IACpB,oEAAoE;IACpE,OAAO,EAAE,OAAO,CAAC;IACjB,0DAA0D;IAC1D,eAAe,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,gDAAgD;IAChD,QAAQ,EAAE,wBAAwB,CAAC;CACpC;AAED,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC,4FAA4F;IAC5F,WAAW,EAAE,sBAAsB,CAAC;IACpC,iFAAiF;IACjF,qBAAqB,EAAE,OAAO,CAAC;IAC/B,kFAAkF;IAClF,qBAAqB,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;CACpD;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,sIAWjC,yBAAyB,KAAG,yBAsL9B,CAAC"}

package/skill/useSkillsState/useSkillsState.d.ts

@@ -0,0 +1,35 @@
+import { SkillCatalogListResponseDto, SkillMetadataItemDto } from '@epam/ai-dial-chat-api-client';
+/** Parameters for {@link useSkillsState}. */
+export interface UseSkillsStateParams {
+    /** Fetches the aggregate skill listing from the server. */
+    listSkills: () => Promise<SkillCatalogListResponseDto>;
+    /** Whether the Skills feature is enabled in the current overlay/tenant config. */
+    enabled: boolean;
+    /** Whether the user session is ready for API calls (auth has settled). */
+    ready: boolean;
+}
+/** Result returned by {@link useSkillsState}. */
+export interface UseSkillsStateResult {
+    /** Skills in the caller's own bucket. */
+    skills: SkillMetadataItemDto[];
+    /** Skills in the organisation bucket. */
+    publicSkills: SkillMetadataItemDto[];
+    /** Skills other users shared with the caller. */
+    sharedWithMe: SkillMetadataItemDto[];
+    /** True until the aggregate listing has settled. */
+    isLoading: boolean;
+    /** Rejection reason of the most recent failed listing, or `null`. */
+    error: unknown;
+    /** Re-reads personal, shared, and organisation skills. */
+    refetch: () => Promise<void>;
+    /** Upserts a single skill into the shared-with-me list by URL identity. */
+    mergeSharedSkill: (item: SkillMetadataItemDto) => void;
+}
+/**
+ * Fetches all skill namespaces with a gated single request: clears state
+ * immediately when `enabled` is false, defers the fetch until `ready` is true,
+ * and exposes `refetch` / `mergeSharedSkill` for manual updates.
+ * Does not import any feature-flag hook, auth enum, or app context.
+ */
+export declare const useSkillsState: ({ listSkills, enabled, ready, }: UseSkillsStateParams) => UseSkillsStateResult;
+//# sourceMappingURL=useSkillsState.d.ts.map

package/skill/useSkillsState/useSkillsState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillsState.d.ts","sourceRoot":"","sources":["../../../src/skill/useSkillsState/useSkillsState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,oBAAoB,EACrB,MAAM,+BAA+B,CAAC;AAGvC,6CAA6C;AAC7C,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,UAAU,EAAE,MAAM,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACvD,kFAAkF;IAClF,OAAO,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,yCAAyC;IACzC,YAAY,EAAE,oBAAoB,EAAE,CAAC;IACrC,iDAAiD;IACjD,YAAY,EAAE,oBAAoB,EAAE,CAAC;IACrC,oDAAoD;IACpD,SAAS,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,KAAK,EAAE,OAAO,CAAC;IACf,0DAA0D;IAC1D,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,2EAA2E;IAC3E,gBAAgB,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,IAAI,CAAC;CACxD;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,iCAI5B,oBAAoB,KAAG,oBAqFzB,CAAC"}