@epam/ai-dial-chat-hooks 1.3.0-dev.29 → 1.3.0-dev.290

package/skills-state.d.ts

@@ -1,40 +1,2 @@
-import { SkillCatalogListResponseDto } from '@epam/ai-dial-chat-api-client';
-import { SkillMetadataItemDto } from '@epam/ai-dial-chat-api-client';
-
-/**
- * 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;
-
-/** Parameters for {@link useSkillsState}. */
-export declare 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 declare 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;
-}
-
-export { }
+export * from './entry-points/skills-state.js'
+export {}

package/skills-state.js

@@ -1,2 +1,3 @@
-import { useSkillsState as e } from "./skill/useSkillsState/useSkillsState.js";
-export { e as useSkillsState };
+import { findSkillByUrl as e } from "./skill/skill-lookup.js";
+import { useSkillsState as t } from "./skill/useSkillsState/useSkillsState.js";
+export { e as findSkillByUrl, t as useSkillsState };

package/source-content.d.ts

@@ -1,29 +1,2 @@
-/**
- * Returns the last path segment of `url` — its file name — for both absolute
- * URLs and DIAL-relative resource paths such as
- * `files/<bucket>/qa-routed-source.html`. Any query string or hash is dropped
- * and percent escapes are decoded. Returns an empty string when no segment can
- * be extracted. Used to classify a resource by extension when its display name
- * is a citation title rather than a file name.
- */
-export declare const getUrlFileName: (url: string) => string;
-
-/** Returns true when an external (non-DIAL) source URL should be opened in the canvas rather than a new browser tab. */
-export declare const isExternalSourcePreviewable: (contentType: string, url: string) => boolean;
-
-/**
- * Returns the content type to trust for an external citation source: `contentType`
- * unchanged when it is already an image/audio/PDF/document-renderer marker,
- * otherwise the type implied by `url`'s path extension (`application/pdf` for
- * `.pdf`, the canonical MIME for `.docx`/`.xlsx`/`.pptx`/`.csv`) when that
- * extension is recognized, otherwise `contentType` unchanged.
- *
- * Web-search grounding APIs label every reference — PDFs and Office documents
- * included — as `text/markdown`, so a mislabeled `contentType` must not win
- * over a recognized URL extension: doing so previously sent a PDF's raw bytes
- * into the markdown/text canvas viewer, rendering garbled text instead of
- * opening the PDF/OOXML viewer.
- */
-export declare const resolveExternalSourceContentType: (contentType: string, url: string) => string;
-
-export { }
+export * from './entry-points/source-content.js'
+export {}

package/source-content.js

@@ -1,2 +1 @@
-import { getUrlFileName as e, isExternalSourcePreviewable as t, resolveExternalSourceContentType as n } from "./files/source-content.js";
-export { e as getUrlFileName, t as isExternalSourcePreviewable, n as resolveExternalSourceContentType };
+export { getUrlFileName, isExternalSourcePreviewable, resolveExternalSourceContentType } from "./files/source-content.js";

package/usage/map-usage-data-to-dashboard.d.ts

@@ -0,0 +1,39 @@
+import { UserLimitStatsResponseDto } from '@epam/ai-dial-chat-api-client';
+import { UsageLimitCardData } from '@epam/ai-dial-usage-dashboard';
+import { ResetTimeDisplay } from './usage-reset-time';
+/** A translate function compatible with i18next's `TFunction`. */
+type Translate = (key: string, options?: Record<string, unknown>) => string;
+/** Formats a raw `resetsAt` into display strings, or returns `undefined` when it cannot be formatted. */
+export type FormatResetTime = (resetsAt: string | undefined) => ResetTimeDisplay | undefined;
+/**
+ * i18n key strings that the consuming app's translation bundle must define for
+ * `mapUsageDataToDashboard` to produce correctly translated strings. The
+ * values are the default key paths used by AI DIAL Chat.
+ */
+export declare const USAGE_DATA_I18N_KEYS: {
+    /** Title for the current-UTC-day card (e.g. `'Today'`). */
+    readonly todayTitle: "usage.todayTitle";
+    /** Accessible period description for the current-UTC-day card. */
+    readonly todayPeriodDescription: "usage.todayPeriodDescription";
+    /** Title for the current-UTC-week card (e.g. `'This week'`). */
+    readonly thisWeekTitle: "usage.thisWeekTitle";
+    /** Accessible period description for the current-UTC-week card. */
+    readonly thisWeekPeriodDescription: "usage.thisWeekPeriodDescription";
+    /** Title for the current-UTC-month card (e.g. `'This month'`). */
+    readonly thisMonthTitle: "usage.thisMonthTitle";
+    /** Accessible period description for the current-UTC-month card. */
+    readonly thisMonthPeriodDescription: "usage.thisMonthPeriodDescription";
+    /** Aria label when there is no limit. Receives `{ used: string }`. */
+    readonly unlimitedProgressAriaLabel: "usage.unlimitedProgressAriaLabel";
+    /** Aria label for a progress bar with a finite limit. Receives `{ used: string, total: string, percent: number }`. */
+    readonly progressAriaLabel: "usage.progressAriaLabel";
+};
+/**
+ * Maps a `UserLimitStatsResponseDto` into `UsageLimitCardGroup`'s `cards` prop,
+ * in Today / This week / This month order. A period is omitted entirely when
+ * the response carries no usable stat for it. Each card's reset trio comes from
+ * `formatResetTime`, and is absent when that callback returns `undefined`.
+ */
+export declare const mapUsageDataToDashboard: (usage: UserLimitStatsResponseDto | undefined, t: Translate, formatResetTime: FormatResetTime) => UsageLimitCardData[];
+export {};
+//# sourceMappingURL=map-usage-data-to-dashboard.d.ts.map

