@epam/ai-dial-chat-hooks 1.3.0-dev.28 → 1.3.0-dev.282

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

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

package/scheduled-task/scheduled-task-mapping.d.ts

@@ -0,0 +1,19 @@
+import { ScheduledTaskCreateFormValues } from '@epam/ai-dial-scheduled-tasks';
+/** Why a scheduled task DTO could not be mapped back to editable form values. */
+export declare enum UnsupportedTriggerReason {
+    /** `trigger.cron.fields` uses a shape (extra keys, or both `day_of_week` and `day`) the editor's schedule controls cannot represent. */
+    UnsupportedCronShape = "unsupportedCronShape",
+    /** Neither or both of `trigger.date`/`trigger.cron` are set, so the schedule type cannot be determined. */
+    UnsupportedTriggerType = "unsupportedTriggerType",
+    /** The task is missing `model` or `prompt`, so it cannot be represented as a valid update payload. */
+    MissingRequiredFields = "missingRequiredFields"
+}
+/** Result of mapping a scheduled task DTO back to editable form values. */
+export type ScheduledTaskDtoMappingResult = {
+    ok: true;
+    values: ScheduledTaskCreateFormValues;
+} | {
+    ok: false;
+    reason: UnsupportedTriggerReason;
+};
+//# sourceMappingURL=scheduled-task-mapping.d.ts.map

package/scheduled-task/scheduled-task-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-task-mapping.d.ts","sourceRoot":"","sources":["../../src/scheduled-task/scheduled-task-mapping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAEnF,iFAAiF;AACjF,oBAAY,wBAAwB;IAClC,wIAAwI;IACxI,oBAAoB,yBAAyB;IAC7C,2GAA2G;IAC3G,sBAAsB,2BAA2B;IACjD,sGAAsG;IACtG,qBAAqB,0BAA0B;CAChD;AAED,2EAA2E;AAC3E,MAAM,MAAM,6BAA6B,GACrC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,6BAA6B,CAAA;CAAE,GACnD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,wBAAwB,CAAA;CAAE,CAAC"}

package/scheduled-task/scheduled-task-next-occurrence.d.ts

@@ -0,0 +1,9 @@
+import { ScheduleCronDto } from '@epam/ai-dial-chat-api-client';
+/**
+ * Returns the next UTC time at which a cron trigger with a fixed
+ * `hour`/`minute` fires, honouring its `day_of_week` (Weekly) or `day`
+ * (Monthly) constraint. Returns `undefined` when the fields are not plain
+ * values this helper can evaluate.
+ */
+export declare const getNextCronOccurrence: (cron: ScheduleCronDto, from?: Date) => Date | undefined;
+//# sourceMappingURL=scheduled-task-next-occurrence.d.ts.map

package/scheduled-task/scheduled-task-next-occurrence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-task-next-occurrence.d.ts","sourceRoot":"","sources":["../../src/scheduled-task/scheduled-task-next-occurrence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AA2BrE;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAChC,MAAM,eAAe,EACrB,OAAM,IAAiB,KACtB,IAAI,GAAG,SA4BT,CAAC"}

package/scheduled-task/scheduled-task-next-occurrence.js

@@ -0,0 +1,20 @@
+//#region src/scheduled-task/scheduled-task-next-occurrence.ts
+var e = "last", t = /^\d+$/, n = (t, n, r) => {
+	if (n != null) return (Number(n) + 1) % 7 === t.getUTCDay();
+	if (r === e) {
+		let e = new Date(t);
+		return e.setUTCDate(t.getUTCDate() + 1), e.getUTCDate() === 1;
+	}
+	return r == null || Number(r) === t.getUTCDate();
+}, r = (r, i = /* @__PURE__ */ new Date()) => {
+	let { hour: a, minute: o, day_of_week: s, day: c } = r.fields;
+	if (!a || !o || !t.test(a) || !t.test(o) || s != null && !/^[0-6]$/.test(s) || c != null && c !== e && !t.test(c)) return;
+	let l = new Date(i);
+	l.setUTCHours(Number(a), Number(o), 0, 0);
+	for (let e = 0; e <= 366; e++) {
+		if (l > i && n(l, s, c)) return l;
+		l.setUTCDate(l.getUTCDate() + 1);
+	}
+};
+//#endregion
+export { r as getNextCronOccurrence };

