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

package/skill-editor.d.ts

@@ -7,6 +7,7 @@ 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';
@@ -15,7 +16,10 @@ 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.
+ * 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;
 
@@ -50,11 +54,20 @@ export declare const buildSkillManifestFromFrontmatter: (baseFrontmatter: Record
  */
 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.
+ * 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;
 
@@ -102,9 +115,19 @@ export declare const parseSkillManifestDocument: (raw: string) => SkillManifestD
  */
 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
@@ -192,6 +215,8 @@ export declare interface SkillEditorSubmitClient {
 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
@@ -327,6 +352,9 @@ export declare interface SkillFilesPayload {
  */
 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. */
@@ -363,6 +391,9 @@ export declare interface SkillManifestValues {
     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?
@@ -391,21 +422,24 @@ declare type SubmitPhase = 'idle' | 'submitting' | 'success' | 'failure';
 export declare interface UnpackedSkillArchive {
     /** The root `SKILL.md` entry's decoded text content. */
     manifestText: string;
-    /** Every non-manifest entry, keyed by relative path. */
+    /** 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 design.md) into its manifest text and every other entry's
- * bytes. Throws if the archive has no root `SKILL.md` entry.
+ * 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, and import completion. The host supplies the configured request
+ * 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.
  */
@@ -413,8 +447,8 @@ export declare const useSkillArchiveImport: <TResult>({ importArchive, onImporte
 
 /** Options accepted by {@link useSkillArchiveImport}. */
 export declare interface UseSkillArchiveImportOptions<TResult> {
-    /** Submits the selected archive; the host owns request configuration and the client. */
-    importArchive: (file: File) => Promise<TResult>;
+    /** 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. */
@@ -429,13 +463,15 @@ export declare interface UseSkillArchiveImportResult {
     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, unless an import is already in flight. */
+    /** Opens the dialog and clears any previous rejection or request failure. */
     openDialog: () => void;
-    /** Closes the dialog and clears any rejection reason. */
+    /** 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;
@@ -494,7 +530,7 @@ export declare interface UseSkillEditorLoadResult {
  * `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 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 {
@@ -514,6 +550,8 @@ export declare interface UseSkillEditorSubmitParams {
     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. */
@@ -534,6 +572,10 @@ export declare interface UseSkillEditorSubmitResult {
     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;
@@ -553,10 +595,11 @@ export declare interface UseSkillEditorSubmitResult {
 /**
  * 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
+ * `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, }: UseSkillFileActionsParams) => UseSkillFileActionsResult;
+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 {
@@ -580,6 +623,12 @@ export declare interface UseSkillFileActionsParams {
     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}. */

package/skill-editor.js

@@ -1,9 +1,9 @@
-import { SKILL_FILE_UPLOAD_MAX_BYTES as e, SKILL_MANIFEST_FILE as t, SKILL_UPLOAD_MAX_FILES as n, SKILL_UPLOAD_MAX_TOTAL_BYTES as r, buildSkillFilesPayload as i, buildSkillManifest as a, buildSkillManifestForSubmit as o, buildSkillManifestFromFrontmatter as s, isValidSkillRelativePath as c, nameFromPath as l, normalizeSkillName as u, parseSkillManifest as d, skillFileBytesToBlob as f, startsWithFrontmatterBlock as p, unpackSkillArchive as m } from "./skill/skill.js";
-import { parseSkillManifestDocument as h } from "./skill/skill-manifest.js";
-import { validateSkillFileBatch as g } from "./skill/skill-file-batch-validation.js";
-import { skillFileToAttachment as _ } from "./skill/skill-file-preview.js";
-import { SkillEditorLoadState as v, useSkillEditorLoad as y } from "./skill/useSkillEditorLoad.js";
-import { useSkillEditorSubmit as b } from "./skill/useSkillEditorSubmit.js";
-import { useSkillFileActions as x } from "./skill/useSkillFileActions.js";
-import { SkillArchiveImportErrorKind as S, SkillArchiveImportStatus as C, SkillArchiveSelectionRejectionReason as w, classifySkillArchiveImportError as T, useSkillArchiveImport as E } from "./skill/useSkillArchiveImport/useSkillArchiveImport.js";
-export { e as SKILL_FILE_UPLOAD_MAX_BYTES, t as SKILL_MANIFEST_FILE, n as SKILL_UPLOAD_MAX_FILES, r as SKILL_UPLOAD_MAX_TOTAL_BYTES, S as SkillArchiveImportErrorKind, C as SkillArchiveImportStatus, w as SkillArchiveSelectionRejectionReason, v as SkillEditorLoadState, i as buildSkillFilesPayload, a as buildSkillManifest, o as buildSkillManifestForSubmit, s as buildSkillManifestFromFrontmatter, T as classifySkillArchiveImportError, c as isValidSkillRelativePath, l as nameFromPath, u as normalizeSkillName, d as parseSkillManifest, h as parseSkillManifestDocument, f as skillFileBytesToBlob, _ as skillFileToAttachment, p as startsWithFrontmatterBlock, m as unpackSkillArchive, E as useSkillArchiveImport, y as useSkillEditorLoad, b as useSkillEditorSubmit, x as useSkillFileActions, g as validateSkillFileBatch };
+import { SKILL_FILE_UPLOAD_MAX_BYTES as e, SKILL_FOLDER_MARKER as t, SKILL_MANIFEST_FILE as n, SKILL_TEXT_FIELD_MAX_LENGTHS as r, SKILL_UPLOAD_MAX_FILES as i, SKILL_UPLOAD_MAX_TOTAL_BYTES as a, buildSkillFilesPayload as o, buildSkillManifest as s, buildSkillManifestForSubmit as c, buildSkillManifestFromFrontmatter as l, getSkillFieldLengthViolations as u, isSkillFolderMarkerPath as d, isValidSkillRelativePath as f, nameFromPath as p, normalizeSkillName as m, parseSkillManifest as h, skillFileBytesToBlob as g, skillFolderMarkerParent as _, startsWithFrontmatterBlock as v, unpackSkillArchive as y } from "./skill/skill.js";
+import { parseSkillManifestDocument as b } from "./skill/skill-manifest.js";
+import { validateSkillFileBatch as x } from "./skill/skill-file-batch-validation.js";
+import { skillFileToAttachment as S } from "./skill/skill-file-preview.js";
+import { SkillEditorLoadState as C, useSkillEditorLoad as w } from "./skill/useSkillEditorLoad.js";
+import { useSkillEditorSubmit as T } from "./skill/useSkillEditorSubmit.js";
+import { useSkillFileActions as E } from "./skill/useSkillFileActions.js";
+import { SkillArchiveImportErrorKind as D, SkillArchiveImportStatus as O, SkillArchiveSelectionRejectionReason as k, classifySkillArchiveImportError as A, useSkillArchiveImport as j } from "./skill/useSkillArchiveImport/useSkillArchiveImport.js";
+export { e as SKILL_FILE_UPLOAD_MAX_BYTES, t as SKILL_FOLDER_MARKER, n as SKILL_MANIFEST_FILE, r as SKILL_TEXT_FIELD_MAX_LENGTHS, i as SKILL_UPLOAD_MAX_FILES, a as SKILL_UPLOAD_MAX_TOTAL_BYTES, D as SkillArchiveImportErrorKind, O as SkillArchiveImportStatus, k as SkillArchiveSelectionRejectionReason, C as SkillEditorLoadState, o as buildSkillFilesPayload, s as buildSkillManifest, c as buildSkillManifestForSubmit, l as buildSkillManifestFromFrontmatter, A as classifySkillArchiveImportError, u as getSkillFieldLengthViolations, d as isSkillFolderMarkerPath, f as isValidSkillRelativePath, p as nameFromPath, m as normalizeSkillName, h as parseSkillManifest, b as parseSkillManifestDocument, g as skillFileBytesToBlob, S as skillFileToAttachment, _ as skillFolderMarkerParent, v as startsWithFrontmatterBlock, y as unpackSkillArchive, j as useSkillArchiveImport, w as useSkillEditorLoad, T as useSkillEditorSubmit, E as useSkillFileActions, x as validateSkillFileBatch };

package/usage/map-user-usage-to-model-limits.js

@@ -1,11 +1,12 @@
-import { formatCost as e } from "@epam/ai-dial-chat-shared";
-import { DeploymentItemDtoTypeEnum as t } from "@epam/ai-dial-chat-api-client";
-import { ModelLimitMetricKind as n, ModelLimitStatus as r } from "@epam/ai-dial-usage-dashboard";
+import { normalizeDeploymentId as e } from "../catalog/deployment-id.js";
+import { formatCost as t } from "@epam/ai-dial-chat-shared";
+import { DeploymentItemDtoTypeEnum as n } from "@epam/ai-dial-chat-api-client";
+import { ModelLimitMetricKind as r, ModelLimitStatus as i } from "@epam/ai-dial-usage-dashboard";
 //#region src/usage/map-user-usage-to-model-limits.ts
-var i = 2 ** 53, a = 75, o = new Intl.NumberFormat(void 0, {
+var a = 2 ** 53, o = 75, s = new Intl.NumberFormat(void 0, {
 	notation: "compact",
 	maximumFractionDigits: 1
-}), s = new Intl.NumberFormat(void 0, { maximumFractionDigits: 2 }), c = {
+}), c = new Intl.NumberFormat(void 0, { maximumFractionDigits: 2 }), l = {
 	todayPeriodDescription: "usage.todayPeriodDescription",
 	thisWeekPeriodDescription: "usage.thisWeekPeriodDescription",
 	thisMonthPeriodDescription: "usage.thisMonthPeriodDescription",
@@ -17,8 +18,10 @@ var i = 2 ** 53, a = 75, o = new Intl.NumberFormat(void 0, {
 	followsCostLimitAriaLabel: "usage.followsCostLimitAriaLabel",
 	unlimitedProgressAriaLabel: "usage.unlimitedProgressAriaLabel",
 	progressAriaLabel: "usage.progressAriaLabel",
-	spentLabel: "usage.spentLabel"
-}, l = {
+	spentLabel: "usage.spentLabel",
+	applicationTypeLabel: "usage.applicationTypeLabel",
+	includesCalledModelsLabel: "usage.includesCalledModelsLabel"
+}, u = {
 	day: {
 		cost: "dayCostStats",
 		tokens: "dayTokenStats"
@@ -31,130 +34,169 @@ var i = 2 ** 53, a = 75, o = new Intl.NumberFormat(void 0, {
 		cost: "monthCostStats",
 		tokens: "monthTokenStats"
 	}
-}, u = {
+}, d = {
 	day: {
 		field: "dayCostStats",
-		labelKey: c.todayPeriodDescription
+		labelKey: l.todayPeriodDescription
 	},
 	week: {
 		field: "weekCostStats",
-		labelKey: c.thisWeekPeriodDescription
+		labelKey: l.thisWeekPeriodDescription
 	},
 	month: {
 		field: "monthCostStats",
-		labelKey: c.thisMonthPeriodDescription
+		labelKey: l.thisMonthPeriodDescription
 	}
-}, d = (e) => e != null && Number.isFinite(e.total) && Number.isFinite(e.used), f = (e) => e >= 100 ? r.LimitReached : e >= a ? r.RunningLow : r.WithinLimits, p = (e) => {
-	if (!d(e)) return r.Unavailable;
-	if (e.total >= i) return r.NoLimit;
+}, f = (e) => e != null && Number.isFinite(e.total) && Number.isFinite(e.used), p = (e) => e >= 100 ? i.LimitReached : e >= o ? i.RunningLow : i.WithinLimits, m = (e) => {
+	if (!f(e)) return i.Unavailable;
+	if (e.total >= a) return i.NoLimit;
 	let t = Math.max(0, e.used), n = Math.max(0, e.total);
-	return f(n > 0 ? t / n * 100 : 100);
-}, m = (e) => e === r.WithinLimits || e === r.RunningLow || e === r.LimitReached, h = (e, t, n, i, a) => {
-	let o = e?.[t.field], s = p(o), l = a(o?.resetsAt), u = i(t.labelKey).toLocaleLowerCase(n);
+	return p(n > 0 ? t / n * 100 : 100);
+}, h = (e) => e === i.WithinLimits || e === i.RunningLow || e === i.LimitReached, g = (e, t, n, r, a) => {
+	let o = e?.[t.field], s = m(o), c = a(o?.resetsAt), u = r(t.labelKey).toLocaleLowerCase(n);
 	return {
 		status: s,
-		tooltipLabel: s === r.LimitReached ? i(c.overallCostLimitReachedTooltip, { period: u }) : s === r.RunningLow ? i(c.overallCostLimitRunningLowTooltip, { period: u }) : void 0,
-		...l ? {
-			resetLabel: l.label,
-			resetIsoValue: l.isoValue,
-			resetAriaLabel: l.ariaLabel
+		tooltipLabel: s === i.LimitReached ? r(l.overallCostLimitReachedTooltip, { period: u }) : s === i.RunningLow ? r(l.overallCostLimitRunningLowTooltip, { period: u }) : void 0,
+		...c ? {
+			resetLabel: c.label,
+			resetIsoValue: c.isoValue,
+			resetAriaLabel: c.ariaLabel
 		} : {}
 	};
-}, g = () => void 0, _ = (e, t, n, r = g) => ({
-	day: h(e, u.day, t, n, r),
-	week: h(e, u.week, t, n, r),
-	month: h(e, u.month, t, n, r)
-}), v = (e) => ({
-	kind: n.Unavailable,
-	ariaLabel: e(c.unavailableLabel)
-}), y = (e, t, r) => {
-	if (!d(e)) return v(r);
-	let a = Math.max(0, e.used), l = o.format(a);
-	if (e.total >= i) {
-		let e = m(t);
+}, _ = () => void 0, v = (e, t, n, r = _) => ({
+	day: g(e, d.day, t, n, r),
+	week: g(e, d.week, t, n, r),
+	month: g(e, d.month, t, n, r)
+}), y = (e) => ({
+	kind: r.Unavailable,
+	ariaLabel: e(l.unavailableLabel)
+}), b = (e, t, n) => {
+	if (!f(e)) return y(n);
+	let i = Math.max(0, e.used), o = s.format(i);
+	if (e.total >= a) {
+		let e = h(t);
 		return {
-			kind: n.Unlimited,
-			usedLabel: l,
-			supportingLabel: r(e ? c.followsCostLimitLabel : c.noLimitLabel),
-			ariaLabel: r(e ? c.followsCostLimitAriaLabel : c.unlimitedProgressAriaLabel, { used: s.format(a) })
+			kind: r.Unlimited,
+			usedLabel: o,
+			supportingLabel: n(e ? l.followsCostLimitLabel : l.noLimitLabel),
+			ariaLabel: n(e ? l.followsCostLimitAriaLabel : l.unlimitedProgressAriaLabel, { used: c.format(i) })
 		};
 	}
-	let u = Math.max(e.total, 0), p = o.format(u), h = u > 0 ? a / u * 100 : 100, g = f(h);
+	let u = Math.max(e.total, 0), d = s.format(u), m = u > 0 ? i / u * 100 : 100, g = p(m);
 	return {
-		kind: n.Finite,
-		usedLabel: l,
-		totalLabel: p,
-		usedPercent: h,
+		kind: r.Finite,
+		usedLabel: o,
+		totalLabel: d,
+		usedPercent: m,
 		status: g,
-		ariaLabel: r(c.progressAriaLabel, {
-			used: s.format(a),
-			total: s.format(u),
-			percent: Math.round(h)
+		ariaLabel: n(l.progressAriaLabel, {
+			used: c.format(i),
+			total: c.format(u),
+			percent: Math.round(m)
 		})
 	};
-}, b = (t, r) => {
-	if (!d(t)) return v(r);
-	let a = Math.max(0, t.used), o = r(c.spentLabel, { amount: e(a) });
-	if (t.total >= i) return {
-		kind: n.Unlimited,
+}, x = (e, n) => {
+	if (!f(e)) return y(n);
+	let i = Math.max(0, e.used), o = n(l.spentLabel, { amount: t(i) });
+	if (e.total >= a) return {
+		kind: r.Unlimited,
 		usedLabel: o,
 		ariaLabel: o
 	};
-	let s = Math.max(t.total, 0), l = s > 0 ? a / s * 100 : 100;
+	let s = Math.max(e.total, 0), c = s > 0 ? i / s * 100 : 100;
 	return {
-		kind: n.Finite,
+		kind: r.Finite,
 		usedLabel: o,
-		totalLabel: e(s),
-		usedPercent: l,
-		status: f(l),
-		ariaLabel: r(c.progressAriaLabel, {
-			used: e(a),
-			total: e(s),
-			percent: Math.round(l)
+		totalLabel: t(s),
+		usedPercent: c,
+		status: p(c),
+		ariaLabel: n(l.progressAriaLabel, {
+			used: t(i),
+			total: t(s),
+			percent: Math.round(c)
 		})
 	};
-}, x = (e, t, n, r) => ({
-	tokens: y(e[t.tokens], n, r),
-	cost: b(e[t.cost], r)
-}), S = (e) => e.filter((e) => e.kind === n.Finite).map((e) => e.status), C = (e, t, i) => {
+}, S = (e, t, n, r) => ({
+	tokens: b(e[t.tokens], n, r),
+	cost: x(e[t.cost], r)
+}), C = (e) => e.filter((e) => e.kind === r.Finite).map((e) => e.status), w = (e, t, n) => {
 	let a = [
-		...S(e),
-		...S(t),
-		...i
-	].filter((e) => e != null && m(e));
-	return a.includes(r.LimitReached) ? r.LimitReached : a.includes(r.RunningLow) ? r.RunningLow : a.includes(r.WithinLimits) ? r.WithinLimits : e.some((e) => e.kind === n.Unlimited) || i.includes(r.NoLimit) ? r.NoLimit : r.Unavailable;
-}, w = (e) => e.some((e) => d(e) && e.used > 0), T = (e, n, r, i, a, o) => {
-	let s = e?.deployments;
-	if (s == null) return [];
-	let c = new Map(n.filter((e) => e.type === t.Model).map((e) => [e.id, e])), u = _(e, r, i);
-	return Object.keys(s).map((e) => {
-		let t = c.get(e), n = t == null ? e : o(t.displayName, r) || t.id, d = s[e], f = a(t?.iconUrl), p = x(d, l.day, u.day.status, i), m = x(d, l.week, u.week.status, i), h = x(d, l.month, u.month.status, i), g = Object.values(l).flatMap(({ cost: e, tokens: t }) => [d[e], d[t]]);
+		...C(e),
+		...C(t),
+		...n
+	].filter((e) => e != null && h(e));
+	return a.includes(i.LimitReached) ? i.LimitReached : a.includes(i.RunningLow) ? i.RunningLow : a.includes(i.WithinLimits) ? i.WithinLimits : e.some((e) => e.kind === r.Unlimited) || n.includes(i.NoLimit) ? i.NoLimit : i.Unavailable;
+}, T = (e, t, n) => {
+	let i = x(e[t.cost], n);
+	return {
+		tokens: y(n),
+		cost: i.kind === r.Unlimited ? {
+			...i,
+			supportingLabel: n(l.includesCalledModelsLabel)
+		} : i
+	};
+}, E = (e) => e.some((e) => f(e) && e.used > 0), D = (t, r, i, a, o, s) => {
+	let c = t?.deployments;
+	if (c == null) return [];
+	let d = new Map(r.filter((e) => e.type === n.Model || e.type === n.Application).map((t) => [e(t.id), t])), f = v(t, i, a);
+	return Object.keys(c).map((t) => {
+		let r = d.get(e(t)), p = r == null ? t : s(r.displayName, i) || r.id, m = c[t], h = o(r?.iconUrl);
+		if (r?.type === n.Application) {
+			let e = T(m, u.day, a), n = T(m, u.week, a), i = T(m, u.month, a);
+			return {
+				row: {
+					id: t,
+					name: p,
+					version: r.displayVersion,
+					avatarSrc: h,
+					typeLabel: a(l.applicationTypeLabel),
+					day: e,
+					week: n,
+					month: i,
+					status: w([
+						e.tokens,
+						n.tokens,
+						i.tokens
+					], [
+						e.cost,
+						n.cost,
+						i.cost
+					], [
+						f.day.status,
+						f.week.status,
+						f.month.status
+					])
+				},
+				hasUsage: E(Object.values(u).map(({ cost: e }) => m[e]))
+			};
+		}
+		let g = S(m, u.day, f.day.status, a), _ = S(m, u.week, f.week.status, a), v = S(m, u.month, f.month.status, a), y = Object.values(u).flatMap(({ cost: e, tokens: t }) => [m[e], m[t]]);
 		return {
 			row: {
-				id: e,
-				name: n,
-				version: t?.displayVersion,
-				avatarSrc: f,
-				day: p,
-				week: m,
-				month: h,
-				status: C([
-					p.tokens,
-					m.tokens,
-					h.tokens
+				id: t,
+				name: p,
+				version: r?.displayVersion,
+				avatarSrc: h,
+				day: g,
+				week: _,
+				month: v,
+				status: w([
+					g.tokens,
+					_.tokens,
+					v.tokens
 				], [
-					p.cost,
-					m.cost,
-					h.cost
+					g.cost,
+					_.cost,
+					v.cost
 				], [
-					u.day.status,
-					u.week.status,
-					u.month.status
+					f.day.status,
+					f.week.status,
+					f.month.status
 				])
 			},
-			hasUsage: w(g)
+			hasUsage: E(y)
 		};
 	}).filter(({ hasUsage: e }) => e).map(({ row: e }) => e);
 };
 //#endregion
-export { c as USAGE_MODEL_LIMITS_I18N_KEYS, _ as mapOverallCostLimitsToPeriodStatuses, T as mapUserUsageToModelLimits };
+export { l as USAGE_MODEL_LIMITS_I18N_KEYS, v as mapOverallCostLimitsToPeriodStatuses, D as mapUserUsageToModelLimits };

package/usage.d.ts

@@ -23,9 +23,10 @@ export declare const mapOverallCostLimitsToPeriodStatuses: (usage: UserLimitStat
 export declare const mapUsageDataToDashboard: (usage: UserLimitStatsResponseDto | undefined, t: Translate, formatResetTime: FormatResetTime) => UsageLimitCardData[];
 
 /**
- * Maps `usage.deployments` into `ModelLimitsSection`'s `rows` prop, joined with model identity
- * from `deploymentItems`. Rows are included only when any displayed period stat has nonzero usage.
- * Order follows `Object.keys(deployments)` — `deploymentItems` is enrichment-only.
+ * Maps `usage.deployments` into `ModelLimitsSection`'s `rows` prop, joined with model or application
+ * identity from `deploymentItems`. Rows are included only when any displayed period stat has nonzero
+ * usage (Cost stats only, for an application). Order follows `Object.keys(deployments)` —
+ * `deploymentItems` is enrichment-only.
  *
  * @param resolveIconUrl - Resolves a deployment's raw `iconUrl` to the URL the avatar should load.
  * @param resolveDisplayName - Resolves a localized-text map or plain string to the display name for `activeLocale`.
@@ -115,6 +116,10 @@ export declare const USAGE_MODEL_LIMITS_I18N_KEYS: {
     readonly progressAriaLabel: "usage.progressAriaLabel";
     /** Label for the spent-cost cell. Receives `{ amount: string }`. */
     readonly spentLabel: "usage.spentLabel";
+    /** Type caption for an application (agent) row. Receives no interpolation. */
+    readonly applicationTypeLabel: "usage.applicationTypeLabel";
+    /** Supporting label on an application row's spent cost. Receives no interpolation. */
+    readonly includesCalledModelsLabel: "usage.includesCalledModelsLabel";
 };
 
 export { }

package/usePageFileDrag/usePageFileDrag.js

@@ -6,8 +6,8 @@ var a = (a = !0, o = !0) => {
 		f.current = a, p.current = o, o || (d.current = 0, c(!1));
 	}, [a, o]);
 	let m = e(() => {
-		u([]);
-	}, []);
+		u((e) => e.filter((e) => !l.includes(e)));
+	}, [l]);
 	return t(() => {
 		let e = (e) => !!e.dataTransfer?.types.includes("Files"), t = (t) => {
 			!p.current || !e(t) || (d.current += 1, c(!0));
@@ -18,7 +18,7 @@ var a = (a = !0, o = !0) => {
 		}, i = (t) => {
 			if (!(!e(t) || !p.current) && (t.preventDefault(), d.current = 0, c(!1), f.current)) {
 				let e = Array.from(t.dataTransfer?.files ?? []);
-				e.length > 0 && u(e);
+				e.length > 0 && u((t) => [...t, ...e]);
 			}
 		};
 		return document.addEventListener("dragenter", t), document.addEventListener("dragleave", n), document.addEventListener("dragover", r), document.addEventListener("drop", i), () => {