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

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":"AACA,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;AAQtD,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/useSkillFilePreview.d.ts

@@ -0,0 +1,38 @@
+import { SkillFileContent } from './skill-file-preview';
+/** Discriminant for the kind of error a `useSkillFilePreview` load can produce. */
+export declare enum SkillPreviewErrorKind {
+    /** HTTP 403 — the caller lacks permission to read this file. */
+    Forbidden = "forbidden",
+    /** Any non-403 load failure. */
+    Generic = "generic"
+}
+/** Options accepted by `useSkillFilePreview`. */
+export interface UseSkillFilePreviewOptions {
+    /**
+     * Opaque id of the selected skill file. Changing this resets all state
+     * and starts a new load; stale resolutions from the previous id are discarded.
+     */
+    fileId: string;
+    /**
+     * App-owned loader; resolves with the raw file bytes when the request
+     * succeeds. The hook never constructs a URL or imports a REST client.
+     */
+    onLoadFile: (fileId: string) => Promise<SkillFileContent>;
+}
+/** State returned by `useSkillFilePreview`. */
+export interface UseSkillFilePreviewResult {
+    /** `true` while the async load is in flight. */
+    isLoading: boolean;
+    /** Resolved file content, or `null` while loading or after an error. */
+    content: SkillFileContent | null;
+    /** Classified load error, or `null` while loading or after a success. */
+    error: SkillPreviewErrorKind | null;
+}
+/**
+ * Headless hook that manages the skill-file preview loading lifecycle.
+ * Starts a new load on mount and whenever `fileId` changes; classifies errors
+ * as `Forbidden` (HTTP 403) or `Generic`; discards settlements from superseded
+ * or unmounted loads.
+ */
+export declare const useSkillFilePreview: ({ fileId, onLoadFile, }: UseSkillFilePreviewOptions) => UseSkillFilePreviewResult;
+//# sourceMappingURL=useSkillFilePreview.d.ts.map

package/skill/useSkillFilePreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillFilePreview.d.ts","sourceRoot":"","sources":["../../src/skill/useSkillFilePreview.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,mFAAmF;AACnF,oBAAY,qBAAqB;IAC/B,gEAAgE;IAChE,SAAS,cAAc;IACvB,gCAAgC;IAChC,OAAO,YAAY;CACpB;AAED,iDAAiD;AACjD,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC3D;AAED,+CAA+C;AAC/C,MAAM,WAAW,yBAAyB;IACxC,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACjC,yEAAyE;IACzE,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACrC;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,yBAGjC,0BAA0B,KAAG,yBAoC/B,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"}

package/usage/useUsageData/useUsageData.d.ts

@@ -0,0 +1,20 @@
+import { UserLimitStatsResponseDto } from '@epam/ai-dial-chat-api-client';
+/** Return shape of {@link useUsageData}. */
+export interface UseUsageDataResult {
+    /** Rolling usage and rate-limit stats for every deployment the caller has used in the trailing 30 days, plus the caller's global cost budget. */
+    usage: UserLimitStatsResponseDto | undefined;
+    /** `true` while the fetch is in flight. */
+    isLoading: boolean;
+    /** Set when the `getUserUsage` call rejects. */
+    usageError: Error | undefined;
+}
+/**
+ * Fetches usage stats via the provided `getUserUsage` function on mount.
+ *
+ * `enabled` (default `true`) lets callers behind a feature flag skip the fetch
+ * entirely. The hook accepts the fetch function as a parameter so the caller
+ * supplies an already-configured API client — the hook never constructs or
+ * imports one itself.
+ */
+export declare const useUsageData: (getUserUsage: () => Promise<UserLimitStatsResponseDto>, enabled?: boolean) => UseUsageDataResult;
+//# sourceMappingURL=useUsageData.d.ts.map

