@epam/ai-dial-chat-hooks 1.3.0-dev.5 → 1.3.0-dev.55

package/skill-editor.d.ts

@@ -1,655 +1,2 @@
-import { Attachment } from '@epam/ai-dial-chat-shared';
-import { Dispatch } from 'react';
-import { NotificationVariant } from '@epam/ai-dial-ui-kit';
-import { SetStateAction } from 'react';
-import { SkillEditorErrors } from '@epam/ai-dial-skill-editor';
-import { SkillEditorFileActions } from '@epam/ai-dial-skill-editor';
-import { SkillEditorValues } from '@epam/ai-dial-skill-editor';
-import { SkillFileBatchError } from '@epam/ai-dial-skill-editor';
-import { SkillFileListResponseDto } from '@epam/ai-dial-chat-api-client';
-import { SkillFileSourceEntry } from '@epam/ai-dial-skill-editor';
-import { SkillFileTreeNode } from '@epam/ai-dial-skill-editor';
-import { SkillFileUploadCandidate } from '@epam/ai-dial-skill-editor';
-import { SkillFileValidationResult } from '@epam/ai-dial-skill-editor';
-import { SkillUploadResponseDto } from '@epam/ai-dial-chat-api-client';
-
-/**
- * Builds the ordered supporting-file paths and `Blob` payload
- * `createSkill`/`updateSkill` expect from the editor's file tree and
- * in-memory content map. Every folder node with no descendant node gets a
- * zero-byte `<folder>/.dial_folder` marker after the real files, so the
- * empty folder survives the whole-skill write; a folder with content needs
- * none, and a marker it had before is dropped by that same write.
- */
-export declare const buildSkillFilesPayload: (files: SkillFileTreeNode[], filesContent: Map<string, SkillFileContent>) => SkillFilesPayload;
-
-/**
- * Builds `SKILL.md`'s content: a YAML frontmatter block (`name`/`description`,
- * serialized with the `yaml` package so special characters are always
- * correctly escaped) followed by the raw instructions body.
- */
-export declare const buildSkillManifest: ({ name, description, instructions, }: SkillManifestValues) => string;
-
-/**
- * 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;
-
-/**
- * Builds `SKILL.md`'s content for an edit save: reassigns only `name`/
- * `description` onto the *loaded* frontmatter object (mutating a shallow
- * copy, never the original) so unrecognized fields (e.g. `version`) survive
- * re-serialization unchanged, then appends the (possibly edited)
- * instructions body.
- */
-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;
-
-/** Returns the limit each over-long skill field exceeds, keyed by field; fields within their limit are omitted. */
-export declare const getSkillFieldLengthViolations: (values: Record<SkillTextField, string>) => Partial<Record<SkillTextField, number>>;
-
-/** Whether a skill-relative path is a folder marker (`<folder>/.dial_folder`, never a root-level `.dial_folder`). */
-export declare const isSkillFolderMarkerPath: (path: string) => boolean;
-
-/**
- * Client-side mirror of the backend's `isValidSkillRelativePath`
- * (`apps/chat-api/src/skills/utils/skill-path.util.ts`), used only for
- * immediate inline feedback — the server remains authoritative and may still
- * reject a path this function accepts. It additionally reserves the
- * `.dial_folder` marker name so a user can never upload or name a folder
- * after it; the save payload's generated markers never pass through here
- * (the server accepts them only as a zero-byte final segment).
- */
-export declare const isValidSkillRelativePath: (relativePath: string) => boolean;
-
-/** Returns a skill relative path's final segment (its display name in the file tree). */
-export declare const nameFromPath: (path: string) => string;
-
-/**
- * Normalizes a user-entered skill name to the DIAL naming convention
- * (lowercase letters, digits, and hyphens; no spaces): lowercases the input,
- * replaces every run of whitespace/invalid characters with a single hyphen,
- * and trims leading/trailing hyphens.
- */
-export declare const normalizeSkillName: (input: string) => string;
-
-/** A skill's `SKILL.md` split into its parsed frontmatter object and the raw instructions body. */
-export declare interface ParsedSkillManifest {
-    /** The full parsed frontmatter object, including fields this app never renders. */
-    frontmatter: Record<string, unknown>;
-    /** The instructions body following the closing `---` delimiter. */
-    instructions: string;
-}
-
-/**
- * Parses a `SKILL.md`'s YAML frontmatter and instructions body — the inverse
- * of `buildSkillManifest`/`buildSkillManifestFromFrontmatter`. Throws if the
- * manifest has no `---`-delimited frontmatter block.
- */
-export declare const parseSkillManifest: (manifestText: string) => ParsedSkillManifest;
-
-/**
- * Splits a `SKILL.md` into its YAML frontmatter fields and its prose body.
- *
- * Never throws: a file with no opening fence, no closing fence, or frontmatter
- * that fails to parse resolves to the whole input as `body` with no
- * frontmatter fields. Parse failure is strictly weaker than fetch failure —
- * the manifest text is still returned so the Content tab can render it.
- */
-export declare const parseSkillManifestDocument: (raw: string) => SkillManifestDocument;
-
-/**
- * Client-side mirror of the backend's default `SKILL_FILE_UPLOAD_MAX_BYTES`
- * (`apps/chat-api/src/config/environment.config.ts`), used only for
- * immediate inline feedback when a user picks a file to upload — the server
- * remains authoritative and enforces its own configured limit regardless.
- */
-export declare const SKILL_FILE_UPLOAD_MAX_BYTES = 1048576;
-
-/**
- * Zero-byte object written at `<folder>/.dial_folder` so an otherwise empty
- * skill folder survives a save — DIAL Core storage has no directory objects,
- * so a folder only exists as a file's path prefix.
- */
-export declare const SKILL_FOLDER_MARKER = ".dial_folder";
-
-/** 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";
-
-/** Length limit of each skill editor text field. */
-export declare const SKILL_TEXT_FIELD_MAX_LENGTHS: Record<SkillTextField, number>;
-
-/**
- * Client-side mirror of the backend's default `SKILL_UPLOAD_MAX_FILES`
- * (`apps/chat-api/src/config/environment.config.ts`), used only for
- * immediate inline feedback on the projected total file count (including the
- * root `SKILL.md`) — the server remains authoritative regardless.
- */
-export declare const SKILL_UPLOAD_MAX_FILES = 100;
-
-/**
- * Client-side mirror of the backend's default `SKILL_UPLOAD_MAX_TOTAL_BYTES`
- * (`apps/chat-api/src/config/environment.config.ts`), used only for
- * immediate inline feedback on the projected total package size — the server
- * remains authoritative and enforces its own configured limit regardless.
- */
-export declare const SKILL_UPLOAD_MAX_TOTAL_BYTES = 16777216;
-
-/** Structured fields lifted from a skill manifest's frontmatter. */
-export declare interface SkillAboutDetails {
-    whenToUse?: string;
-    allowedTools?: string[];
-    bundledResources?: string[];
-    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. */
-    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>;
-}
-
-/** 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 write operations `useSkillEditorSubmit` needs. */
-export declare 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 declare interface SkillEditorSubmitMessages {
-    /** Shown when a required field is empty. */
-    required: string;
-    /** Shown when a name, description or instructions value exceeds its length limit, given that limit. */
-    tooLong: (maxLength: number) => string;
-    /**
-     * Shown when the Instructions value opens with its own YAML frontmatter
-     * block — pasting a whole `SKILL.md` in there would otherwise produce a
-     * manifest with two frontmatter blocks.
-     */
-    instructionsFrontmatter: 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 declare 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;
-}
-
-/** Localized messages `useSkillFileActions` needs beyond per-candidate batch validation. */
-export declare 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;
-}
-
-/** Snapshot of editor state the batch validator projects new totals against. */
-export declare 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;
-}
-
-/** Localized messages the batch validator needs, resolved by the caller. */
-export declare 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;
-}
-
-/** Result of validating a whole staged batch. */
-export declare 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;
-}
-
-/** Wraps raw bytes in a `Blob`, copying them so the source buffer can be reused. */
-export declare const skillFileBytesToBlob: (bytes: Uint8Array) => Blob;
-
-/**
- * In-memory bytes for a Skill supporting file, plus its MIME type when known
- * (e.g. from a browser upload's `File.type`).
- */
-export declare interface SkillFileContent {
-    /** The file's raw bytes. */
-    bytes: Uint8Array;
-    /**
-     * MIME type from the original browser `File.type`. Omit for edit-mode ZIP
-     * entries, which carry no MIME metadata — the type is then inferred from
-     * the file's path.
-     */
-    mimeType?: string;
-}
-
-/** The ordered supporting-file paths and `Blob` payload `createSkill`/`updateSkill` expect. */
-export declare interface SkillFilesPayload {
-    /** Relative paths, positionally paired with `files`. */
-    filePaths: string[];
-    /** File contents, positionally paired with `filePaths`. */
-    files: Blob[];
-}
-
-/**
- * Converts a Skill supporting file's in-memory bytes into the `Attachment`
- * shape the chat attachment-canvas pipeline expects, so it can be previewed
- * with `useOpenAttachmentCanvas` exactly like a chat attachment. The id is
- * the file's full relative path (not its basename), so two files with the
- * same name in different folders never collide.
- */
-export declare const skillFileToAttachment: (node: SkillFileTreeNode, content: SkillFileContent) => Attachment;
-
-/** Returns the folder path a marker path stands for (`docs/.dial_folder` → `docs`). */
-export declare const skillFolderMarkerParent: (markerPath: string) => string;
-
-/** A `SKILL.md` split into its frontmatter fields and its prose body. */
-export declare interface SkillManifestDocument {
-    /** `name` frontmatter field, when present and a string. */
-    name?: string;
-    /** `description` frontmatter field, when present and a string. */
-    description?: string;
-    /** Recognised `about.*` frontmatter fields. Absent when none resolved. */
-    about?: SkillAboutDetails;
-    /** Everything after the frontmatter fence, or the whole file when there is none. */
-    body: string;
-}
-
-/** A recognized, structurally valid manifest candidate from a staged batch. */
-export declare 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;
-}
-
-/** Skill fields serialized into the `SKILL.md` manifest. */
-export declare interface SkillManifestValues {
-    /** Normalized skill name. */
-    name: string;
-    /** Short description of what the skill does. */
-    description: string;
-    /** The skill's instructions body (Markdown). */
-    instructions: string;
-}
-
-/** Skill editor text fields with a length limit. */
-export declare type SkillTextField = 'name' | 'description' | 'instructions';
-
-/**
- * Answers one question: would appending this text after the fence that
- * `buildSkillManifest` writes produce a *second* frontmatter block?
- *
- * That happens when the text's first non-blank line is a bare `---` and some
- * later line is a bare `---` too — the exact shape of a `SKILL.md` pasted
- * wholesale into the editor's Instructions field.
- *
- * Detection is deliberately structural rather than YAML-based: a pasted block
- * whose fenced content fails to parse corrupts the stored manifest
- * identically (and renders as a setext `h2` in the Catalog's Details tab just
- * the same), so requiring parseable YAML here would let the worst cases
- * through. Keeping `parseYaml` out also makes this cheap enough to run on
- * every keystroke.
- *
- * A single unclosed fence returns `false`: with no closing fence there is no
- * second block, matching `FRONTMATTER_PATTERN`'s own requirement. A `---`
- * appearing later in the body (a horizontal rule, a setext underline) is
- * likewise not a frontmatter block.
- */
-export declare const startsWithFrontmatterBlock: (text: string) => boolean;
-
-declare type SubmitPhase = 'idle' | 'submitting' | 'success' | 'failure';
-
-/** A skill archive unpacked into its manifest text and a relative-path → bytes map of every other entry. */
-export declare interface UnpackedSkillArchive {
-    /** The root `SKILL.md` entry's decoded text content. */
-    manifestText: string;
-    /** Every non-manifest, non-marker entry, keyed by relative path. */
-    files: Map<string, Uint8Array>;
-    /** Folder paths restored from `<folder>/.dial_folder` marker entries. */
-    folders: string[];
-}
-
-/**
- * Unpacks a whole-skill ZIP (as downloaded from `GET /api/v1/skills/download`
- * — DIAL Core's whole-resource `GET` is the one place this contract still
- * uses a ZIP, per `openspec/changes/archive/2026-10-05-persist-skill-empty-folders/design.md`) into its manifest text, every other entry's
- * bytes, and the folders its empty-folder markers stand for. Throws if the
- * archive has no root `SKILL.md` entry.
- */
-export declare const unpackSkillArchive: (bytes: Uint8Array) => UnpackedSkillArchive;
-
-/**
- * Headless controller for the skill-archive upload flow: dialog visibility, the exact-filename
- * precheck, in-flight exclusion, abort-on-close, 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 the client. `signal` aborts when the dialog closes or the hook unmounts mid-upload. */
-    importArchive: (file: File, signal: AbortSignal) => 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;
-    /** Whether an import request is in flight; the dialog stays open until it succeeds. */
-    isUploading: boolean;
-    /** 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 and clears any previous rejection or request failure. */
-    openDialog: () => void;
-    /** Closes the dialog, aborting an in-flight import, 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
- * 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;
-
-/** Parameters accepted by {@link useSkillEditorLoad}. */
-export declare 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 declare 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 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, getCreateReturnUrl, refetchSkills, client, messages, onNavigate, onNotify, }: UseSkillEditorSubmitParams) => UseSkillEditorSubmitResult;
-
-/** Parameters accepted by {@link useSkillEditorSubmit}. */
-export declare 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;
-    /** Resolves the destination after creation from the normalized skill path. Defaults to `returnUrl`. */
-    getCreateReturnUrl?: (path: string) => 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 declare 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;
-    /** Whether `submitError` was caused by something a plain re-send can clear, rather than by the submission itself. */
-    isSubmitErrorRetryable: boolean;
-    /** Re-submits the values of the attempt that produced `submitError`. No-op before the first submit. */
-    retrySubmit: () => void;
-    /** 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>;
-    /**
-     * Re-runs the Instructions frontmatter check against the editor's current
-     * values, so a pasted `SKILL.md` is flagged as the text lands rather than
-     * only on submit. Pass as the editor's `onValuesChange`.
-     */
-    handleValuesChange: (values: SkillEditorValues) => 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), creating empty
- * folders, expanding `.zip` archives for staging, and removing
- * already-committed nodes.
- */
-export declare const useSkillFileActions: ({ files, setFiles, filesContentRef, frontmatterRef, loadedValues, setLoadedValues, isEditMode, isDirty, setSelectedPath, messages, pickFromFileSystem, }: UseSkillFileActionsParams) => UseSkillFileActionsResult;
-
-/** Parameters accepted by {@link useSkillFileActions}. */
-export declare 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;
-    /**
-     * Opens the host's file-system picker; passed through unchanged as
-     * `fileActions.pickFromFileSystem`. Omit to hide the editor's "Open DIAL
-     * file system" entry.
-     */
-    pickFromFileSystem?: () => Promise<SkillFileSourceEntry[] | undefined>;
-}
-
-/** Return value of {@link useSkillFileActions}. */
-export declare 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;
-}
-
-/**
- * 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>;
-
-export { }
+export * from './entry-points/skill-editor.js'
+export {}