package/usage/map-usage-data-to-dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-usage-data-to-dashboard.d.ts","sourceRoot":"","sources":["../../src/usage/map-usage-data-to-dashboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,yBAAyB,EAC1B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAExE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,kEAAkE;AAClE,KAAK,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;AAE5E,yGAAyG;AACzG,MAAM,MAAM,eAAe,GAAG,CAC5B,QAAQ,EAAE,MAAM,GAAG,SAAS,KACzB,gBAAgB,GAAG,SAAS,CAAC;AAElC;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;IAC/B,2DAA2D;;IAE3D,kEAAkE;;IAElE,gEAAgE;;IAEhE,mEAAmE;;IAEnE,kEAAkE;;IAElE,oEAAoE;;IAEpE,sEAAsE;;IAEtE,sHAAsH;;CAE9G,CAAC;AA8FX;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,OAAO,yBAAyB,GAAG,SAAS,EAC5C,GAAG,SAAS,EACZ,iBAAiB,eAAe,KAC/B,kBAAkB,EAoCpB,CAAC"}

package/usage/map-user-usage-to-model-limits.d.ts

@@ -0,0 +1,62 @@
+import { DeploymentItemDto, UserLimitStatsResponseDto } from '@epam/ai-dial-chat-api-client';
+import { ModelLimitPeriodStatuses, ModelLimitRow } from '@epam/ai-dial-usage-dashboard';
+import { FormatResetTime } from './map-usage-data-to-dashboard';
+export type { FormatResetTime } from './map-usage-data-to-dashboard';
+/** A translate function compatible with i18next's `TFunction`. */
+type Translate = (key: string, options?: Record<string, unknown>) => string;
+/** A callback that resolves an icon URL from a deployment's raw `iconUrl` field. */
+type ResolveIconUrl = (iconUrl: string | undefined) => string | undefined;
+/** A callback that resolves a display name from a localized-text value. */
+type ResolveDisplayName = (name: string | Record<string, string> | undefined | null, locale: string) => string;
+/**
+ * i18n key strings that the consuming app's translation bundle must define for
+ * `mapUserUsageToModelLimits` and `mapOverallCostLimitsToPeriodStatuses` to produce
+ * correctly translated strings. The values are the default key paths used by AI DIAL Chat.
+ */
+export declare const USAGE_MODEL_LIMITS_I18N_KEYS: {
+    /** Period label used in tooltip text. Receives no interpolation. */
+    readonly todayPeriodDescription: "usage.todayPeriodDescription";
+    /** Period label used in tooltip text. Receives no interpolation. */
+    readonly thisWeekPeriodDescription: "usage.thisWeekPeriodDescription";
+    /** Period label used in tooltip text. Receives no interpolation. */
+    readonly thisMonthPeriodDescription: "usage.thisMonthPeriodDescription";
+    /** Tooltip when the overall cost limit is running low. Receives `{ period: string }`. */
+    readonly overallCostLimitRunningLowTooltip: "usage.overallCostLimitRunningLowTooltip";
+    /** Tooltip when the overall cost limit is reached. Receives `{ period: string }`. */
+    readonly overallCostLimitReachedTooltip: "usage.overallCostLimitReachedTooltip";
+    /** Aria label for a metric cell with no data. */
+    readonly unavailableLabel: "usage.unavailableLabel";
+    /** Supporting label when a token limit follows the cost limit. */
+    readonly followsCostLimitLabel: "usage.followsCostLimitLabel";
+    /** Supporting label when there is no per-deployment token limit. */
+    readonly noLimitLabel: "usage.noLimitLabel";
+    /** Aria label when token usage has no limit but follows the cost limit. Receives `{ used: string }`. */
+    readonly followsCostLimitAriaLabel: "usage.followsCostLimitAriaLabel";
+    /** Aria label when there is no limit. Receives `{ used: string }`. */
+    readonly unlimitedProgressAriaLabel: "usage.unlimitedProgressAriaLabel";
+    /** Aria label for a progress bar with a finite limit. Receives `{ used: string, total: string, percent: number }`. */
+    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";
+};
+/**
+ * Maps the same top-level Cost budgets used by the aggregate cards into table-header state.
+ *
+ * @param formatResetTime - Formats each period's top-level `resetsAt` into the header's reset trio. Omit it to produce statuses with no reset fields.
+ */
+export declare const mapOverallCostLimitsToPeriodStatuses: (usage: UserLimitStatsResponseDto | undefined, activeLocale: string, t: Translate, formatResetTime?: FormatResetTime) => ModelLimitPeriodStatuses;
+/**
+ * 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`.
+ */
+export declare const mapUserUsageToModelLimits: (usage: UserLimitStatsResponseDto | undefined, deploymentItems: DeploymentItemDto[], activeLocale: string, t: Translate, resolveIconUrl: ResolveIconUrl, resolveDisplayName: ResolveDisplayName) => ModelLimitRow[];
+//# sourceMappingURL=map-user-usage-to-model-limits.d.ts.map