package/usage/useUsageData/useUsageData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUsageData.d.ts","sourceRoot":"","sources":["../../../src/usage/useUsageData/useUsageData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAG/E,4CAA4C;AAC5C,MAAM,WAAW,kBAAkB;IACjC,iJAAiJ;IACjJ,KAAK,EAAE,yBAAyB,GAAG,SAAS,CAAC;IAC7C,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,gDAAgD;IAChD,UAAU,EAAE,KAAK,GAAG,SAAS,CAAC;CAC/B;AAKD;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GACvB,cAAc,MAAM,OAAO,CAAC,yBAAyB,CAAC,EACtD,iBAAc,KACb,kBAmCF,CAAC"}

package/useShareLink/useShareLink.d.ts

@@ -1,4 +1,4 @@
-import { CreateShareLinkDtoResourceKindEnum, ShareApi } from '@epam/ai-dial-chat-api-client';
+import { ShareApi } from '@epam/ai-dial-chat-api-client';
 import { ShareLinkAccess, ShareLinkData } from '@epam/ai-dial-share';
 /** Result returned by {@link useShareLink}. */
 export interface UseShareLinkResult {
@@ -19,5 +19,5 @@ export interface UseShareLinkResult {
  * re-fetch on access change), not the client's base URL, auth, or CSRF
  * setup, which stay the caller's responsibility.
  */
-export declare const useShareLink: (shareApi: Pick<ShareApi, "createShareLink">, itemId: string, resourceKind?: CreateShareLinkDtoResourceKindEnum, origin?: string) => UseShareLinkResult;
+export declare const useShareLink: (shareApi: Pick<ShareApi, "createShareLink">, itemId: string, origin?: string) => UseShareLinkResult;
 //# sourceMappingURL=useShareLink.d.ts.map

package/useShareLink/useShareLink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useShareLink.d.ts","sourceRoot":"","sources":["../../src/useShareLink/useShareLink.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,kCAAkC,EACvC,KAAK,QAAQ,EACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAYrE,+CAA+C;AAC/C,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC;IAChC,qDAAqD;IACrD,SAAS,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,6DAA6D;IAC7D,SAAS,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,IAAI,CAAC;CAChD;AAcD;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,EAC3C,QAAQ,MAAM,EACd,eAAe,kCAAkC,EACjD,SAAQ,MAA+B,KACtC,kBAwDF,CAAC"}
+{"version":3,"file":"useShareLink.d.ts","sourceRoot":"","sources":["../../src/useShareLink/useShareLink.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAYrE,+CAA+C;AAC/C,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC;IAChC,qDAAqD;IACrD,SAAS,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,6DAA6D;IAC7D,SAAS,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,IAAI,CAAC;CAChD;AAcD;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,EAC3C,QAAQ,MAAM,EACd,SAAQ,MAA+B,KACtC,kBAwDF,CAAC"}

package/useToolsMenu/useToolsMenu.d.ts

@@ -1,26 +1,17 @@
 import { DeploymentConfigurationSchema, ToolMenuItem } from '@epam/ai-dial-chat-shared';
 import { ReactNode } from 'react';
-/** Translatable strings the tools menu surfaces. */
-export interface ToolsMenuLabels {
-    /** Fallback label for the deep-research tool when the schema defines no `title`. */
-    deepResearchFallback: string;
-}
 /** Host-supplied inputs to {@link useToolsMenu}. */
 export interface UseToolsMenuParams {
-    /** Operator-configured deep-research tool id, or `null` when none is configured. */
-    deepResearchToolId: string | null;
     /** Id of the currently selected deployment, or `null` when none is selected. */
     selectedItemId: string | null;
     /** JSON-schema configuration for the selected deployment, or `null` when none. */
     selectedDeploymentConfiguration: DeploymentConfigurationSchema | null;
-    /** Translated labels. Fields not provided fall back to English defaults. */
-    labels?: Partial<ToolsMenuLabels>;
-    /** Icon element rendered on the tool menu item. Defaults to `null`. */
+    /** Icon element rendered on every tool menu item. Defaults to `null`. */
     toolIcon?: ReactNode;
 }
 /** Result returned by {@link useToolsMenu}. */
 export type UseToolsMenuResult = {
-    /** Derived submenu items (empty until a boolean tool property is found). */
+    /** One item per boolean property of the deployment configuration schema, in schema order. */
     toolsMenuItems: ToolMenuItem[];
     /** Toggles the tool with the given id; ignores unknown ids. */
     onToolToggle: (id: string) => void;
@@ -30,11 +21,11 @@ export type UseToolsMenuResult = {
     restoreToolConfiguration: (configurationValue: Record<string, unknown> | undefined) => void;
 };
 /**
- * Derives the tools submenu from the active deployment's configuration schema
- * and the operator-configured tool id. Manages toggle state locally, resets on
- * deployment change, and exposes a stable `toolConfigurationValue` record for
- * inclusion in completion requests. Headless: translation and the tool icon are
- * the host's responsibility, supplied via `labels` and `toolIcon`.
+ * Derives the tools submenu from the active deployment's configuration schema:
+ * every boolean property becomes a toggle. Manages toggle state locally, resets
+ * on deployment change, and exposes a stable `toolConfigurationValue` record for
+ * inclusion in completion requests. Headless: the tool icon is the host's
+ * responsibility, supplied via `toolIcon`.
  */
 export declare const useToolsMenu: (params: UseToolsMenuParams) => UseToolsMenuResult;
 //# sourceMappingURL=useToolsMenu.d.ts.map

package/useToolsMenu/useToolsMenu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useToolsMenu.d.ts","sourceRoot":"","sources":["../../src/useToolsMenu/useToolsMenu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC7B,YAAY,EACb,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAEf,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,oFAAoF;IACpF,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,oFAAoF;IACpF,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,gFAAgF;IAChF,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,kFAAkF;IAClF,+BAA+B,EAAE,6BAA6B,GAAG,IAAI,CAAC;IACtE,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAClC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,+CAA+C;AAC/C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,4EAA4E;IAC5E,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B,+DAA+D;IAC/D,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,wFAAwF;IACxF,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,wEAAwE;IACxE,wBAAwB,EAAE,CACxB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,KACpD,IAAI,CAAC;CACX,CAAC;AAMF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GACvB,QAAQ,kBAAkB,KACzB,kBA0FF,CAAC"}
+{"version":3,"file":"useToolsMenu.d.ts","sourceRoot":"","sources":["../../src/useToolsMenu/useToolsMenu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAE7B,YAAY,EACb,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AAEf,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,gFAAgF;IAChF,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,kFAAkF;IAClF,+BAA+B,EAAE,6BAA6B,GAAG,IAAI,CAAC;IACtE,yEAAyE;IACzE,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,+CAA+C;AAC/C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,6FAA6F;IAC7F,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B,+DAA+D;IAC/D,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,wFAAwF;IACxF,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,wEAAwE;IACxE,wBAAwB,EAAE,CACxB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,KACpD,IAAI,CAAC;CACX,CAAC;AAuCF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GACvB,QAAQ,kBAAkB,KACzB,kBAuFF,CAAC"}

package/files/string-utils.d.ts

@@ -1,3 +0,0 @@
-/** Decodes a URI-encoded path segment, returning the original string if decoding fails. */
-export declare const safeDecodeURI: (path: string) => string;
-//# sourceMappingURL=string-utils.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"string-utils.d.ts","sourceRoot":"","sources":["../../src/files/string-utils.ts"],"names":[],"mappings":"AAOA,2FAA2F;AAC3F,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MAM5C,CAAC"}

package/files/upload-batch.types.d.ts

@@ -1,22 +0,0 @@
-/** Lifecycle status of a single file within an upload batch. */
-export declare enum FileUploadStatus {
-    Queued = "queued",
-    Uploading = "uploading",
-    Completed = "completed",
-    Failed = "failed",
-    Cancelled = "cancelled"
-}
-/** Progress state for a single file within an upload batch. */
-export interface FileUploadEntry {
-    id: string;
-    name: string;
-    status: FileUploadStatus;
-    /** 0–100 while uploading when the transport reports byte progress. */
-    percent?: number;
-}
-/** State of an in-progress or just-settled upload batch, as returned by `useDialFileUploadBatch`. */
-export interface FileUploadBatchState {
-    files: FileUploadEntry[];
-    isOpen: boolean;
-}
-//# sourceMappingURL=upload-batch.types.d.ts.map

package/files/upload-batch.types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"upload-batch.types.d.ts","sourceRoot":"","sources":["../../src/files/upload-batch.types.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,oBAAY,gBAAgB;IAC1B,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB;AAED,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,gBAAgB,CAAC;IACzB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qGAAqG;AACrG,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;CACjB"}

package/files/useGridEditingScroll/useGridEditingScroll.d.ts

@@ -1,27 +0,0 @@
-import { FileManagerGridRow } from '@epam/ai-dial-react-file-manager';
-import { GridApi, IRowNode } from 'ag-grid-community';
-/** Options accepted by `useGridEditingScroll`. */
-export interface UseGridEditingScrollOptions {
-    /** Picks the row to scroll to among the rows newly added since the last `rowDataUpdated`. Defaults to the first row flagged `isTemporary`, or the first new row. */
-    resolveTargetNode?: (newNodes: IRowNode<FileManagerGridRow>[]) => IRowNode<FileManagerGridRow> | null;
-}
-/** Values returned by `useGridEditingScroll`. */
-export interface UseGridEditingScrollResult {
-    /** Pass to `DialFileManager`'s `onGridApiChange` prop. */
-    handleGridApiChange: (api: GridApi<FileManagerGridRow>) => void;
-    /** Re-seeds the known-row-id set without scrolling — call on a data-source change such as a tab switch. */
-    reset: () => void;
-}
-/**
- * `@epam/ai-dial-react-file-manager`'s `GridOptions` type does not forward raw AG Grid
- * event callbacks (`onCellEditingStarted`/`onRowDataUpdated`), so this hook
- * binds directly to the `GridApi` obtained via `DialFileManager`'s
- * `onGridApiChange` prop and uses AG Grid's own `addEventListener` instead of
- * a `gridOptions` fragment. Scrolls a newly inline-edited or newly-inserted
- * row into view. `handleGridApiChange` takes the raw `GridApi` only to bind
- * to `onGridApiChange` — the narrow AGENTS.md D9 exception for this hook —
- * and never renders, themes, or otherwise exposes AG Grid beyond that one
- * event-binding parameter.
- */
-export declare const useGridEditingScroll: ({ resolveTargetNode, }?: UseGridEditingScrollOptions) => UseGridEditingScrollResult;
-//# sourceMappingURL=useGridEditingScroll.d.ts.map

package/files/useGridEditingScroll/useGridEditingScroll.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useGridEditingScroll.d.ts","sourceRoot":"","sources":["../../../src/files/useGridEditingScroll/useGridEditingScroll.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAEL,OAAO,EACP,QAAQ,EAET,MAAM,mBAAmB,CAAC;AAmC3B,kDAAkD;AAClD,MAAM,WAAW,2BAA2B;IAC1C,oKAAoK;IACpK,iBAAiB,CAAC,EAAE,CAClB,QAAQ,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,KACrC,QAAQ,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC;CAC1C;AAOD,iDAAiD;AACjD,MAAM,WAAW,0BAA0B;IACzC,0DAA0D;IAC1D,mBAAmB,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,kBAAkB,CAAC,KAAK,IAAI,CAAC;IAChE,2GAA2G;IAC3G,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAAI,yBAElC,2BAAgC,KAAG,0BAiFrC,CAAC"}