package/scheduled-task/scheduled-task-preparation.d.ts

@@ -0,0 +1,19 @@
+import { CreateScheduledTaskBodyDto, UpdateScheduledTaskBodyDto } from '@epam/ai-dial-chat-api-client';
+import { ScheduledTaskCreateFormValues } from '@epam/ai-dial-scheduled-tasks';
+import { ScheduledTaskValidationErrors, ScheduledTaskValidationOptions } from '@epam/ai-dial-scheduled-tasks/validation';
+/** A checked request preparation result that never serializes invalid values. */
+export type ScheduledTaskPreparationResult<TBody> = {
+    ok: true;
+    body: TBody;
+} | {
+    ok: false;
+    errors: ScheduledTaskValidationErrors;
+};
+/**
+ * Validates form values before creating a request body. Hosts translate the
+ * returned field codes and must not issue a write when `ok` is false.
+ */
+export declare const prepareScheduledTaskCreateBody: (values: ScheduledTaskCreateFormValues, options: ScheduledTaskValidationOptions) => ScheduledTaskPreparationResult<CreateScheduledTaskBodyDto>;
+/** Validates form values before preparing an update request body. */
+export declare const prepareScheduledTaskUpdateBody: (values: ScheduledTaskCreateFormValues, options: ScheduledTaskValidationOptions) => ScheduledTaskPreparationResult<UpdateScheduledTaskBodyDto>;
+//# sourceMappingURL=scheduled-task-preparation.d.ts.map

package/scheduled-task/scheduled-task-preparation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-task-preparation.d.ts","sourceRoot":"","sources":["../../src/scheduled-task/scheduled-task-preparation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAEL,KAAK,6BAA6B,EAClC,KAAK,8BAA8B,EACpC,MAAM,0CAA0C,CAAC;AAMlD,iFAAiF;AACjF,MAAM,MAAM,8BAA8B,CAAC,KAAK,IAC5C;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,KAAK,CAAA;CAAE,GACzB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,6BAA6B,CAAA;CAAE,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,8BAA8B,GACzC,QAAQ,6BAA6B,EACrC,SAAS,8BAA8B,KACtC,8BAA8B,CAAC,0BAA0B,CAK3D,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,8BAA8B,GACzC,QAAQ,6BAA6B,EACrC,SAAS,8BAA8B,KACtC,8BAA8B,CAAC,0BAA0B,CAK3D,CAAC"}

package/scheduled-task/scheduled-task-trigger.d.ts

@@ -0,0 +1,26 @@
+import { CreateScheduledTaskBodyDto, ScheduledTaskDto, UpdateScheduledTaskBodyDto } from '@epam/ai-dial-chat-api-client';
+import { ScheduledTaskCreateFormValues } from '@epam/ai-dial-scheduled-tasks';
+import { ScheduledTaskDtoMappingResult } from './scheduled-task-mapping';
+/**
+ * Maps validated create-form values to the `POST /api/v1/scheduled-tasks`
+ * request body, building `trigger.date` for a one-shot schedule or
+ * `trigger.cron.fields` for a recurring one. Assumes the caller has already
+ * validated required fields (name, model, prompt, and the active schedule
+ * section's fields) — this function does not re-validate.
+ */
+export declare const mapFormValuesToCreateBody: (values: ScheduledTaskCreateFormValues) => CreateScheduledTaskBodyDto;
+/**
+ * Maps a complete, validated edit draft to an update body. An unset skill
+ * emits null to remove the saved reference; hydrate from detail before editing.
+ */
+export declare const mapFormValuesToUpdateBody: (values: ScheduledTaskCreateFormValues) => UpdateScheduledTaskBodyDto;
+/**
+ * Attempts to map a {@link ScheduledTaskDto} back to editable
+ * {@link ScheduledTaskCreateFormValues}, inverting {@link buildCronFields}/
+ * {@link buildCronWindowBoundary}. Fails closed — returning a reason instead
+ * of a value — whenever the task's trigger or required fields cannot be
+ * represented losslessly by the editor, so an unsupported schedule is never
+ * silently coerced and re-submitted.
+ */
+export declare const mapScheduledTaskDtoToFormValues: (dto: ScheduledTaskDto) => ScheduledTaskDtoMappingResult;
+//# sourceMappingURL=scheduled-task-trigger.d.ts.map