package/usage/map-user-usage-to-model-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-user-usage-to-model-limits.d.ts","sourceRoot":"","sources":["../../src/usage/map-user-usage-to-model-limits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EAGjB,yBAAyB,EAC1B,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EAIV,wBAAwB,EACxB,aAAa,EACd,MAAM,+BAA+B,CAAC;AAMvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,YAAY,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,kEAAkE;AAClE,KAAK,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;AAE5E,oFAAoF;AACpF,KAAK,cAAc,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,SAAS,CAAC;AAE1E,2EAA2E;AAC3E,KAAK,kBAAkB,GAAG,CACxB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAAG,IAAI,EACxD,MAAM,EAAE,MAAM,KACX,MAAM,CAAC;AAmBZ;;;;GAIG;AACH,eAAO,MAAM,4BAA4B;IACvC,oEAAoE;;IAEpE,oEAAoE;;IAEpE,oEAAoE;;IAEpE,yFAAyF;;IAEzF,qFAAqF;;IAErF,iDAAiD;;IAEjD,kEAAkE;;IAElE,oEAAoE;;IAEpE,wGAAwG;;IAExG,sEAAsE;;IAEtE,sHAAsH;;IAEtH,oEAAoE;;IAEpE,8EAA8E;;IAE9E,sFAAsF;;CAE9E,CAAC;AA6HX;;;;GAIG;AACH,eAAO,MAAM,oCAAoC,GAC/C,OAAO,yBAAyB,GAAG,SAAS,EAC5C,cAAc,MAAM,EACpB,GAAG,SAAS,EACZ,kBAAiB,eAA6B,KAC7C,wBAsBD,CAAC;AAkMH;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,GACpC,OAAO,yBAAyB,GAAG,SAAS,EAC5C,iBAAiB,iBAAiB,EAAE,EACpC,cAAc,MAAM,EACpB,GAAG,SAAS,EACZ,gBAAgB,cAAc,EAC9B,oBAAoB,kBAAkB,KACrC,aAAa,EAgIf,CAAC"}

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

@@ -1,6 +1,6 @@
 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 { DeploymentItemDtoTypeEnum as t } from "@epam/ai-dial-chat-api-client";
