@epam/ai-dial-chat-hooks 1.2.0-dev.141 → 1.2.0-dev.143

package/catalog/map-deployment-limits-to-input.js

@@ -1,14 +1,86 @@
+import { formatCost as e } from "@epam/ai-dial-chat-shared";
+import { CatalogLimitStatus as t } from "@epam/ai-dial-catalog";
 //#region src/catalog/map-deployment-limits-to-input.ts
-var e = (e) => {
-	let t = e?.monthTokenStats;
-	if (t == null || !Number.isFinite(t.total) || !Number.isFinite(t.used) || t.total <= 0 || t.total >= 2 ** 53 - 1) return;
-	let n = Math.max(0, t.used);
+var n = [
+	{
+		key: "dayTokenStats",
+		labelField: "periodDay"
+	},
+	{
+		key: "weekTokenStats",
+		labelField: "periodWeek"
+	},
+	{
+		key: "monthTokenStats",
+		labelField: "periodMonth"
+	}
+], r = [
+	{
+		key: "dayCostStats",
+		labelField: "periodDay"
+	},
+	{
+		key: "weekCostStats",
+		labelField: "periodWeek"
+	},
+	{
+		key: "monthCostStats",
+		labelField: "periodMonth"
+	}
+], i = 2 ** 53 - 1, a = .75, o = [1e6, 1e3], s = new Intl.NumberFormat(void 0, {
+	notation: "compact",
+	maximumFractionDigits: 1
+}), c = new Intl.NumberFormat(void 0, { maximumFractionDigits: 2 }), l = (e) => {
+	let t = o.find((t) => Math.abs(e) >= t);
+	return t == null ? e : Math.trunc(e / t * 10) / 10 * t;
+}, u = (e) => e != null && Number.isFinite(e.total) && Number.isFinite(e.used) && e.total > 0, d = (e) => e >= i, f = (e, t) => {
+	let n = t?.(e.resetsAt);
+	return n ? {
+		resetLabel: n.label,
+		resetIsoValue: n.isoValue,
+		resetAriaLabel: n.ariaLabel
+	} : {};
+}, p = (e, t, n, r, i) => {
+	let a = Math.max(0, e.used), o = e.total, s = r.format(a), c = r.format(o);
 	return {
-		used: n,
-		total: t.total,
-		remaining: Math.max(0, t.total - n),
-		usedPercent: Math.min(100, Math.round(n / t.total * 100))
+		label: t,
+		used: a,
+		total: o,
+		...f(e, i),
+		usedLabel: s,
+		totalLabel: c,
+		valueLabel: n.formatValueLabel(s, c),
+		ariaLabel: n.formatProgressAriaLabel({
+			label: t,
+			used: r.formatFull(a),
+			total: r.formatFull(o)
+		})
 	};
+}, m = (e) => d(e.total) ? 0 : Math.max(e.used, 0) / e.total, h = (e) => m(e) >= a, g = (e) => e.reduce((e, n) => {
+	let r = m(n);
+	return r >= 1 ? t.LimitReached : r >= a && e !== t.LimitReached ? t.RunningLow : e;
+}, void 0), _ = (e, t, n, r, i, a, o) => {
+	let s = t.flatMap((t) => {
+		let n = e[t.key];
+		return !u(n) || !h(n) ? [] : (o.push(n), [p(n, r[t.labelField], r, i, a)]);
+	});
+	return s.length > 0 ? {
+		label: n,
+		rows: s
+	} : void 0;
+}, v = (t, i, a) => {
+	if (t == null) return;
+	let o = [], u = [_(t, n, i.tokenGroup, i, {
+		format: (e) => s.format(l(e)),
+		formatFull: (e) => c.format(e)
+	}, a, o), _(t, r, i.costGroup, i, {
+		format: e,
+		formatFull: e
+	}, a, o)].filter((e) => e != null);
+	return u.length > 0 ? {
+		groups: u,
+		status: g(o)
+	} : void 0;
 };
 //#endregion
-export { e as mapDeploymentLimitsToInput };
+export { v as mapDeploymentLimitsToInput };

package/catalog.d.ts

@@ -247,6 +247,28 @@ export declare enum CatalogPrimaryActionType {
  */
 export declare type CatalogPublishEntityType = 'model' | 'toolset' | 'application' | 'prompt' | 'skill';
 
+/** Labels and formatter callbacks for the conversation-input limits mapping utility. */
+export declare interface ConversationInputLimitsLabels {
+    /** Heading of the group listing the selected deployment's token limits. */
+    tokenGroup: string;
+    /** Heading of the group listing the caller's cost budget, which spans every deployment. */
+    costGroup: string;
+    /** Label for the current-UTC-day row, used by both groups. */
+    periodDay: string;
+    /** Label for the current-UTC-week row, used by both groups. */
+    periodWeek: string;
+    /** Label for the current-UTC-month row, used by both groups. */
+    periodMonth: string;
+    /** Formats the combined used/total display value for a capped row. */
+    formatValueLabel: (used: string, total: string) => string;
+    /** Formats the ARIA label for a capped progress row. */
+    formatProgressAriaLabel: (params: {
+        label: string;
+        used: string;
+        total: string;
+    }) => string;
+}
+
 /**
  * Wraps the generated `PublishApi` in the positional-argument surface the
  * catalog and conversation publish flows call, so each host app re-exports one
@@ -369,6 +391,9 @@ export declare const filterHiddenOwnedItems: (items: readonly CatalogItem[], hid
  */
 export declare const findDeploymentByIdOrReference: (deployments: DeploymentItemDto[], idOrReference: string | null | undefined) => DeploymentItemDto | undefined;
 
+/** Formats a raw `resetsAt` into display strings, or returns `undefined` when it cannot be formatted. */
+declare type FormatResetTime = (resetsAt: string | undefined) => ResetTimeDisplay | undefined;
+
 /**
  * The publish folder a public catalog entity id sits in: the segments between
  * the `public` bucket and the entity name, decoded to the plain text the
@@ -406,8 +431,8 @@ export declare const mapDeploymentDetailsDtoToEntityDetails: (dto: DeploymentDet
 /** Maps a deployment limits DTO to display-ready catalog limits, or `undefined` when no qualifying stats exist. */
 export declare const mapDeploymentLimitsDtoToCatalogLimits: (dto: DeploymentLimitsResponseDto | undefined, labels: DeploymentLimitsLabels) => CatalogItemLimits | undefined;
 
-/** Maps the monthly deployment token limit to a display-ready value. */
-export declare const mapDeploymentLimitsToInput: (dto: DeploymentLimitsResponseDto | undefined) => MonthlyUsageLimit | undefined;
+/** Maps a deployment's day, week, and month token limits and the caller's cost budget to display-ready rows, or `undefined` when none qualify. */
+export declare const mapDeploymentLimitsToInput: (dto: DeploymentLimitsResponseDto | undefined, labels: ConversationInputLimitsLabels, formatResetTime?: FormatResetTime) => CatalogItemLimits | undefined;
 
 /** Maps a deployment listing row into the catalog UI's `CatalogItem` shape. */
 export declare const mapDeploymentToCatalogItem: (deployment: DeploymentItemDto, { favoriteIds, entityDetails, folderLabels, editableSchemaIds, isCustomAppsEditable, activeLocale, primaryLocale, resolveIconUrl, }: MapDeploymentToCatalogItemOptions) => CatalogItem;
@@ -589,18 +614,6 @@ export declare interface ModelSpecification {
     createdAt?: number;
 }
 
-/** Normalized monthly token usage consumed by the conversation input control. */
-export declare interface MonthlyUsageLimit {
-    /** Normalized used-token count. */
-    used: number;
-    /** Configured monthly token limit. */
-    total: number;
-    /** Remaining monthly tokens, clamped to zero. */
-    remaining: number;
-    /** Monthly utilization percentage, clamped to 0–100. */
-    usedPercent: number;
-}
-
 /** A skill resource URL split into the bucket and the path within it. */
 export declare interface ParsedSkillResourceUrl {
     /** DIAL Core bucket name. */
@@ -693,6 +706,23 @@ export declare const readSkillManifest: (response: Response) => Promise<string |
  */
 export declare const reconcileFilterTopics: (persistedTopics: ReadonlySet<string>, items: readonly CatalogItem[]) => Set<string>;
 
+/**
+ * One reset time, already parsed and formatted by the host. Declared
+ * structurally here so this library never imports an application type; the
+ * host passes a value that satisfies this shape (e.g. `apps/chat`'s own
+ * `ResetTimeDisplay`).
+ */
+declare interface ResetTimeDisplay {
+    /** Exclusive end of the period as an epoch ms value, for the host's boundary scheduling. */
+    resetsAtMs: number;
+    /** Machine-readable instant for a `<time dateTime>` attribute. */
+    isoValue: string;
+    /** Visible reset line. */
+    label: string;
+    /** Accessible expansion of the reset line. */
+    ariaLabel: string;
+}
+
 /**
  * Resolves the primary action for a catalog item.
  *

package/index.d.ts

@@ -819,6 +819,28 @@ export declare interface ConversationGenerationLifecycle {
     completeGeneration: (path: string, generationId: string) => void;
 }
 
+/** Labels and formatter callbacks for the conversation-input limits mapping utility. */
+export declare interface ConversationInputLimitsLabels {
+    /** Heading of the group listing the selected deployment's token limits. */
+    tokenGroup: string;
+    /** Heading of the group listing the caller's cost budget, which spans every deployment. */
+    costGroup: string;
+    /** Label for the current-UTC-day row, used by both groups. */
+    periodDay: string;
+    /** Label for the current-UTC-week row, used by both groups. */
+    periodWeek: string;
+    /** Label for the current-UTC-month row, used by both groups. */
+    periodMonth: string;
+    /** Formats the combined used/total display value for a capped row. */
+    formatValueLabel: (used: string, total: string) => string;
+    /** Formats the ARIA label for a capped progress row. */
+    formatProgressAriaLabel: (params: {
+        label: string;
+        used: string;
+        total: string;
+    }) => string;
+}
+
 /** Stable reverse-lookup maps returned by `useConversationLookupMaps`. */
 export declare interface ConversationLookupMaps {
     /** Returns the raw context id for a panel-space conversation id, or `undefined` when not found. */
@@ -2153,8 +2175,8 @@ export declare const mapDeploymentDetailsDtoToEntityDetails: (dto: DeploymentDet
 /** Maps a deployment limits DTO to display-ready catalog limits, or `undefined` when no qualifying stats exist. */
 export declare const mapDeploymentLimitsDtoToCatalogLimits: (dto: DeploymentLimitsResponseDto | undefined, labels: DeploymentLimitsLabels) => CatalogItemLimits | undefined;
 
-/** Maps the monthly deployment token limit to a display-ready value. */
-export declare const mapDeploymentLimitsToInput: (dto: DeploymentLimitsResponseDto | undefined) => MonthlyUsageLimit | undefined;
+/** Maps a deployment's day, week, and month token limits and the caller's cost budget to display-ready rows, or `undefined` when none qualify. */
+export declare const mapDeploymentLimitsToInput: (dto: DeploymentLimitsResponseDto | undefined, labels: ConversationInputLimitsLabels, formatResetTime?: FormatResetTime) => CatalogItemLimits | undefined;
 
 /** Maps a deployment listing row into the catalog UI's `CatalogItem` shape. */
 export declare const mapDeploymentToCatalogItem: (deployment: DeploymentItemDto, { favoriteIds, entityDetails, folderLabels, editableSchemaIds, isCustomAppsEditable, activeLocale, primaryLocale, resolveIconUrl, }: MapDeploymentToCatalogItemOptions) => CatalogItem;
@@ -2601,18 +2623,6 @@ export declare interface ModelSpecification {
     createdAt?: number;
 }
 
-/** Normalized monthly token usage consumed by the conversation input control. */
-export declare interface MonthlyUsageLimit {
-    /** Normalized used-token count. */
-    used: number;
-    /** Configured monthly token limit. */
-    total: number;
-    /** Remaining monthly tokens, clamped to zero. */
-    remaining: number;
-    /** Monthly utilization percentage, clamped to 0–100. */
-    usedPercent: number;
-}
-
 /** Returns a skill relative path's final segment (its display name in the file tree). */
 export declare const nameFromPath: (path: string) => string;
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@epam/ai-dial-chat-hooks",
   "description": "Framework-level React hooks extracted from AI DIAL Chat for building custom chat interfaces",
-  "version": "1.2.0-dev.141",
+  "version": "1.2.0-dev.143",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -111,7 +111,7 @@
     }
   },
   "dependencies": {
-    "@epam/ai-dial-chat-api-client": "1.2.0-dev.141",
+    "@epam/ai-dial-chat-api-client": "1.2.0-dev.143",
     "dompurify": "3.4.15",
     "fflate": "^0.8.3",
     "lru-cache": "^10.4.3",
@@ -120,22 +120,22 @@
   },
   "peerDependencies": {
     "react": "^19.2.8",
-    "@epam/ai-dial-attachment-canvas": "1.2.0-dev.141",
-    "@epam/ai-dial-attachment-input": "1.2.0-dev.141",
-    "@epam/ai-dial-builder-form": "1.2.0-dev.141",
-    "@epam/ai-dial-catalog": "1.2.0-dev.141",
-    "@epam/ai-dial-chat-overlay": "1.2.0-dev.141",
-    "@epam/ai-dial-chat-shared": "1.2.0-dev.141",
-    "@epam/ai-dial-mcp-apps": "1.2.0-dev.141",
-    "@epam/ai-dial-publish-panel": "1.2.0-dev.141",
-    "@epam/ai-dial-quotations": "1.2.0-dev.141",
+    "@epam/ai-dial-attachment-canvas": "1.2.0-dev.143",
+    "@epam/ai-dial-attachment-input": "1.2.0-dev.143",
+    "@epam/ai-dial-builder-form": "1.2.0-dev.143",
+    "@epam/ai-dial-catalog": "1.2.0-dev.143",
+    "@epam/ai-dial-chat-overlay": "1.2.0-dev.143",
+    "@epam/ai-dial-chat-shared": "1.2.0-dev.143",
+    "@epam/ai-dial-mcp-apps": "1.2.0-dev.143",
+    "@epam/ai-dial-publish-panel": "1.2.0-dev.143",
+    "@epam/ai-dial-quotations": "1.2.0-dev.143",
     "@epam/ai-dial-react-file-manager": "^0.3.0-dev.4",
-    "@epam/ai-dial-scheduled-tasks": "1.2.0-dev.141",
-    "@epam/ai-dial-share": "1.2.0-dev.141",
-    "@epam/ai-dial-skill-editor": "1.2.0-dev.141",
-    "@epam/ai-dial-source-panel": "1.2.0-dev.141",
+    "@epam/ai-dial-scheduled-tasks": "1.2.0-dev.143",
+    "@epam/ai-dial-share": "1.2.0-dev.143",
+    "@epam/ai-dial-skill-editor": "1.2.0-dev.143",
+    "@epam/ai-dial-source-panel": "1.2.0-dev.143",
     "@epam/ai-dial-ui-kit": "^0.15.0-dev.18",
-    "@epam/ai-dial-usage-dashboard": "1.2.0-dev.141",
+    "@epam/ai-dial-usage-dashboard": "1.2.0-dev.143",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@epam/pdf-highlighter-kit": "^0.0.19",
     "@mcp-ui/client": "^7.1.1"