@epam/ai-dial-chat-hooks 1.0.0 → 1.0.2

package/scheduled-task/scheduled-task-mapping.d.ts

@@ -0,0 +1,19 @@
+import { ScheduledTaskCreateFormValues } from '@epam/ai-dial-scheduled-tasks';
+/** Why a scheduled task DTO could not be mapped back to editable form values. */
+export declare enum UnsupportedTriggerReason {
+    /** `trigger.cron.fields` uses a shape (extra keys, or both `day_of_week` and `day`) the editor's schedule controls cannot represent. */
+    UnsupportedCronShape = "unsupportedCronShape",
+    /** Neither or both of `trigger.date`/`trigger.cron` are set, so the schedule type cannot be determined. */
+    UnsupportedTriggerType = "unsupportedTriggerType",
+    /** The task is missing `model` or `prompt`, so it cannot be represented as a valid update payload. */
+    MissingRequiredFields = "missingRequiredFields"
+}
+/** Result of mapping a scheduled task DTO back to editable form values. */
+export type ScheduledTaskDtoMappingResult = {
+    ok: true;
+    values: ScheduledTaskCreateFormValues;
+} | {
+    ok: false;
+    reason: UnsupportedTriggerReason;
+};
+//# sourceMappingURL=scheduled-task-mapping.d.ts.map

package/scheduled-task/scheduled-task-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-task-mapping.d.ts","sourceRoot":"","sources":["../../src/scheduled-task/scheduled-task-mapping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAEnF,iFAAiF;AACjF,oBAAY,wBAAwB;IAClC,wIAAwI;IACxI,oBAAoB,yBAAyB;IAC7C,2GAA2G;IAC3G,sBAAsB,2BAA2B;IACjD,sGAAsG;IACtG,qBAAqB,0BAA0B;CAChD;AAED,2EAA2E;AAC3E,MAAM,MAAM,6BAA6B,GACrC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,6BAA6B,CAAA;CAAE,GACnD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,wBAAwB,CAAA;CAAE,CAAC"}

package/scheduled-task/scheduled-task-trigger.d.ts

@@ -0,0 +1,27 @@
+import { CreateScheduledTaskBodyDto, ScheduledTaskDto, UpdateScheduledTaskBodyDto } from '@epam/ai-dial-chat-api-client';
+import { ScheduledTaskCreateFormValues } from '@epam/ai-dial-scheduled-tasks';
+import { ScheduledTaskDtoMappingResult } from './scheduled-task-mapping';
+/**
+ * Maps validated create-form values to the `POST /api/v1/scheduled-tasks`
+ * request body, building `trigger.date` for a one-shot schedule or
+ * `trigger.cron.fields` for a recurring one. Assumes the caller has already
+ * validated required fields (name, model, prompt, and the active schedule
+ * section's fields) — this function does not re-validate.
+ */
+export declare const mapFormValuesToCreateBody: (values: ScheduledTaskCreateFormValues) => CreateScheduledTaskBodyDto;
+/**
+ * Maps validated edit-form values to the `PUT /api/v1/scheduled-tasks/:scheduleId`
+ * request body. `UpdateScheduledTaskBodyDto` has the same shape as
+ * `CreateScheduledTaskBodyDto`, so this reuses the same trigger-building logic.
+ */
+export declare const mapFormValuesToUpdateBody: (values: ScheduledTaskCreateFormValues) => UpdateScheduledTaskBodyDto;
+/**
+ * Attempts to map a {@link ScheduledTaskDto} back to editable
+ * {@link ScheduledTaskCreateFormValues}, inverting {@link buildCronFields}/
+ * {@link buildCronWindowBoundary}. Fails closed — returning a reason instead
+ * of a value — whenever the task's trigger or required fields cannot be
+ * represented losslessly by the editor, so an unsupported schedule is never
+ * silently coerced and re-submitted.
+ */
+export declare const mapScheduledTaskDtoToFormValues: (dto: ScheduledTaskDto) => ScheduledTaskDtoMappingResult;
+//# sourceMappingURL=scheduled-task-trigger.d.ts.map

package/scheduled-task/scheduled-task-trigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-task-trigger.d.ts","sourceRoot":"","sources":["../../src/scheduled-task/scheduled-task-trigger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,0BAA0B,EAC1B,gBAAgB,EAEhB,0BAA0B,EAC3B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,6BAA6B,EAE9B,MAAM,+BAA+B,CAAC;AAMvC,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,0BAA0B,CAAC;AAmGlC;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GACpC,QAAQ,6BAA6B,KACpC,0BAmCF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GACpC,QAAQ,6BAA6B,KACpC,0BAA+D,CAAC;AAqHnE;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B,GAC1C,KAAK,gBAAgB,KACpB,6BAyFF,CAAC"}