+import { formatCost as n } from "@epam/ai-dial-chat-shared";
 import { ModelLimitMetricKind as r, ModelLimitStatus as i } from "@epam/ai-dial-usage-dashboard";
 //#region src/usage/map-user-usage-to-model-limits.ts
 var a = 2 ** 53, o = 75, s = new Intl.NumberFormat(void 0, {
@@ -95,9 +95,9 @@ var a = 2 ** 53, o = 75, s = new Intl.NumberFormat(void 0, {
 			percent: Math.round(m)
 		})
 	};
-}, x = (e, n) => {
-	if (!f(e)) return y(n);
-	let i = Math.max(0, e.used), o = n(l.spentLabel, { amount: t(i) });
+}, x = (e, t) => {
+	if (!f(e)) return y(t);
+	let i = Math.max(0, e.used), o = t(l.spentLabel, { amount: n(i) });
 	if (e.total >= a) return {
 		kind: r.Unlimited,
 		usedLabel: o,
@@ -107,12 +107,12 @@ var a = 2 ** 53, o = 75, s = new Intl.NumberFormat(void 0, {
 	return {
 		kind: r.Finite,
 		usedLabel: o,
-		totalLabel: t(s),
+		totalLabel: n(s),
 		usedPercent: c,
 		status: p(c),
-		ariaLabel: n(l.progressAriaLabel, {
-			used: t(i),
-			total: t(s),
+		ariaLabel: t(l.progressAriaLabel, {
+			used: n(i),
+			total: n(s),
 			percent: Math.round(c)
 		})
 	};
@@ -135,31 +135,31 @@ var a = 2 ** 53, o = 75, s = new Intl.NumberFormat(void 0, {
 			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;
+}, E = (e) => e.some((e) => f(e) && e.used > 0), D = (n, r, i, a, o, s) => {
+	let c = n?.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);
+	let d = new Map(r.filter((e) => e.type === t.Model || e.type === t.Application).map((t) => [e(t.id), t])), f = v(n, i, a);
+	return Object.keys(c).map((n) => {
+		let r = d.get(e(n)), p = r == null ? n : s(r.displayName, i) || r.id, m = c[n], h = o(r?.iconUrl);
+		if (r?.type === t.Application) {
+			let e = T(m, u.day, a), t = T(m, u.week, a), i = T(m, u.month, a);
 			return {
 				row: {
-					id: t,
+					id: n,
 					name: p,
 					version: r.displayVersion,
 					avatarSrc: h,
 					typeLabel: a(l.applicationTypeLabel),
 					day: e,
-					week: n,
+					week: t,
 					month: i,
 					status: w([
 						e.tokens,
-						n.tokens,
+						t.tokens,
 						i.tokens
 					], [
 						e.cost,
-						n.cost,
+						t.cost,
 						i.cost
 					], [
 						f.day.status,
@@ -173,7 +173,7 @@ var a = 2 ** 53, o = 75, s = new Intl.NumberFormat(void 0, {
 		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: t,
+				id: n,
 				name: p,
 				version: r?.displayVersion,
 				avatarSrc: h,

package/usage/usage-banner-source.d.ts

@@ -0,0 +1,24 @@
+import { UsageLimitBannerSeverity } from '@epam/ai-dial-conversation-input';
+import { isCappedStat } from '../shared/usage-stat';
+import { UsagePeriod } from './usage-period';
+import { UsageLimitsSources } from './useDeploymentUsageLimits/useDeploymentUsageLimits';
+export { isCappedStat };
+/** The day/week/month usage stat the composer banner reports on, and how close it is to its limit. */
+export interface UsageBannerSource {
+    /** Calendar period of the stat. */
+    period: UsagePeriod;
+    /** `Reached` at or above 100%, otherwise `Warning`. */
+    severity: UsageLimitBannerSeverity;
+    /** Consumed share of the stat's limit, rounded and clamped to 0–100. */
+    usedPercent: number;
+    /** DIAL Core's `resetsAt` for the stat, when it sent one. */
+    resetsAt: string | undefined;
+}
+/**
+ * Returns the capped day/week/month token stat of `sources.deployment` or cost
+ * stat of `sources.account` with the highest used/total ratio, classified
+ * against `thresholdPercent`, or `undefined` when no stat is capped or the
+ * worst one is below the threshold.
+ */
+export declare const selectUsageBannerSource: (sources: UsageLimitsSources, thresholdPercent: number) => UsageBannerSource | undefined;
+//# sourceMappingURL=usage-banner-source.d.ts.map

package/usage/usage-banner-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-banner-source.d.ts","sourceRoot":"","sources":["../../src/usage/usage-banner-source.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qDAAqD,CAAC;AAE9F,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,sGAAsG;AACtG,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,MAAM,EAAE,WAAW,CAAC;IACpB,uDAAuD;IACvD,QAAQ,EAAE,wBAAwB,CAAC;IACnC,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAsCD;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,kBAAkB,EAC3B,kBAAkB,MAAM,KACvB,iBAAiB,GAAG,SAsCtB,CAAC"}

package/usage/usage-banner-source.js

@@ -0,0 +1,61 @@
+import { isCappedStat as e } from "../shared/usage-stat.js";
+import { UsagePeriod as t } from "./usage-period.js";
+import { UsageLimitBannerSeverity as n } from "@epam/ai-dial-conversation-input";
+//#region src/usage/usage-banner-source.ts
+var r = [
+	[
+		"deployment",
+		"monthTokenStats",
+		t.Month
+	],
+	[
+		"account",
+		"monthCostStats",
+		t.Month
+	],
+	[
+		"deployment",
+		"weekTokenStats",
+		t.Week
+	],
+	[
+		"account",
+		"weekCostStats",
+		t.Week
+	],
+	[
+		"deployment",
+		"dayTokenStats",
+		t.Day
+	],
+	[
+		"account",
+		"dayCostStats",
+		t.Day
+	]
+], i = (t, i) => {
+	let a;
+	for (let [n, i, o] of r) {
+		let r = t[n]?.[i];
+		if (r == null || !e(r.total)) continue;
+		let s = Math.max(r.used, 0) / r.total;
+		(a == null || s > a.ratio) && (a = {
+			stat: r,
+			period: o,
+			ratio: s
+		});
+	}
+	if (a == null) return;
+	let o = Math.min(100, Math.round(a.ratio * 100)), s;
+	if (a.ratio >= 1) s = n.Reached;
+	else if (o >= i) s = n.Warning;
+	else return;
+	return {
+		period: a.period,
+		severity: s,
+		usedPercent: o,
+		resetsAt: a.stat.resetsAt
+	};
+};
+//#endregion
+export { e as isCappedStat, i as selectUsageBannerSource };

package/usage/usage-period.d.ts

@@ -0,0 +1,7 @@
+/** A calendar usage period the composer usage banner can report on. */
+export declare enum UsagePeriod {
+    Day = "day",
+    Week = "week",
+    Month = "month"
+}
+//# sourceMappingURL=usage-period.d.ts.map

package/usage/usage-period.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-period.d.ts","sourceRoot":"","sources":["../../src/usage/usage-period.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,oBAAY,WAAW;IACrB,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,KAAK,UAAU;CAChB"}

package/usage/usage-period.js

@@ -0,0 +1,6 @@
+//#region src/usage/usage-period.ts
+var e = /* @__PURE__ */ function(e) {
+	return e.Day = "day", e.Week = "week", e.Month = "month", e;
+}({});
+//#endregion
+export { e as UsagePeriod };

package/usage/usage-reset-time.d.ts

@@ -0,0 +1,78 @@
+import { UsagePeriod } from './usage-period';
+/**
+ * i18n key strings the consuming app's translation bundle must define for the
+ * reset-time formatters to produce translated strings. The values are the
+ * default key paths used by AI DIAL Chat.
+ */
+export declare const USAGE_RESET_I18N_KEYS: {
+    /** Visible label for a full reset time. Receives `{ dateTime: string }`. */
+    readonly resetsAtLabel: "usage.resetsAtLabel";
+    /** Spoken label for a full reset time. Receives `{ dateTime: string }`. */
+    readonly resetsAtAriaLabel: "usage.resetsAtAriaLabel";
+    /** Short daily reset sentence. Receives `{ time: string }`. */
+    readonly resetsAtTime: "conversationInput.usageBanner.resetsAtTime";
+    /** Short weekly/monthly reset sentence. Receives `{ date: string }`. */
+    readonly resetsOnDate: "conversationInput.usageBanner.resetsOnDate";
+};
+/**
+ * A DIAL Core `resetsAt` instant, normalized into the preformatted strings the
+ * usage dashboard renders. Every `Date` and `Intl` call for reset times lives
+ * in this module: the display components receive only these strings
+ * and never sees a raw timestamp, a locale, or a timezone.
+ */
+export interface ResetTimeDisplay {
+    /** Exclusive end of the period, as an epoch ms value, for boundary scheduling. */
+    resetsAtMs: number;
+    /** Machine-readable instant for a `<time dateTime>` attribute, e.g. '2026-09-16T00:00:00Z'. */
+    isoValue: string;
+    /** Visible label, e.g. 'Resets 16 Sept 2026, 03:00 GMT+3'. */
+    label: string;
+    /** Accessible expansion naming the timezone in full, e.g. 'Usage resets Sep 16, 2026 at 2:00 AM Central European Summer Time'. */
+    ariaLabel: string;
+}
+/** A translate function compatible with i18next's `TFunction`. */
+export type TranslateFn = (key: string, options?: Record<string, unknown>) => string;
+/** Offset reference used to format an unchanged reset boundary. */
+export declare enum UsageResetOffsetPolicy {
+    CurrentOffset = "current-offset",
+    ResetInstant = "reset-instant"
+}
+/** Optional host reset-display policy. */
+export interface UsageResetTimeOptions {
+    /** Defaults to current-offset. */ offsetPolicy?: UsageResetOffsetPolicy;
+}
+/**
+ * Formats DIAL Core's `resetsAt` for display in the viewer's locale and
+ * timezone, at the viewer's current UTC offset, always stating that offset so
+ * a UTC boundary shown in local time is never ambiguous.
+ *
+ * Returns `undefined` on every failure path — an absent, empty, or
+ * unparseable value, or an `Intl` implementation that throws (embedded and
+ * restricted runtimes expose incomplete ones, which is why the resolution is
+ * wrapped, matching `getBrowserTimezone` in `@epam/ai-dial-chat-hooks`). A
+ * reset time is decoration on a usage figure and never a gate on it, so the
+ * caller renders the rest of the card unchanged when this returns nothing.
+ *
+ * The boundary is never derived from the browser's own calendar — no local
+ * midnight, no start-of-week, no arithmetic on `new Date()`.
+ */
+export declare const formatUsageResetTime: (resetsAt: string | undefined, activeLocale: string, t: TranslateFn, options?: UsageResetTimeOptions) => ResetTimeDisplay | undefined;
+/** A `resetsAt` instant as the one-sentence reset notice the composer usage banner renders. */
+export interface ShortResetTimeDisplay {
+    /** Machine-readable instant for a `<time dateTime>` attribute, e.g. '2026-10-13T00:00:00Z'. */
+    isoValue: string;
+    /** Visible sentence, e.g. 'Resets at 3:00 AM GMT+3.' or 'Resets on Oct 19.'. */
+    label: string;
+    /** Accessible expansion with the full date, time and zone name, from `formatUsageResetTime`. */
+    ariaLabel: string;
+}
+/**
+ * Formats DIAL Core's `resetsAt` as the banner's reset sentence: a time with
+ * its zone offset for a daily period, a short date (with the year only when it
+ * is not the current one) for a weekly or monthly period.
+ *
+ * Returns `undefined` on the same failure paths as `formatUsageResetTime`,
+ * whose spoken form it reuses, so the caller renders the period sentence alone.
+ */
+export declare const formatUsageResetShort: (resetsAt: string | undefined, period: UsagePeriod, activeLocale: string, t: TranslateFn) => ShortResetTimeDisplay | undefined;
+//# sourceMappingURL=usage-reset-time.d.ts.map

package/usage/usage-reset-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-reset-time.d.ts","sourceRoot":"","sources":["../../src/usage/usage-reset-time.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;IAChC,4EAA4E;;IAE5E,2EAA2E;;IAE3E,+DAA+D;;IAE/D,wEAAwE;;CAEhE,CAAC;AAEX;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;IACnB,+FAA+F;IAC/F,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,kIAAkI;IAClI,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,kEAAkE;AAClE,MAAM,MAAM,WAAW,GAAG,CACxB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,MAAM,CAAC;AAmEZ,mEAAmE;AACnE,oBAAY,sBAAsB;IAChC,aAAa,mBAAmB;IAChC,YAAY,kBAAkB;CAC/B;AACD,0CAA0C;AAC1C,MAAM,WAAW,qBAAqB;IACpC,kCAAkC,CAAC,YAAY,CAAC,EAAE,sBAAsB,CAAC;CAC1E;AACD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,MAAM,GAAG,SAAS,EAC5B,cAAc,MAAM,EACpB,GAAG,WAAW,EACd,UAAS,qBAA0B,KAClC,gBAAgB,GAAG,SAmErB,CAAC;AAEF,+FAA+F;AAC/F,MAAM,WAAW,qBAAqB;IACpC,+FAA+F;IAC/F,QAAQ,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC;IACd,gGAAgG;IAChG,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAChC,UAAU,MAAM,GAAG,SAAS,EAC5B,QAAQ,WAAW,EACnB,cAAc,MAAM,EACpB,GAAG,WAAW,KACb,qBAAqB,GAAG,SAiD1B,CAAC"}

package/usage/usage-reset-time.js

@@ -0,0 +1,82 @@
+import { UsagePeriod as e } from "./usage-period.js";
+//#region src/usage/usage-reset-time.ts
+var t = {
+	resetsAtLabel: "usage.resetsAtLabel",
+	resetsAtAriaLabel: "usage.resetsAtAriaLabel",
+	resetsAtTime: "conversationInput.usageBanner.resetsAtTime",
+	resetsOnDate: "conversationInput.usageBanner.resetsOnDate"
+}, n = {
+	year: "numeric",
+	month: "short",
+	day: "numeric",
+	hour: "numeric",
+	minute: "2-digit"
+}, r = /GMT([+-])(\d{2}):(\d{2})/, i = /* @__PURE__ */ RegExp("\\u202f", "g"), a = (e, t) => {
+	let n = new Intl.DateTimeFormat("en-US", {
+		timeZoneName: "longOffset",
+		...t
+	}).formatToParts(e).find((e) => e.type === "timeZoneName")?.value, i = r.exec(n ?? "");
+	return i == null ? 0 : (i[1] === "-" ? -1 : 1) * (Number(i[2]) * 60 + Number(i[3]));
+}, o = (e, t, r, o, s) => {
+	let c = new Intl.DateTimeFormat(r, {
+		timeZoneName: o,
+		...s
+	}).formatToParts(t).find((e) => e.type === "timeZoneName")?.value ?? "", l = new Date(e + a(t, s) * 6e4);
+	return new Intl.DateTimeFormat(r, {
+		...n,
+		timeZoneName: o,
+		timeZone: "UTC"
+	}).formatToParts(l).map((e) => e.type === "timeZoneName" ? c : e.value).join("").replace(i, " ");
+}, s = /* @__PURE__ */ function(e) {
+	return e.CurrentOffset = "current-offset", e.ResetInstant = "reset-instant", e;
+}({}), c = (e, n, r, i = {}) => {
+	if (!e) return;
+	let a = Date.parse(e);
+	if (!Number.isNaN(a)) try {
+		let s = Intl.DateTimeFormat().resolvedOptions().timeZone, c = s ? { timeZone: s } : {}, l = i.offsetPolicy === "reset-instant" ? new Date(a) : /* @__PURE__ */ new Date(), u = o(a, l, n, "shortOffset", c), d = o(a, l, n, "long", c);
+		return {
+			resetsAtMs: a,
+			isoValue: e,
+			label: r(t.resetsAtLabel, { dateTime: u }),
+			ariaLabel: r(t.resetsAtAriaLabel, { dateTime: d })
+		};
+	} catch {
+		return;
+	}
+}, l = (n, r, i, a) => {
+	let o = c(n, i, a);
+	if (o != null) try {
+		let n = Intl.DateTimeFormat().resolvedOptions().timeZone, s = n ? { timeZone: n } : {}, c = new Date(o.resetsAtMs);
+		if (r === e.Day) {
+			let e = new Intl.DateTimeFormat(i, {
+				hour: "numeric",
+				minute: "2-digit",
+				timeZoneName: "shortOffset",
+				...s
+			}).format(c);
+			return {
+				isoValue: o.isoValue,
+				label: a(t.resetsAtTime, { time: e }),
+				ariaLabel: o.ariaLabel
+			};
+		}
+		let l = new Intl.DateTimeFormat("en-US", {
+			year: "numeric",
+			...s
+		}), u = l.format(c) !== l.format(/* @__PURE__ */ new Date()), d = new Intl.DateTimeFormat(i, {
+			month: "short",
+			day: "numeric",
+			...u ? { year: "numeric" } : {},
+			...s
+		}).format(c);
+		return {
+			isoValue: o.isoValue,
+			label: a(t.resetsOnDate, { date: d }),
+			ariaLabel: o.ariaLabel
+		};
+	} catch {
+		return;
+	}
+};
+//#endregion
+export { t as USAGE_RESET_I18N_KEYS, s as UsageResetOffsetPolicy, l as formatUsageResetShort, c as formatUsageResetTime };

package/usage/useDeploymentUsageLimits/useDeploymentUsageLimits.d.ts

@@ -0,0 +1,56 @@
+import { DeploymentLimitsResponseDto, UserLimitStatsResponseDto } from '@epam/ai-dial-chat-api-client';
+/** The caller's account-wide cost budget and spend: the top level of a user-usage response. */
+export type AccountUsage = Pick<UserLimitStatsResponseDto, 'dayCostStats' | 'weekCostStats' | 'monthCostStats'>;
+/**
+ * What the usage dial and the usage banner are mapped from. Each field has a
+ * single scope, so a deployment's figures are never read as the account's or
+ * the other way round.
+ */
+export interface UsageLimitsSources {
+    /** The selected deployment's own stats (its deployment-usage response). Only its token stats are read. */
+    deployment: DeploymentLimitsResponseDto | undefined;
+    /** The caller's account budget and spend. Only its cost stats are read. */
+    account: AccountUsage | undefined;
+}
+/** Host-configured calls that fetch the two usage sources. */
+export interface UsageLimitsApi {
+    /** Fetches one deployment's own usage, every stat scoped to that deployment. */
+    getDeploymentUsage: (deploymentId: string) => Promise<DeploymentLimitsResponseDto>;
+    /** Fetches the caller's account usage; only its top-level cost stats are read. */
+    getAccountUsage: () => Promise<AccountUsage>;
+}
+/** Return shape of {@link useDeploymentUsageLimits}. */
+export interface UseDeploymentUsageLimitsResult {
+    /** The last successfully fetched value of each source. */
+    sources: UsageLimitsSources;
+    /** `true` until both calls of the current fetch have settled. */
+    isLoading: boolean;
+    /** `true` after either call of the most recent fetch rejected. */
+    hasError: boolean;
+    /** Re-fetches both sources when no request is in flight. */
+    refresh: () => void;
+}
+/**
+ * Fetches the selected deployment's own usage and the caller's account usage
+ * through the provided `api`. The hook accepts the calls as a parameter so the
+ * caller supplies an already-configured API client; the hook never constructs
+ * or imports one itself. The identity of `api` is not a re-fetch trigger; only
+ * `deploymentId` and `refresh()` are.
+ *
+ * Two sources rather than one deployment-limits response: there, the cost
+ * stats add an application's aggregated callee cost to the account spend that
+ * already contains it, so an agent's spend would be counted twice.
+ *
+ * Both calls share one monotonic request ID, so a slower response for a
+ * previous deployment never replaces the current value. Each source keeps its
+ * last known value when its own call fails, so the open popover can surface a
+ * non-blocking error while the other source still renders. The account source
+ * survives a deployment change, since it does not depend on the selection.
+ *
+ * The raw responses are returned rather than a mapped display model: mapping
+ * needs the caller's translated labels and locale-bound reset formatter, and
+ * holding the mapped value in state here would leave it stale after a language
+ * change until the next fetch.
+ */
+export declare const useDeploymentUsageLimits: (deploymentId: string | undefined, api: UsageLimitsApi) => UseDeploymentUsageLimitsResult;
+//# sourceMappingURL=useDeploymentUsageLimits.d.ts.map

package/usage/useDeploymentUsageLimits/useDeploymentUsageLimits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeploymentUsageLimits.d.ts","sourceRoot":"","sources":["../../../src/usage/useDeploymentUsageLimits/useDeploymentUsageLimits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,yBAAyB,EAC1B,MAAM,+BAA+B,CAAC;AAGvC,+FAA+F;AAC/F,MAAM,MAAM,YAAY,GAAG,IAAI,CAC7B,yBAAyB,EACzB,cAAc,GAAG,eAAe,GAAG,gBAAgB,CACpD,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,0GAA0G;IAC1G,UAAU,EAAE,2BAA2B,GAAG,SAAS,CAAC;IACpD,2EAA2E;IAC3E,OAAO,EAAE,YAAY,GAAG,SAAS,CAAC;CACnC;AAED,8DAA8D;AAC9D,MAAM,WAAW,cAAc;IAC7B,gFAAgF;IAChF,kBAAkB,EAAE,CAClB,YAAY,EAAE,MAAM,KACjB,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAC1C,kFAAkF;IAClF,eAAe,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;CAC9C;AAED,wDAAwD;AACxD,MAAM,WAAW,8BAA8B;IAC7C,0DAA0D;IAC1D,OAAO,EAAE,kBAAkB,CAAC;IAC5B,iEAAiE;IACjE,SAAS,EAAE,OAAO,CAAC;IACnB,kEAAkE;IAClE,QAAQ,EAAE,OAAO,CAAC;IAClB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,wBAAwB,GACnC,cAAc,MAAM,GAAG,SAAS,EAChC,KAAK,cAAc,KAClB,8BA6EF,CAAC"}