package/scheduled-task/scheduled-task-trigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-task-trigger.d.ts","sourceRoot":"","sources":["../../src/scheduled-task/scheduled-task-trigger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,0BAA0B,EAC1B,gBAAgB,EAEhB,0BAA0B,EAC3B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,6BAA6B,EAE9B,MAAM,+BAA+B,CAAC;AAWvC,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,0BAA0B,CAAC;AAuHlC;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GACpC,QAAQ,6BAA6B,KACpC,0BAwCF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GACpC,QAAQ,6BAA6B,KACpC,0BAGD,CAAC;AAsKH;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B,GAC1C,KAAK,gBAAgB,KACpB,6BAoHF,CAAC"}

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

@@ -4,12 +4,12 @@ import { getUtcDayShift as n, toLocalDayOfMonth as r, toUtcCronDayOfMonth as i }
 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 c = new Set([
+var c = /* @__PURE__ */ new Set([
 	"hour",
 	"minute",
 	"day_of_week",
 	"day"
-]), l = "09:00", u = (e) => {
+]), l = /^\*\/(10|[1-9])$/, u = "09:00", d = (e) => {
 	if (e.repeat === s.Hourly) {
 		let t = /* @__PURE__ */ new Date();
 		return t.setHours(0, Number(e.minute), 0, 0), {
@@ -19,7 +19,7 @@ var c = new Set([
 	}
 	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;
+	let d = (e.repeat === s.Weekly || e.repeat === s.Custom) && !!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);
@@ -28,15 +28,15 @@ var c = new Set([
 		hour: String(u.getUTCHours()),
 		minute: String(u.getUTCMinutes())
 	};
-	return d && (p.day_of_week = String(o(u.getUTCDay()))), f && (p.day = i(Number(e.dayOfMonth), n(u))), p;
-}, d = (e, t) => {
+	return d && (p.day_of_week = String(o(u.getUTCDay()))), f && (p.day = i(Number(e.dayOfMonth), n(u))), e.repeat === s.Custom && (p.week = `*/${e.everyWeeks ?? "1"}`), p;
+}, f = (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();
-}, f = (e) => {
+}, p = (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") } : {}
+		fields: d(e),
+		...e.repeat !== s.Custom && e.startDate ? { startDate: f(e.startDate, "start") } : {},
+		...e.repeat !== s.Custom && e.endDate ? { endDate: f(e.endDate, "end") } : {}
 	} }, n = e.description?.trim();
 	return {
 		displayName: e.displayName.trim(),
@@ -46,19 +46,36 @@ var c = new Set([
 		...e.skillUrls?.length ? { skillUrls: [...new Set(e.skillUrls)] } : {},
 		...n ? { description: n } : {}
 	};
-}, p = (e) => ({
-	...f(e),
+}, m = (e) => ({
+	...p(e),
 	skillUrls: [...new Set(e.skillUrls ?? [])]
-}), m = (t) => {
+}), h = (t) => {
 	let n = new Date(t);
 	return `${n.getFullYear()}-${e(n.getMonth() + 1)}-${e(n.getDate())}T${e(n.getHours())}:${e(n.getMinutes())}`;
-}, h = (t) => {
+}, g = (t) => {
 	let n = new Date(t);
 	return `${n.getFullYear()}-${e(n.getMonth() + 1)}-${e(n.getDate())}`;
-}, 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) {
+}, _ = (t) => {
+	let i = new Set(Object.entries(t).filter(([, e]) => e != null).map(([e]) => e)), s = [...i].filter((e) => !c.has(e)), u = i.has("day_of_week"), d = i.has("day");
+	if (i.has("week")) {
+		let n = t.week?.match(l);
+		if (n && s.every((e) => e === "week") && u && !d && /^\d+$/.test(String(t.day_of_week)) && /^\d+$/.test(String(t.hour)) && /^\d+$/.test(String(t.minute))) {
+			let r = Number(t.hour), i = Number(t.minute), s = Number(t.day_of_week), c = /* @__PURE__ */ new Date();
+			c.setUTCHours(r, i, 0, 0);
+			let l = (a(s) - c.getUTCDay() + 7) % 7;
+			return c.setUTCDate(c.getUTCDate() + l), {
+				ok: !0,
+				isHourly: !1,
+				isCustom: !0,
+				everyWeeks: n[1],
+				time: `${e(c.getHours())}:${e(c.getMinutes())}`,
+				dayOfWeek: String(o(c.getDay()))
+			};
+		}
+		return { ok: !1 };
+	}
+	if (s.length > 0 || u && d || !i.has("hour") || !i.has("minute")) return { ok: !1 };
+	if (t.hour === "*" && /^\d+$/.test(String(t.minute)) && !u && !d) {
 		let e = /* @__PURE__ */ new Date();
 		return e.setUTCHours(0, Number(t.minute), 0, 0), {
 			ok: !0,
@@ -66,24 +83,24 @@ var c = new Set([
 			minute: String(e.getMinutes())
 		};
 	}
-	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 f = Number(t.hour), p = Number(t.minute);
+	if (Number.isNaN(f) || Number.isNaN(p)) return { ok: !1 };
+	let m = /* @__PURE__ */ new Date();
+	if (m.setUTCHours(f, p, 0, 0), u) {
 		let e = Number(t.day_of_week);
 		if (Number.isNaN(e)) return { ok: !1 };
-		let n = (a(e) - p.getUTCDay() + 7) % 7;
-		p.setUTCDate(p.getUTCDate() + n);
+		let n = (a(e) - m.getUTCDay() + 7) % 7;
+		m.setUTCDate(m.getUTCDate() + n);
 	}
-	let m = u ? r(String(t.day), n(p)) : void 0;
-	return u && !m ? { ok: !1 } : {
+	let h = d ? r(String(t.day), n(m)) : void 0;
+	return d && !h ? { ok: !1 } : {
 		ok: !0,
 		isHourly: !1,
-		time: `${e(p.getHours())}:${e(p.getMinutes())}`,
-		...l ? { dayOfWeek: String(o(p.getDay())) } : {},
-		...m ? { dayOfMonth: m } : {}
+		time: `${e(m.getHours())}:${e(m.getMinutes())}`,
+		...u ? { dayOfWeek: String(o(m.getDay())) } : {},
+		...h ? { dayOfMonth: h } : {}
 	};
-}, _ = (e) => {
+}, v = (e) => {
 	if (!e.model || typeof e.prompt != "string" || !e.prompt.trim() && !e.skillUrls?.length) return {
 		ok: !1,
 		reason: t.MissingRequiredFields
@@ -105,15 +122,15 @@ var c = new Set([
 		values: {
 			...a,
 			repeat: s.OneTime,
-			runAt: m(n),
-			time: l
+			runAt: h(n),
+			time: u
 		}
 	};
 	if (!r) return {
 		ok: !1,
 		reason: t.UnsupportedTriggerType
 	};
-	let o = g(r.fields);
+	let o = _(r.fields);
 	if (!o.ok) return {
 		ok: !1,
 		reason: t.UnsupportedCronShape
@@ -123,10 +140,23 @@ var c = new Set([
 		values: {
 			...a,
 			repeat: s.Hourly,
-			time: l,
+			time: u,
 			minute: o.minute,
-			...r.startDate ? { startDate: h(r.startDate) } : {},
-			...r.endDate ? { endDate: h(r.endDate) } : {}
+			...r.startDate ? { startDate: g(r.startDate) } : {},
+			...r.endDate ? { endDate: g(r.endDate) } : {}
+		}
+	};
+	if (o.isCustom) return r.startDate || r.endDate ? {
+		ok: !1,
+		reason: t.UnsupportedCronShape
+	} : {
+		ok: !0,
+		values: {
+			...a,
+			repeat: s.Custom,
+			time: o.time,
+			everyWeeks: o.everyWeeks,
+			dayOfWeek: o.dayOfWeek
 		}
 	};
 	let c = s.Daily;
@@ -138,10 +168,10 @@ var c = new Set([
 			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) } : {}
+			...r.startDate ? { startDate: g(r.startDate) } : {},
+			...r.endDate ? { endDate: g(r.endDate) } : {}
 		}
 	};
 };
 //#endregion
-export { f as mapFormValuesToCreateBody, p as mapFormValuesToUpdateBody, _ as mapScheduledTaskDtoToFormValues };
+export { p as mapFormValuesToCreateBody, m as mapFormValuesToUpdateBody, v as mapScheduledTaskDtoToFormValues };

package/scheduled-task/scheduled-tasks-api-client.d.ts

@@ -0,0 +1,67 @@
+import { CreateScheduledTaskBodyDto, CreatedScheduledTaskDto, ListScheduledTaskRunsResponseDto, ListScheduledTasksResponseDto, ListScheduledTasksSortEnum, ScheduledTaskDto, UpdateScheduledTaskBodyDto, UpdatedScheduledTaskDto } from '@epam/ai-dial-chat-api-client';
+/** Narrow configured generated-client surface required by scheduler hooks. */
+export interface ScheduledTasksConfiguredClient {
+    listScheduledTasks: (request: {
+        limit?: number;
+        offset?: number;
+        search?: string;
+        sort?: ListScheduledTasksSortEnum;
+        model?: string;
+    }, options?: RequestInit) => Promise<ListScheduledTasksResponseDto>;
+    listScheduledTaskRuns: (request: {
+        scheduleId: string;
+        limit?: number;
+        offset?: number;
+    }, options?: RequestInit) => Promise<ListScheduledTaskRunsResponseDto>;
+    createScheduledTask: (request: {
+        createScheduledTaskBodyDto: CreateScheduledTaskBodyDto;
+    }) => Promise<CreatedScheduledTaskDto>;
+    getScheduledTask: (request: {
+        scheduleId: string;
+    }) => Promise<ScheduledTaskDto>;
+    updateScheduledTask: (request: {
+        scheduleId: string;
+        updateScheduledTaskBodyDto: UpdateScheduledTaskBodyDto;
+    }) => Promise<UpdatedScheduledTaskDto>;
+    pauseScheduledTask: (request: {
+        scheduleId: string;
+    }) => Promise<ScheduledTaskDto>;
+    resumeScheduledTask: (request: {
+        scheduleId: string;
+    }) => Promise<ScheduledTaskDto>;
+    deleteScheduledTask: (request: {
+        scheduleId: string;
+    }) => Promise<void>;
+}
+/** App-agnostic request options accepted by the scheduler facade. */
+export interface ScheduledTasksListRequest {
+    limit?: number;
+    offset?: number;
+    search?: string;
+    sort?: ListScheduledTasksSortEnum;
+    /** Only tasks that run against this model/application id, exactly as stored. */
+    model?: string;
+    signal?: AbortSignal;
+}
+export interface ScheduledTaskRunsListRequest {
+    scheduleId: string;
+    limit?: number;
+    offset?: number;
+    signal?: AbortSignal;
+}
+export interface ScheduledTasksApiClient {
+    listScheduledTasks: (request?: ScheduledTasksListRequest) => Promise<ListScheduledTasksResponseDto>;
+    listScheduledTaskRuns: (request: ScheduledTaskRunsListRequest) => Promise<ListScheduledTaskRunsResponseDto>;
+    createScheduledTask: (body: CreateScheduledTaskBodyDto) => Promise<CreatedScheduledTaskDto>;
+    getScheduledTask: (scheduleId: string) => Promise<ScheduledTaskDto>;
+    updateScheduledTask: (scheduleId: string, body: UpdateScheduledTaskBodyDto) => Promise<UpdatedScheduledTaskDto>;
+    pauseScheduledTask: (scheduleId: string) => Promise<ScheduledTaskDto>;
+    resumeScheduledTask: (scheduleId: string) => Promise<ScheduledTaskDto>;
+    deleteScheduledTask: (scheduleId: string) => Promise<void>;
+}
+/**
+ * Composes scheduler operations over an already configured generated client.
+ * Authentication, base URL, CSRF, and retries remain host responsibilities.
+ */
+export declare const createScheduledTasksApiClient: (client: ScheduledTasksConfiguredClient) => ScheduledTasksApiClient;
+//# sourceMappingURL=scheduled-tasks-api-client.d.ts.map

package/scheduled-task/scheduled-tasks-api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-tasks-api-client.d.ts","sourceRoot":"","sources":["../../src/scheduled-task/scheduled-tasks-api-client.ts"],"names":[],"mappings":"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"}

package/scheduled-task/use-scheduled-task-runs.d.ts

@@ -0,0 +1,40 @@
+import { ScheduledTaskRunDto } from '@epam/ai-dial-chat-api-client';
+import { ScheduledTasksApiClient } from './scheduled-tasks-api-client';
+export interface UseScheduledTaskRunsOptions {
+    scheduleId: string;
+    enabled?: boolean;
+    pageSize?: number;
+    /**
+     * The task's next scheduled run time (ISO string), when known. Drives the
+     * one-shot background refresh described on {@link useScheduledTaskRuns}.
+     * The caller already holds the task DTO — this hook never fetches it.
+     */
+    nextRunTime?: string | null;
+    /**
+     * Keeps the 15s background poll running even when no loaded run is
+     * `InProgress`. For a run the caller started itself and tracks outside this
+     * hook, which the first poll then merges into `items`.
+     */
+    pollWhileActive?: boolean;
+}
+/**
+ * Merges a freshly-fetched page 0 into the currently-loaded run list: an
+ * already-known id is replaced in place at its existing array position, an
+ * unseen id is prepended (upstream order is `created_at desc`, so it is the
+ * newest), and an id absent from `incoming` is left untouched — a background
+ * refresh never removes a loaded run.
+ */
+export declare const mergeRunsById: (current: ScheduledTaskRunDto[], incoming: ScheduledTaskRunDto[]) => ScheduledTaskRunDto[];
+/** Shared, cancellation-safe pagination and background refresh for one schedule's run history. */
+export declare const useScheduledTaskRuns: (client: ScheduledTasksApiClient, { scheduleId, enabled, pageSize, nextRunTime, pollWhileActive, }: UseScheduledTaskRunsOptions) => {
+    items: ScheduledTaskRunDto[];
+    isLoading: boolean;
+    isLoadingMore: boolean;
+    initialError: Error | null;
+    loadMoreError: Error | null;
+    hasMore: boolean;
+    loadMore: () => void;
+    retryLoadMore: () => void;
+    refetch: () => void;
+};
+//# sourceMappingURL=use-scheduled-task-runs.d.ts.map

package/scheduled-task/use-scheduled-task-runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-scheduled-task-runs.d.ts","sourceRoot":"","sources":["../../src/scheduled-task/use-scheduled-task-runs.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAE5E,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAoCD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GACxB,SAAS,mBAAmB,EAAE,EAC9B,UAAU,mBAAmB,EAAE,KAC9B,mBAAmB,EAMrB,CAAC;AA0BF,kGAAkG;AAClG,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,uBAAuB,EAC/B,kEAMG,2BAA2B;;;;;;;;;;CA4U/B,CAAC"}