package/shared/application-schema.d.ts

@@ -0,0 +1,10 @@
+/** Shape of an application schema sufficient to classify it. */
+export interface QuickAppSchemaLike {
+    id?: string;
+    displayName?: string;
+}
+/** True when `schema` is the custom-app (code app) schema. */
+export declare const isCustomAppSchema: (schema?: QuickAppSchemaLike) => boolean;
+/** True when `schema` is a Quick App 2.0 schema. */
+export declare const isQuickAppSchema: (schema?: QuickAppSchemaLike) => boolean;
+//# sourceMappingURL=application-schema.d.ts.map

package/shared/application-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-schema.d.ts","sourceRoot":"","sources":["../../src/shared/application-schema.ts"],"names":[],"mappings":"AAMA,gEAAgE;AAChE,MAAM,WAAW,kBAAkB;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,GAAI,SAAS,kBAAkB,KAAG,OAChB,CAAC;AAQjD,oDAAoD;AACpD,eAAO,MAAM,gBAAgB,GAAI,SAAS,kBAAkB,KAAG,OAGpB,CAAC"}

package/shared/browser-timezone.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Resolves the browser's current IANA timezone for request-scoped downstream
+ * context. Detection is best-effort because embedded or restricted runtimes
+ * may expose an incomplete `Intl` implementation.
+ */
+export declare const getBrowserTimezone: () => string | undefined;
+//# sourceMappingURL=browser-timezone.d.ts.map

package/shared/browser-timezone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-timezone.d.ts","sourceRoot":"","sources":["../../src/shared/browser-timezone.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,QAAO,MAAM,GAAG,SAM9C,CAAC"}

package/shared/cron-weekday.d.ts

@@ -0,0 +1,5 @@
+/** Converts an APScheduler weekday (Monday=0..Sunday=6) to a JS `Date` weekday (Sunday=0..Saturday=6). */
+export declare const apSchedulerDayToJsDay: (apSchedulerDay: number) => number;
+/** Converts a JS `Date` weekday (Sunday=0..Saturday=6) to an APScheduler weekday (Monday=0..Sunday=6). */
+export declare const jsDayToApSchedulerDay: (jsDay: number) => number;
+//# sourceMappingURL=cron-weekday.d.ts.map

package/shared/cron-weekday.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-weekday.d.ts","sourceRoot":"","sources":["../../src/shared/cron-weekday.ts"],"names":[],"mappings":"AAMA,0GAA0G;AAC1G,eAAO,MAAM,qBAAqB,GAAI,gBAAgB,MAAM,KAAG,MACrC,CAAC;AAE3B,0GAA0G;AAC1G,eAAO,MAAM,qBAAqB,GAAI,OAAO,MAAM,KAAG,MAAyB,CAAC"}

package/shared/custom-apps.d.ts

@@ -0,0 +1,7 @@
+/** True when `value` is a well-formed absolute `http(s)://` URL. */
+export declare const isValidAbsoluteUrl: (value: string) => boolean;
+/** Parses a custom app's `featuresData` JSON string, or `undefined` if it is empty or invalid. */
+export declare const parseFeaturesData: (value: string) => Record<string, unknown> | undefined;
+/** True when `value` is empty, or a JSON object containing only the allowed `featuresData` keys. */
+export declare const isValidFeaturesData: (value: string) => boolean;
+//# sourceMappingURL=custom-apps.d.ts.map

package/shared/custom-apps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-apps.d.ts","sourceRoot":"","sources":["../../src/shared/custom-apps.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,KAAG,OASlD,CAAC;AAEF,kGAAkG;AAClG,eAAO,MAAM,iBAAiB,GAC5B,OAAO,MAAM,KACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAQ5B,CAAC;AAIF,oGAAoG;AACpG,eAAO,MAAM,mBAAmB,GAAI,OAAO,MAAM,KAAG,OAenD,CAAC"}

package/shared/external-services.d.ts

@@ -0,0 +1,16 @@
+export interface ParsedExternalServiceUrl {
+    /** The application's own resource id — used for `GET /api/v1/deployments/{appId}/details`. */
+    appId: string;
+    /** Key into `applicationDetails.externalServices` for this specific dependency. */
+    serviceName: string;
+}
+export declare const parseExternalServiceUrl: (url: string) => ParsedExternalServiceUrl | null;
+/** Reconstructs the exact scope id Core expects as `ResourceSignInRequest`/`ResourceSignOutRequest`'s `url` field. */
+export declare const buildExternalServiceScopeId: (appId: string, serviceName: string) => string;
+/**
+ * Derives a human-readable fallback label from an external service's raw
+ * `serviceName` when metadata hasn't resolved yet — mirrors
+ * `getToolsetFallbackName`'s percent-decoding behavior.
+ */
+export declare const getExternalServiceFallbackName: (serviceName: string) => string;
+//# sourceMappingURL=external-services.d.ts.map

