@epam/ai-dial-chat-hooks 1.2.0-dev.265 → 1.2.0-dev.266

package/index.d.ts

@@ -1264,6 +1264,8 @@ export declare const deriveFavoriteItems: (items: readonly CatalogItem[]) => Cat
  * Unsupported constraints remain Custom, with the full source expression.
  * Calendar-month shifts crossing month boundaries or days 29–31 remain
  * Custom because a shifted monthly day is not equivalent around short months.
+ * The one exception is `day: 'last'` one day behind local time, which is
+ * exactly the local 1st.
  */
 export declare const describeScheduledTaskTrigger: (trigger: ScheduleTriggerDto, { timeZone, referenceDate, }?: ScheduledTaskTriggerDescriptionOptions) => ScheduledTaskTriggerDescription;
 

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.265",
+  "version": "1.2.0-dev.266",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -111,7 +111,7 @@
     }
   },
   "dependencies": {
-    "@epam/ai-dial-chat-api-client": "1.2.0-dev.265",
+    "@epam/ai-dial-chat-api-client": "1.2.0-dev.266",
     "dompurify": "3.4.16",
     "fflate": "^0.8.3",
     "lru-cache": "^10.4.3",
@@ -120,21 +120,21 @@
   },
   "peerDependencies": {
     "react": "^19.2.8",
-    "@epam/ai-dial-attachment-canvas": "1.2.0-dev.265",
-    "@epam/ai-dial-attachment-input": "1.2.0-dev.265",
-    "@epam/ai-dial-catalog": "1.2.0-dev.265",
-    "@epam/ai-dial-chat-overlay": "1.2.0-dev.265",
-    "@epam/ai-dial-chat-shared": "1.2.0-dev.265",
-    "@epam/ai-dial-mcp-apps": "1.2.0-dev.265",
-    "@epam/ai-dial-publish-panel": "1.2.0-dev.265",
-    "@epam/ai-dial-quotations": "1.2.0-dev.265",
+    "@epam/ai-dial-attachment-canvas": "1.2.0-dev.266",
+    "@epam/ai-dial-attachment-input": "1.2.0-dev.266",
+    "@epam/ai-dial-catalog": "1.2.0-dev.266",
+    "@epam/ai-dial-chat-overlay": "1.2.0-dev.266",
+    "@epam/ai-dial-chat-shared": "1.2.0-dev.266",
+    "@epam/ai-dial-mcp-apps": "1.2.0-dev.266",
+    "@epam/ai-dial-publish-panel": "1.2.0-dev.266",
+    "@epam/ai-dial-quotations": "1.2.0-dev.266",
     "@epam/ai-dial-react-file-manager": "^0.3.0-dev.22",
-    "@epam/ai-dial-scheduled-tasks": "1.2.0-dev.265",
-    "@epam/ai-dial-share": "1.2.0-dev.265",
-    "@epam/ai-dial-skill-editor": "1.2.0-dev.265",
-    "@epam/ai-dial-source-panel": "1.2.0-dev.265",
+    "@epam/ai-dial-scheduled-tasks": "1.2.0-dev.266",
+    "@epam/ai-dial-share": "1.2.0-dev.266",
+    "@epam/ai-dial-skill-editor": "1.2.0-dev.266",
+    "@epam/ai-dial-source-panel": "1.2.0-dev.266",
     "@epam/ai-dial-ui-kit": "^0.15.0-dev.36",
-    "@epam/ai-dial-usage-dashboard": "1.2.0-dev.265",
+    "@epam/ai-dial-usage-dashboard": "1.2.0-dev.266",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@epam/pdf-highlighter-kit": "^0.0.19",
     "@mcp-ui/client": "^7.1.1"

package/scheduled-task/scheduled-task-description.js

@@ -1,20 +1,21 @@
+import { CRON_LAST_DAY_OF_MONTH as e } from "../shared/cron-day-of-month.js";
 //#region src/scheduled-task/scheduled-task-description.ts
-var e = /* @__PURE__ */ function(e) {
+var t = /* @__PURE__ */ function(e) {
 	return e.OneTime = "oneTime", e.Hourly = "hourly", e.EveryNMinutes = "everyNMinutes", e.Daily = "daily", e.Weekly = "weekly", e.Monthly = "monthly", e.Custom = "custom", e.Invalid = "invalid", e;
-}({}), t = (e, { timeZone: t = "UTC", referenceDate: n = /* @__PURE__ */ new Date() } = {}) => {
-	let r = (e, t = {}) => ({
+}({}), n = (t, { timeZone: n = "UTC", referenceDate: r = /* @__PURE__ */ new Date() } = {}) => {
+	let i = (e, t = {}) => ({
 		kind: e,
 		sourceTimezone: "utc",
 		...t
 	});
-	if (e.date && e.cron) return r("invalid");
-	if (e.date) {
-		let t = new Date(e.date);
-		return Number.isNaN(t.getTime()) ? r("invalid") : r("oneTime", { date: t });
+	if (t.date && t.cron) return i("invalid");
+	if (t.date) {
+		let e = new Date(t.date);
+		return Number.isNaN(e.getTime()) ? i("invalid") : i("oneTime", { date: e });
 	}
-	let i = e.cron?.fields;
-	if (!i || Object.keys(i).length === 0) return r("invalid");
-	let a = () => r("custom", { expression: JSON.stringify(i) }), o = {
+	let a = t.cron?.fields;
+	if (!a || Object.keys(a).length === 0) return i("invalid");
+	let o = () => i("custom", { expression: JSON.stringify(a) }), s = {
 		hour: [0, 23],
 		minute: [0, 59],
 		day: [1, 31],
@@ -22,19 +23,19 @@ var e = /* @__PURE__ */ function(e) {
 		month: [1, 12],
 		second: [0, 59]
 	};
-	for (let [e, t] of Object.entries(i)) {
+	for (let [e, t] of Object.entries(a)) {
 		if (t == null) continue;
-		if (!t.trim()) return r("invalid");
-		let n = o[e];
-		if (n && /^-?\d+$/.test(t) && (Number(t) < n[0] || Number(t) > n[1])) return r("invalid");
+		if (!t.trim()) return i("invalid");
+		let n = s[e];
+		if (n && /^-?\d+$/.test(t) && (Number(t) < n[0] || Number(t) > n[1])) return i("invalid");
 		if (e === "second" && t !== "0" || ![
 			"hour",
 			"minute",
 			"day",
 			"day_of_week"
-		].includes(e) && t !== "*" && !(e === "second" && t === "0")) return a();
+		].includes(e) && t !== "*" && !(e === "second" && t === "0")) return o();
 	}
-	let s = i.hour, c = i.minute, l = i.day === "*" ? void 0 : i.day, u = i.day_of_week === "*" ? void 0 : i.day_of_week, d = u ? [
+	let c = a.hour, l = a.minute, u = a.day === "*" ? void 0 : a.day, d = u === e, f = a.day_of_week === "*" ? void 0 : a.day_of_week, p = f ? [
 		"monday",
 		"tuesday",
 		"wednesday",
@@ -42,36 +43,39 @@ var e = /* @__PURE__ */ function(e) {
 		"friday",
 		"saturday",
 		"sunday"
-	].findIndex((e) => e === u.toLowerCase() || e.slice(0, 3) === u.toLowerCase()) : -1, f = d >= 0 ? String(d) : u;
-	if (l && f || l && !/^\d+$/.test(l) || f && !/^\d+$/.test(f)) return a();
-	let p = s == null || s === "*", m = c?.match(/^\*\/(\d+)$/);
-	if (p && m && !l && !f) {
-		let e = Number(m[1]);
-		return e > 0 && e <= 59 ? r("everyNMinutes", { intervalMinutes: e }) : r("invalid");
+	].findIndex((e) => e === f.toLowerCase() || e.slice(0, 3) === f.toLowerCase()) : -1, m = p >= 0 ? String(p) : f;
+	if (u && m || u && !d && !/^\d+$/.test(u) || m && !/^\d+$/.test(m)) return o();
+	let h = c == null || c === "*", g = l?.match(/^\*\/(\d+)$/);
+	if (h && g && !u && !m) {
+		let e = Number(g[1]);
+		return e > 0 && e <= 59 ? i("everyNMinutes", { intervalMinutes: e }) : i("invalid");
 	}
-	if (!c || !/^\d+$/.test(c) || !p && !/^\d+$/.test(s) || p && (l || f)) return a();
-	let h = new Date(n);
-	if (Number.isNaN(h.getTime())) return r("invalid");
-	if (h.setUTCHours(p ? 0 : Number(s), Number(c), 0, 0), f) {
-		let e = (Number(f) + 1) % 7;
-		h.setUTCDate(h.getUTCDate() + (e - h.getUTCDay() + 7) % 7);
+	if (!l || !/^\d+$/.test(l) || !h && !/^\d+$/.test(c) || h && (u || m)) return o();
+	let _ = new Date(r);
+	if (Number.isNaN(_.getTime())) return i("invalid");
+	if (_.setUTCHours(h ? 0 : Number(c), Number(l), 0, 0), m) {
+		let e = (Number(m) + 1) % 7;
+		_.setUTCDate(_.getUTCDate() + (e - _.getUTCDay() + 7) % 7);
 	}
-	let g = new Intl.DateTimeFormat("en-GB", {
-		timeZone: t,
+	let v = new Intl.DateTimeFormat("en-GB", {
+		timeZone: n,
 		hourCycle: "h23",
 		year: "numeric",
 		month: "2-digit",
 		day: "2-digit",
 		hour: "2-digit",
 		minute: "2-digit"
-	}).formatToParts(h), _ = (e) => g.find((t) => t.type === e)?.value ?? "", v = new Date(Date.UTC(Number(_("year")), Number(_("month")) - 1, Number(_("day")))), y = Date.UTC(h.getUTCFullYear(), h.getUTCMonth(), h.getUTCDate()), b = Math.round((v.getTime() - y) / 864e5), x = _("hour") + ":" + _("minute");
-	return p ? r("hourly", { time: _("minute") }) : f ? r("weekly", {
-		time: x,
-		dayOfWeek: String((Number(f) + b + 7) % 7)
-	}) : l ? b === 0 || Number(l) <= 28 && Number(l) + b >= 1 && Number(l) + b <= 28 ? r("monthly", {
-		time: x,
-		dayOfMonth: String(Number(l) + b)
-	}) : a() : r("daily", { time: x });
+	}).formatToParts(_), y = (e) => v.find((t) => t.type === e)?.value ?? "", b = new Date(Date.UTC(Number(y("year")), Number(y("month")) - 1, Number(y("day")))), x = Date.UTC(_.getUTCFullYear(), _.getUTCMonth(), _.getUTCDate()), S = Math.round((b.getTime() - x) / 864e5), C = y("hour") + ":" + y("minute");
+	return h ? i("hourly", { time: y("minute") }) : m ? i("weekly", {
+		time: C,
+		dayOfWeek: String((Number(m) + S + 7) % 7)
+	}) : d ? S === 1 ? i("monthly", {
+		time: C,
+		dayOfMonth: "1"
+	}) : o() : u ? S === 0 || Number(u) <= 28 && Number(u) + S >= 1 && Number(u) + S <= 28 ? i("monthly", {
+		time: C,
+		dayOfMonth: String(Number(u) + S)
+	}) : o() : i("daily", { time: C });
 };
 //#endregion
-export { e as ScheduledTaskTriggerDescriptionKind, t as describeScheduledTaskTrigger };
+export { t as ScheduledTaskTriggerDescriptionKind, n as describeScheduledTaskTrigger };

package/scheduled-task/scheduled-task-trigger.js

@@ -1,41 +1,42 @@
 import { padTwoDigits as e } from "../shared/formatting.js";
 import { UnsupportedTriggerReason as t } from "./scheduled-task-mapping.js";
-import { apSchedulerDayToJsDay as n, jsDayToApSchedulerDay as r } from "../shared/cron-weekday.js";
-import { ScheduledTaskRepeat as i } from "@epam/ai-dial-scheduled-tasks";
+import { getUtcDayShift as n, toLocalDayOfMonth as r, toUtcCronDayOfMonth as i } from "../shared/cron-day-of-month.js";
+import { apSchedulerDayToJsDay as a, jsDayToApSchedulerDay as o } from "../shared/cron-weekday.js";
+import { ScheduledTaskRepeat as s } from "@epam/ai-dial-scheduled-tasks";
 //#region src/scheduled-task/scheduled-task-trigger.ts
-var a = new Set([
+var c = new Set([
 	"hour",
 	"minute",
 	"day_of_week",
 	"day"
-]), o = "09:00", s = (e) => {
-	if (e.repeat === i.Hourly) {
+]), l = "09:00", u = (e) => {
+	if (e.repeat === s.Hourly) {
 		let t = /* @__PURE__ */ new Date();
 		return t.setHours(0, Number(e.minute), 0, 0), {
 			hour: "*",
 			minute: String(t.getUTCMinutes())
 		};
 	}
-	let [t, a] = e.time.split(":"), o = Number(t), s = Number(a), c = /* @__PURE__ */ new Date();
-	c.setHours(o, s, 0, 0);
-	let l = e.repeat === i.Weekly && !!e.dayOfWeek, u = e.repeat === i.Monthly && !!e.dayOfMonth;
-	if (l) {
-		let t = (n(Number(e.dayOfWeek)) - c.getDay() + 7) % 7;
-		c.setDate(c.getDate() + t);
-	} else u && c.setDate(Number(e.dayOfMonth));
-	let d = {
-		hour: String(c.getUTCHours()),
-		minute: String(c.getUTCMinutes())
+	let [t, r] = e.time.split(":"), c = Number(t), l = Number(r), u = /* @__PURE__ */ new Date();
+	u.setHours(c, l, 0, 0);
+	let d = e.repeat === s.Weekly && !!e.dayOfWeek, f = e.repeat === s.Monthly && !!e.dayOfMonth;
+	if (d) {
+		let t = (a(Number(e.dayOfWeek)) - u.getDay() + 7) % 7;
+		u.setDate(u.getDate() + t);
+	}
+	let p = {
+		hour: String(u.getUTCHours()),
+		minute: String(u.getUTCMinutes())
 	};
-	return l && (d.day_of_week = String(r(c.getUTCDay()))), u && (d.day = String(c.getUTCDate())), d;
-}, c = (e, t) => {
+	return d && (p.day_of_week = String(o(u.getUTCDay()))), f && (p.day = i(Number(e.dayOfMonth), n(u))), p;
+}, d = (e, t) => {
 	let [n, r, i] = e.split("-").map(Number), a = new Date(n, r - 1, i);
 	return t === "start" ? a.setHours(0, 0, 0, 0) : a.setHours(23, 59, 59, 999), a.toISOString();
-}, l = (e) => {
-	let t = e.repeat === i.OneTime ? { date: new Date(e.runAt ?? "").toISOString() } : { cron: {
-		fields: s(e),
-		...e.startDate ? { startDate: c(e.startDate, "start") } : {},
-		...e.endDate ? { endDate: c(e.endDate, "end") } : {}
+}, f = (e) => {
+	let t = e.repeat === s.OneTime ? { date: new Date(e.runAt ?? "").toISOString() } : { cron: {
+		fields: u(e),
+		...e.startDate ? { startDate: d(e.startDate, "start") } : {},
+		...e.endDate ? { endDate: d(e.endDate, "end") } : {}
 	} }, n = e.description?.trim();
 	return {
 		displayName: e.displayName.trim(),
@@ -45,19 +46,19 @@ var a = new Set([
 		...e.skillUrl ? { skillUrl: e.skillUrl } : {},
 		...n ? { description: n } : {}
 	};
-}, u = (e) => ({
-	...l(e),
+}, p = (e) => ({
+	...f(e),
 	skillUrl: e.skillUrl || null
-}), d = (t) => {
+}), m = (t) => {
 	let n = new Date(t);
 	return `${n.getFullYear()}-${e(n.getMonth() + 1)}-${e(n.getDate())}T${e(n.getHours())}:${e(n.getMinutes())}`;
-}, f = (t) => {
+}, h = (t) => {
 	let n = new Date(t);
 	return `${n.getFullYear()}-${e(n.getMonth() + 1)}-${e(n.getDate())}`;
-}, p = (t) => {
-	let i = new Set(Object.entries(t).filter(([, e]) => e != null).map(([e]) => e)), o = [...i].filter((e) => !a.has(e)), s = i.has("day_of_week"), c = i.has("day");
-	if (o.length > 0 || s && c || !i.has("hour") || !i.has("minute")) return { ok: !1 };
-	if (t.hour === "*" && /^\d+$/.test(String(t.minute)) && !s && !c) {
+}, g = (t) => {
+	let i = new Set(Object.entries(t).filter(([, e]) => e != null).map(([e]) => e)), s = [...i].filter((e) => !c.has(e)), l = i.has("day_of_week"), u = i.has("day");
+	if (s.length > 0 || l && u || !i.has("hour") || !i.has("minute")) return { ok: !1 };
+	if (t.hour === "*" && /^\d+$/.test(String(t.minute)) && !l && !u) {
 		let e = /* @__PURE__ */ new Date();
 		return e.setUTCHours(0, Number(t.minute), 0, 0), {
 			ok: !0,
@@ -65,85 +66,82 @@ var a = new Set([
 			minute: String(e.getMinutes())
 		};
 	}
-	let l = Number(t.hour), u = Number(t.minute);
-	if (Number.isNaN(l) || Number.isNaN(u)) return { ok: !1 };
-	let d = /* @__PURE__ */ new Date();
-	if (d.setUTCHours(l, u, 0, 0), s) {
+	let d = Number(t.hour), f = Number(t.minute);
+	if (Number.isNaN(d) || Number.isNaN(f)) return { ok: !1 };
+	let p = /* @__PURE__ */ new Date();
+	if (p.setUTCHours(d, f, 0, 0), l) {
 		let e = Number(t.day_of_week);
 		if (Number.isNaN(e)) return { ok: !1 };
-		let r = (n(e) - d.getUTCDay() + 7) % 7;
-		d.setUTCDate(d.getUTCDate() + r);
-	} else if (c) {
-		let e = Number(t.day);
-		if (Number.isNaN(e)) return { ok: !1 };
-		d.setUTCDate(e);
+		let n = (a(e) - p.getUTCDay() + 7) % 7;
+		p.setUTCDate(p.getUTCDate() + n);
 	}
-	return {
+	let m = u ? r(String(t.day), n(p)) : void 0;
+	return u && !m ? { ok: !1 } : {
 		ok: !0,
 		isHourly: !1,
-		time: `${e(d.getHours())}:${e(d.getMinutes())}`,
-		...s ? { dayOfWeek: String(r(d.getDay())) } : {},
-		...c ? { dayOfMonth: String(d.getDate()) } : {}
+		time: `${e(p.getHours())}:${e(p.getMinutes())}`,
+		...l ? { dayOfWeek: String(o(p.getDay())) } : {},
+		...m ? { dayOfMonth: m } : {}
 	};
-}, m = (e) => {
+}, _ = (e) => {
 	if (!e.model || typeof e.prompt != "string" || !e.prompt.trim() && !e.skillUrl) return {
 		ok: !1,
 		reason: t.MissingRequiredFields
 	};
-	let { date: n, cron: r } = e.trigger, a = !!n;
-	if (a === !!r) return {
+	let { date: n, cron: r } = e.trigger, i = !!n;
+	if (i === !!r) return {
 		ok: !1,
 		reason: t.UnsupportedTriggerType
 	};
-	let s = {
+	let a = {
 		displayName: e.displayName,
 		modelId: e.model,
 		prompt: e.prompt,
 		...e.skillUrl ? { skillUrl: e.skillUrl } : {},
 		...e.description ? { description: e.description } : {}
 	};
-	if (a) return {
+	if (i) return {
 		ok: !0,
 		values: {
-			...s,
-			repeat: i.OneTime,
-			runAt: d(n),
-			time: o
+			...a,
+			repeat: s.OneTime,
+			runAt: m(n),
+			time: l
 		}
 	};
 	if (!r) return {
 		ok: !1,
 		reason: t.UnsupportedTriggerType
 	};
-	let c = p(r.fields);
-	if (!c.ok) return {
+	let o = g(r.fields);
+	if (!o.ok) return {
 		ok: !1,
 		reason: t.UnsupportedCronShape
 	};
-	if (c.isHourly) return {
+	if (o.isHourly) return {
 		ok: !0,
 		values: {
-			...s,
-			repeat: i.Hourly,
-			time: o,
-			minute: c.minute,
-			...r.startDate ? { startDate: f(r.startDate) } : {},
-			...r.endDate ? { endDate: f(r.endDate) } : {}
+			...a,
+			repeat: s.Hourly,
+			time: l,
+			minute: o.minute,
+			...r.startDate ? { startDate: h(r.startDate) } : {},
+			...r.endDate ? { endDate: h(r.endDate) } : {}
 		}
 	};
-	let l = i.Daily;
-	return c.dayOfWeek ? l = i.Weekly : c.dayOfMonth && (l = i.Monthly), {
+	let c = s.Daily;
+	return o.dayOfWeek ? c = s.Weekly : o.dayOfMonth && (c = s.Monthly), {
 		ok: !0,
 		values: {
-			...s,
-			repeat: l,
-			time: c.time,
-			...c.dayOfWeek ? { dayOfWeek: c.dayOfWeek } : {},
-			...c.dayOfMonth ? { dayOfMonth: c.dayOfMonth } : {},
-			...r.startDate ? { startDate: f(r.startDate) } : {},
-			...r.endDate ? { endDate: f(r.endDate) } : {}
+			...a,
+			repeat: c,
+			time: o.time,
+			...o.dayOfWeek ? { dayOfWeek: o.dayOfWeek } : {},
+			...o.dayOfMonth ? { dayOfMonth: o.dayOfMonth } : {},
+			...r.startDate ? { startDate: h(r.startDate) } : {},
+			...r.endDate ? { endDate: h(r.endDate) } : {}
 		}
 	};
 };
 //#endregion
-export { l as mapFormValuesToCreateBody, u as mapFormValuesToUpdateBody, m as mapScheduledTaskDtoToFormValues };
+export { f as mapFormValuesToCreateBody, p as mapFormValuesToUpdateBody, _ as mapScheduledTaskDtoToFormValues };

package/scheduled-tasks.d.ts

@@ -25,6 +25,8 @@ export declare const createScheduledTasksApiClient: (client: ScheduledTasksConfi
  * Unsupported constraints remain Custom, with the full source expression.
  * Calendar-month shifts crossing month boundaries or days 29–31 remain
  * Custom because a shifted monthly day is not equivalent around short months.
+ * The one exception is `day: 'last'` one day behind local time, which is
+ * exactly the local 1st.
  */
 export declare const describeScheduledTaskTrigger: (trigger: ScheduleTriggerDto, { timeZone, referenceDate, }?: ScheduledTaskTriggerDescriptionOptions) => ScheduledTaskTriggerDescription;
 

package/shared/cron-day-of-month.js

@@ -0,0 +1,13 @@
+//#region src/shared/cron-day-of-month.ts
+var e = "last", t = 31, n = 864e5, r = (e) => Math.round((Date.UTC(e.getUTCFullYear(), e.getUTCMonth(), e.getUTCDate()) - Date.UTC(e.getFullYear(), e.getMonth(), e.getDate())) / n), i = (n, r) => {
+	let i = n + r;
+	return i < 1 ? e : i > t ? "1" : String(i);
+}, a = (e, n) => {
+	if (e === "last") return n === -1 ? "1" : void 0;
+	let r = Number(e);
+	if (!/^\d+$/.test(e) || r < 1 || r > t) return;
+	let i = r - n;
+	return i < 1 ? String(t) : i > t ? "1" : String(i);
+};
+//#endregion
+export { e as CRON_LAST_DAY_OF_MONTH, r as getUtcDayShift, a as toLocalDayOfMonth, i as toUtcCronDayOfMonth };