package/shared/external-services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-services.d.ts","sourceRoot":"","sources":["../../src/shared/external-services.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,wBAAwB;IACvC,8FAA8F;IAC9F,KAAK,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,uBAAuB,GAClC,KAAK,MAAM,KACV,wBAAwB,GAAG,IAS7B,CAAC;AAEF,sHAAsH;AACtH,eAAO,MAAM,2BAA2B,GACtC,OAAO,MAAM,EACb,aAAa,MAAM,KAClB,MAAiE,CAAC;AAErE;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,GAAI,aAAa,MAAM,KAAG,MAMpE,CAAC"}

package/shared/formatting.d.ts

@@ -0,0 +1,5 @@
+/** Pads a number or numeric string to at least 2 digits with a leading zero (e.g. `9` / `'9'` → `'09'`). */
+export declare const padTwoDigits: (value: number | string) => string;
+/** Formats a Unix timestamp (ms) as a locale-formatted calendar date, e.g. `'22/7/2026'`. */
+export declare const formatCalendarDate: (timestampMs: number) => string;
+//# sourceMappingURL=formatting.d.ts.map

package/shared/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../src/shared/formatting.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAC5G,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,GAAG,MAAM,KAAG,MACtB,CAAC;AAEjC,6FAA6F;AAC7F,eAAO,MAAM,kBAAkB,GAAI,aAAa,MAAM,KAAG,MACb,CAAC"}

package/shared/locale.d.ts

@@ -0,0 +1,45 @@
+import { LocaleTextEntryDto } from '@epam/ai-dial-chat-api-client';
+import { DeploymentCreationFormLocaleEntry, DeploymentCreationFormLocaleOption } from '@epam/ai-dial-deployment-creation-form';
+/** Lowercased base language of a BCP-47 tag, e.g. `'en-US'` -> `'en'`. */
+export declare const toBaseLocale: (locale: string) => string;
+/**
+ * DIAL Core's shape for a user-facing text field: either a plain string (no
+ * localized variants — displayed identically for every locale) or a map of
+ * locale code to translated value.
+ */
+export type LocalizedText = string | Record<string, string>;
+/**
+ * Resolves a `LocalizedText` value to a single display string for
+ * `activeLocale`: exact locale match, then base-language match, then
+ * `primaryLocale`, then the first defined value in the map, then `''`. A
+ * plain string is returned unchanged — it has no locale variants.
+ */
+export declare const resolveLocalizedText: (value: LocalizedText | undefined | null, activeLocale: string, primaryLocale: string) => string;
+/** Appends a locale's uppercased code to a field label, e.g. `'Name [EN]'`. */
+export declare const appendLocaleCode: (label: string, locale: string) => string;
+/**
+ * Composes the "Add locale" popup's entries into the write-payload shape:
+ * strips the popup's client-only `id`, drops rows with no `language`, drops
+ * rows with neither `name` nor `description`, drops rows colliding with
+ * `primaryLocale` (that content belongs in the primary field, not here), and
+ * dedupes by `language` (last row for a given language wins). Returns
+ * `undefined` (not `[]`) when nothing remains, so a request untouched by
+ * this feature stays byte-identical to today.
+ */
+export declare const composeLocalePayload: (otherLocales: DeploymentCreationFormLocaleEntry[], primaryLocale: string) => LocaleTextEntryDto[] | undefined;
+/**
+ * Inverse of {@link composeLocalePayload}: builds the popup's `otherLocales`
+ * entries from a `displayName`/`description` pair as read from DIAL Core.
+ * A plain string on both (or both absent) means no additional locales exist
+ * yet, so this returns `[]`. Otherwise one entry is built per locale key
+ * present in either map, excluding `primaryLocale` — that key is already the
+ * primary Name/Description field, not a row in the popup.
+ */
+export declare const decomposeLocalizedFields: (displayName: LocalizedText | undefined, description: LocalizedText | undefined, primaryLocale: string) => DeploymentCreationFormLocaleEntry[];
+/**
+ * Selectable additional-locale options for a locale-picker popup, drawn from
+ * `additionalLocaleCodes` and excluding whichever code is already the
+ * primary Name/Description field.
+ */
+export declare const buildAdditionalLocaleOptions: (additionalLocaleCodes: string[], primaryLocale: string) => DeploymentCreationFormLocaleOption[];
+//# sourceMappingURL=locale.d.ts.map

package/shared/locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../src/shared/locale.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,KAAK,EACV,iCAAiC,EACjC,kCAAkC,EACnC,MAAM,wCAAwC,CAAC;AAEhD,0EAA0E;AAC1E,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,KAAG,MACV,CAAC;AAErC;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE5D;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,aAAa,GAAG,SAAS,GAAG,IAAI,EACvC,cAAc,MAAM,EACpB,eAAe,MAAM,KACpB,MAWF,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,EAAE,QAAQ,MAAM,KAAG,MACb,CAAC;AAErD;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAC/B,cAAc,iCAAiC,EAAE,EACjD,eAAe,MAAM,KACpB,kBAAkB,EAAE,GAAG,SAczB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GACnC,aAAa,aAAa,GAAG,SAAS,EACtC,aAAa,aAAa,GAAG,SAAS,EACtC,eAAe,MAAM,KACpB,iCAAiC,EAgBnC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,GACvC,uBAAuB,MAAM,EAAE,EAC/B,eAAe,MAAM,KACpB,kCAAkC,EAGoB,CAAC"}

package/shared/string-utils.d.ts

@@ -0,0 +1,9 @@
+/** 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. */
+export declare const safeDecodeURI: (path: string) => string;
+/** Alias of {@link safeDecodeURI} for call sites decoding a URI component rather than a path. */
+export declare const safeDecodeURIComponent: (path: string) => string;
+/** Strips leading and trailing slashes from a path segment. */
+export declare const stripSurroundingSlashes: (path: string) => string;
+//# sourceMappingURL=string-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.d.ts","sourceRoot":"","sources":["../../src/shared/string-utils.ts"],"names":[],"mappings":"AAAA,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/shared/toolset-login-events.d.ts

@@ -0,0 +1,15 @@
+/** Detail payload for a successful toolset login, generic over the app's own credentials-level type. */
+export interface ToolsetLoginSuccessDetail<T> {
+    /** Already-encoded toolset id/url, as passed into `useToolsetLogin`'s `login`. */
+    toolsetId: string;
+    credentialsLevel: T;
+}
+/**
+ * Broadcasts a successful toolset login to any listener within the current
+ * window — host-to-host, not `postMessage`, since this notifies other React
+ * trees in the same document (e.g. a mounted `AppEditorIframe`), not an
+ * embedded cross-origin iframe.
+ */
+export declare const emitToolsetLoginSuccess: <T>(detail: ToolsetLoginSuccessDetail<T>) => void;
+export declare const subscribeToolsetLoginSuccess: <T>(listener: (detail: ToolsetLoginSuccessDetail<T>) => void) => (() => void);
+//# sourceMappingURL=toolset-login-events.d.ts.map

package/shared/toolset-login-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolset-login-events.d.ts","sourceRoot":"","sources":["../../src/shared/toolset-login-events.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,CAAC,CAAC;CACrB;AAMD;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAAI,CAAC,EACvC,QAAQ,yBAAyB,CAAC,CAAC,CAAC,KACnC,IAMF,CAAC;AAMF,eAAO,MAAM,4BAA4B,GAAI,CAAC,EAC5C,UAAU,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC,CAAC,KAAK,IAAI,KACvD,CAAC,MAAM,IAAI,CAcb,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-file-preview.d.ts

@@ -0,0 +1,25 @@
+import { Attachment } from '@epam/ai-dial-chat-shared';
+import { SkillFileTreeNode } from '@epam/ai-dial-skill-editor';
+/**
+ * In-memory bytes for a Skill supporting file, plus its MIME type when known
+ * (e.g. from a browser upload's `File.type`).
+ */
+export 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;
+}
+/**
+ * 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;
+//# sourceMappingURL=skill-file-preview.d.ts.map

package/skill/skill-file-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-file-preview.d.ts","sourceRoot":"","sources":["../../src/skill/skill-file-preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAM5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAChC,MAAM,iBAAiB,EACvB,SAAS,gBAAgB,KACxB,UAiBF,CAAC"}

package/skill/skill-manifest.d.ts

@@ -0,0 +1,28 @@
+/** Structured fields lifted from a skill manifest's frontmatter. */
+export interface SkillAboutDetails {
+    whenToUse?: string;
+    allowedTools?: string[];
+    bundledResources?: string[];
+    skillPrompt?: string;
+}
+/** A `SKILL.md` split into its frontmatter fields and its prose body. */
+export 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;
+}
+/**
+ * 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;
+//# sourceMappingURL=skill-manifest.d.ts.map

package/skill/skill-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-manifest.d.ts","sourceRoot":"","sources":["../../src/skill/skill-manifest.ts"],"names":[],"mappings":"AAEA,oEAAoE;AACpE,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,yEAAyE;AACzE,MAAM,WAAW,qBAAqB;IACpC,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,oFAAoF;IACpF,IAAI,EAAE,MAAM,CAAC;CACd;AAmFD;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,GACrC,KAAK,MAAM,KACV,qBAiDF,CAAC"}

package/skill/skill-types.d.ts

@@ -0,0 +1,42 @@
+import { SkillAboutDetails } from './skill-manifest';
+/** Which skill namespace a catalog skill item came from. */
+export declare enum SkillSource {
+    /** A skill in the caller's own bucket. */
+    Personal = "personal",
+    /** A skill another user shared with the caller. */
+    SharedWithMe = "sharedWithMe",
+    /** An organisation-wide skill; read-only for every user. */
+    Public = "public"
+}
+/** DIAL Core bucket holding organisation-wide skills. */
+export declare const PUBLIC_SKILL_BUCKET = "public";
+/**
+ * Largest manifest the details panel will decode. A `SKILL.md` past this is
+ * treated as unreadable rather than rendered.
+ */
+export declare const SKILL_MANIFEST_MAX_BYTES: number;
+/** Items requested per skill-listing page. */
+export declare const SKILL_LISTING_PAGE_SIZE = 1000;
+/**
+ * Upper bound on `nextToken` follow-ups per listing, so a pathological bucket
+ * cannot spin the client forever.
+ */
+export declare const SKILL_LISTING_MAX_PAGES = 10;
+/** A skill's parsed manifest details. */
+export interface SkillEntityDetails {
+    about?: SkillAboutDetails;
+}
+/** A skill resource URL split into the bucket and the path within it. */
+export interface ParsedSkillResourceUrl {
+    /** DIAL Core bucket name. */
+    bucket: string;
+    /** Path to the skill within that bucket. */
+    path: string;
+}
+/**
+ * Splits a `skills/{bucket}/{path}` resource URL into its parts, mirroring the
+ * backend's parser. Returns `null` for a different prefix, an empty bucket, or
+ * an empty path, so callers can treat "not a skill URL" as one case.
+ */
+export declare const parseSkillResourceUrl: (url: string) => ParsedSkillResourceUrl | null;
+//# sourceMappingURL=skill-types.d.ts.map

package/skill/skill-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-types.d.ts","sourceRoot":"","sources":["../../src/skill/skill-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,4DAA4D;AAC5D,oBAAY,WAAW;IACrB,0CAA0C;IAC1C,QAAQ,aAAa;IACrB,mDAAmD;IACnD,YAAY,iBAAiB;IAC7B,4DAA4D;IAC5D,MAAM,WAAW;CAClB;AAED,yDAAyD;AACzD,eAAO,MAAM,mBAAmB,WAAW,CAAC;AAK5C;;;GAGG;AACH,eAAO,MAAM,wBAAwB,QAAa,CAAC;AAEnD,8CAA8C;AAC9C,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B;AAED,yEAAyE;AACzE,MAAM,WAAW,sBAAsB;IACrC,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,KAAK,MAAM,KACV,sBAAsB,GAAG,IAS3B,CAAC"}

package/skill/skill.d.ts

@@ -0,0 +1,114 @@
+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";
+/**
+ * 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;
+/**
+ * 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;
+/**
+ * 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 `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.
+ */
+export declare const isValidSkillRelativePath: (relativePath: string) => boolean;
+/**
+ * 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;
+/** Skill fields serialized into the `SKILL.md` manifest. */
+export interface SkillManifestValues {
+    /** Normalized skill name. */
+    name: string;
+    /** Short description of what the skill does. */
+    description: string;
+    /** The skill's instructions body (Markdown). */
+    instructions: string;
+}
+/**
+ * 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 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;
+/** A skill's `SKILL.md` split into its parsed frontmatter object and the raw instructions body. */
+export 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;
+/** A skill archive unpacked into its manifest text and a relative-path → bytes map of every other entry. */
+export interface UnpackedSkillArchive {
+    /** The root `SKILL.md` entry's decoded text content. */
+    manifestText: string;
+    /** Every non-manifest entry, keyed by relative path. */
+    files: Map<string, Uint8Array>;
+}
+/**
+ * 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 design.md) into its manifest text and every other entry's
+ * 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

@@ -0,0 +1 @@
+{"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"}