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

package/scheduled-task/use-scheduled-task-runs.js

@@ -1,7 +1,7 @@
 import { useCallback as e, useEffect as t, useRef as n, useState as r } from "react";
 import { ScheduledTaskRunDtoStatusEnum as i } from "@epam/ai-dial-chat-api-client";
 //#region src/scheduled-task/use-scheduled-task-runs.ts
-var a = 15e3, o = 20, s = 5e3, c = 2147483647, l = (e, t) => {
+var a = 15e3, o = 48, s = 5e3, c = 2147483647, l = (e, t) => {
 	if (e <= c) {
 		let n = setTimeout(t, Math.max(e, 0));
 		return () => clearTimeout(n);
@@ -20,18 +20,18 @@ var a = 15e3, o = 20, s = 5e3, c = 2147483647, l = (e, t) => {
 		let t = n.get(e.id);
 		return !t || JSON.stringify(t) !== JSON.stringify(e);
 	});
-}, f = (c, { scheduleId: f, enabled: p = !0, pageSize: m = 10, nextRunTime: h }) => {
-	let [g, _] = r([]), [v, y] = r(p), [b, x] = r(!1), [S, C] = r(null), [w, T] = r(null), [E, D] = r(!1), [O, k] = r(0), A = n(0), j = n(0), M = n(!1), N = n(null), P = n(g), F = n(v), I = n(b), L = n(null), R = n(0), z = n(null), B = n(!1);
-	P.current = g, F.current = v, I.current = b;
-	let V = g.some((e) => e.status === i.InProgress);
+}, f = (c, { scheduleId: f, enabled: p = !0, pageSize: m = 10, nextRunTime: h, pollWhileActive: g = !1 }) => {
+	let [_, v] = r([]), [y, b] = r(p), [x, S] = r(!1), [C, w] = r(null), [T, E] = r(null), [D, O] = r(!1), [k, A] = r(0), j = n(0), M = n(0), N = n(!1), P = n(null), F = n(_), I = n(y), L = n(x), R = n(null), z = n(0), B = n(null), V = n(!1);
+	F.current = _, I.current = y, L.current = x;
+	let H = g || _.some((e) => e.status === i.InProgress);
 	t(() => {
-		let e = ++A.current, t = new AbortController();
-		N.current?.abort(), N.current = null, L.current?.abort(), L.current = null, M.current = !1, R.current = 0, z.current = null, B.current = !1, x(!1), C(null), T(null), _([]), D(!1), j.current = 0;
+		let e = ++j.current, t = new AbortController();
+		P.current?.abort(), P.current = null, R.current?.abort(), R.current = null, N.current = !1, z.current = 0, B.current = null, V.current = !1, S(!1), w(null), E(null), v([]), O(!1), M.current = 0;
 		let n = () => {
-			++A.current, t.abort(), N.current?.abort(), N.current = null, L.current?.abort(), L.current = null;
+			++j.current, t.abort(), P.current?.abort(), P.current = null, R.current?.abort(), R.current = null;
 		};
-		return !p || !f ? (y(!1), _([]), D(!1), n) : ((async () => {
-			y(!0);
+		return !p || !f ? (b(!1), v([]), O(!1), n) : ((async () => {
+			b(!0);
 			try {
 				let n = await c.listScheduledTaskRuns({
 					scheduleId: f,
@@ -39,29 +39,29 @@ var a = 15e3, o = 20, s = 5e3, c = 2147483647, l = (e, t) => {
 					offset: 0,
 					signal: t.signal
 				});
-				if (A.current !== e) return;
-				_(n.items), j.current = n.items.length, D(n.next != null || (n.count == null ? n.items.length === m : n.items.length < n.count));
+				if (j.current !== e) return;
+				v(n.items), M.current = n.items.length, O(n.next != null || (n.count == null ? n.items.length === m : n.items.length < n.count));
 			} catch (t) {
-				A.current === e && C(t instanceof Error ? t : /* @__PURE__ */ Error("Failed to load scheduled task runs"));
+				j.current === e && w(t instanceof Error ? t : /* @__PURE__ */ Error("Failed to load scheduled task runs"));
 			} finally {
-				A.current === e && y(!1);
+				j.current === e && b(!1);
 			}
 		})(), n);
 	}, [
 		c,
 		p,
 		m,
-		O,
+		k,
 		f
 	]);
-	let H = e(() => {
-		if (!p || !f || !E || v || M.current) return;
-		M.current = !0;
+	let U = e(() => {
+		if (!p || !f || !D || y || N.current) return;
+		N.current = !0;
 		let e = new AbortController();
-		N.current = e;
-		let t = A.current, n = j.current;
+		P.current = e;
+		let t = j.current, n = M.current;
 		(async () => {
-			x(!0), T(null);
+			S(!0), E(null);
 			try {
 				let r = await c.listScheduledTaskRuns({
 					scheduleId: f,
@@ -69,28 +69,28 @@ var a = 15e3, o = 20, s = 5e3, c = 2147483647, l = (e, t) => {
 					offset: n,
 					signal: e.signal
 				});
-				if (A.current !== t) return;
-				_((e) => {
+				if (j.current !== t) return;
+				v((e) => {
 					let t = new Set(e.map(({ id: e }) => e));
-					return [...e, ...r.items.filter(({ id: e }) => t.has(e) ? !1 : (t.add(e), !0))];
-				}), j.current = n + r.items.length, D(r.next != null || (r.count == null ? r.items.length === m : n + r.items.length < r.count));
+					return [...e, ...r.items.filter(({ id: e }) => !t.has(e) && (t.add(e), !0))];
+				}), M.current = n + r.items.length, O(r.next != null || (r.count == null ? r.items.length === m : n + r.items.length < r.count));
 			} catch (e) {
-				A.current === t && T(e instanceof Error ? e : /* @__PURE__ */ Error("Failed to load more scheduled task runs"));
+				j.current === t && E(e instanceof Error ? e : /* @__PURE__ */ Error("Failed to load more scheduled task runs"));
 			} finally {
-				A.current === t && (x(!1), M.current = !1, N.current = null);
+				j.current === t && (S(!1), N.current = !1, P.current = null);
 			}
 		})();
 	}, [
 		c,
 		p,
-		E,
-		v,
+		D,
+		y,
 		m,
 		f
-	]), U = e(async () => {
-		if (F.current || I.current) return "skipped";
-		let e = A.current, t = new AbortController();
-		L.current?.abort(), L.current = t;
+	]), W = e(async () => {
+		if (I.current || L.current) return "skipped";
+		let e = j.current, t = new AbortController();
+		R.current?.abort(), R.current = t;
 		try {
 			let n = await c.listScheduledTaskRuns({
 				scheduleId: f,
@@ -98,41 +98,29 @@ var a = 15e3, o = 20, s = 5e3, c = 2147483647, l = (e, t) => {
 				offset: 0,
 				signal: t.signal
 			});
-			if (A.current !== e || F.current || I.current) return "skipped";
-			let r = P.current, i = u(r, n.items), a = d(r, i);
-			return a && (P.current = i, _(i)), a ? "changed" : "unchanged";
+			if (j.current !== e || I.current || L.current) return "skipped";
+			let r = F.current, i = u(r, n.items), a = d(r, i);
+			return a && (F.current = i, v(i)), a ? "changed" : "unchanged";
 		} catch {
 			return "error";
 		} finally {
-			L.current === t && (L.current = null);
+			R.current === t && (R.current = null);
 		}
 	}, [
 		c,
 		f,
 		m
-	]), W = e(() => {
-		if (document.visibilityState !== "visible") {
-			B.current = !0;
-			return;
-		}
-		U();
-	}, [U]);
+	]), G = e(() => {
+		document.visibilityState === "visible" ? W() : V.current = !0;
+	}, [W]);
 	return t(() => {
-		if (!p || !f || !V) return;
-		R.current = 0;
+		if (!p || !f || !H) return;
+		z.current = 0;
 		let e = setInterval(() => {
-			if (document.visibilityState !== "visible") {
-				B.current = !0;
-				return;
-			}
-			(async () => {
-				let t = await U();
-				if (t === "changed") {
-					R.current = 0;
-					return;
-				}
-				(t === "unchanged" || t === "error") && (R.current += 1, R.current >= o && e !== null && (clearInterval(e), e = null));
-			})();
+			document.visibilityState === "visible" ? (async () => {
+				let t = await W();
+				t === "changed" ? z.current = 0 : (t === "unchanged" || t === "error") && (z.current += 1, z.current >= o && e !== null && (clearInterval(e), e = null));
+			})() : V.current = !0;
 		}, a);
 		return () => {
 			e !== null && clearInterval(e);
@@ -140,24 +128,24 @@ var a = 15e3, o = 20, s = 5e3, c = 2147483647, l = (e, t) => {
 	}, [
 		p,
 		f,
-		V,
-		U
+		H,
+		W
 	]), t(() => {
 		if (!p || !f || !h) return;
 		let e = new Date(h).getTime();
 		if (!(Number.isNaN(e) || e <= Date.now())) return l(e - Date.now() + s, () => {
-			z.current = h, W();
+			B.current = h, G();
 		});
 	}, [
 		p,
 		f,
 		h,
-		W
+		G
 	]), t(() => {
 		if (!p || !f) return;
 		let e = () => {
-			document.visibilityState !== "visible" || !B.current || (async () => {
-				await U() !== "skipped" && (B.current = !1);
+			document.visibilityState === "visible" && V.current && (async () => {
+				await W() !== "skipped" && (V.current = !1);
 			})();
 		};
 		return document.addEventListener("visibilitychange", e), () => {
@@ -166,28 +154,28 @@ var a = 15e3, o = 20, s = 5e3, c = 2147483647, l = (e, t) => {
 	}, [
 		p,
 		f,
-		U
+		W
 	]), t(() => {
-		if (!p || !f || !h || v || b) return;
+		if (!p || !f || !h || y || x) return;
 		let e = new Date(h).getTime();
-		Number.isNaN(e) || e > Date.now() || z.current !== h && (z.current = h, W());
+		Number.isNaN(e) || e > Date.now() || B.current !== h && (B.current = h, G());
 	}, [
 		p,
 		f,
 		h,
-		v,
-		b,
-		W
+		y,
+		x,
+		G
 	]), {
-		items: g,
-		isLoading: v,
-		isLoadingMore: b,
-		initialError: S,
-		loadMoreError: w,
-		hasMore: E,
-		loadMore: H,
-		retryLoadMore: H,
-		refetch: e(() => k((e) => e + 1), [])
+		items: _,
+		isLoading: y,
+		isLoadingMore: x,
+		initialError: C,
+		loadMoreError: T,
+		hasMore: D,
+		loadMore: U,
+		retryLoadMore: U,
+		refetch: e(() => A((e) => e + 1), [])
 	};
 };
 //#endregion

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

@@ -0,0 +1,28 @@
+import { ListScheduledTasksSortEnum, ScheduledTaskDto } from '@epam/ai-dial-chat-api-client';
+import { ScheduledTasksApiClient } from './scheduled-tasks-api-client';
+export interface UseScheduledTasksOptions {
+    enabled?: boolean;
+    pageSize?: number;
+    debounceMs?: number;
+    initialSearch?: string;
+    initialSort?: ListScheduledTasksSortEnum;
+    /** Restricts the list to tasks of one model/application; changing it reloads from the first page. */
+    model?: string;
+}
+/** Shared scheduler-list lifecycle with generation-scoped stale-response guards. */
+export declare const useScheduledTasks: (client: ScheduledTasksApiClient, { enabled, pageSize, debounceMs, initialSearch, initialSort, model, }?: UseScheduledTasksOptions) => {
+    items: ScheduledTaskDto[];
+    searchQuery: string;
+    setSearchQuery: import('react').Dispatch<import('react').SetStateAction<string>>;
+    sortKey: "newest" | "firstToRun" | "lastToRun" | "nameAZ";
+    setSortKey: import('react').Dispatch<import('react').SetStateAction<"newest" | "firstToRun" | "lastToRun" | "nameAZ">>;
+    isLoading: boolean;
+    isLoadingMore: boolean;
+    initialError: Error | null;
+    loadMoreError: Error | null;
+    hasMore: boolean;
+    loadMore: () => void;
+    retryLoadMore: () => void;
+    refetch: () => void;
+};
+//# sourceMappingURL=use-scheduled-tasks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-scheduled-tasks.d.ts","sourceRoot":"","sources":["../../src/scheduled-task/use-scheduled-tasks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,0BAA0B,EAC1B,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAE5E,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,0BAA0B,CAAC;IACzC,qGAAqG;IACrG,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,oFAAoF;AACpF,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,uBAAuB,EAC/B,wEAOG,wBAA6B;;;;;;;;;;;;;;CAuJjC,CAAC"}

package/scheduled-task/use-scheduled-tasks.js

@@ -59,7 +59,7 @@ var i = (i, { enabled: a = !0, pageSize: o = 20, debounceMs: s = 300, initialSea
 				if (k.current !== t) return;
 				f((e) => {
 					let t = new Set(e.map(({ id: e }) => e));
-					return [...e, ...r.items.filter(({ id: e }) => t.has(e) ? !1 : (t.add(e), !0))];
+					return [...e, ...r.items.filter(({ id: e }) => !t.has(e) && (t.add(e), !0))];
 				}), A.current = n + r.items.length, E(r.next != null);
 			} catch (e) {
 				k.current === t && w(e instanceof Error ? e : /* @__PURE__ */ Error("Failed to load more scheduled tasks"));

package/scheduled-task/useActiveScheduledTaskDetails.d.ts

@@ -0,0 +1,18 @@
+import { ScheduledTaskDto } from '@epam/ai-dial-chat-api-client';
+import { ActiveScheduledTaskDetailState } from './active-scheduled-task';
+/** Host-supplied cancellable task loader. */
+export type ActiveScheduledTaskLoader = (id: string, signal: AbortSignal) => Promise<ScheduledTaskDto>;
+/** Current details and retry operation for one active schedule. */
+export interface ActiveScheduledTaskDetails {
+    /** Current request lifecycle. */
+    taskState: ActiveScheduledTaskDetailState;
+    /** Loaded details, or null before success. */
+    task: ScheduledTaskDto | null;
+    /** Failure other than an unavailable task. */
+    taskError: Error | null;
+    /** Starts another request for the current schedule. */
+    retryTask: () => void;
+}
+/** Loads task details independently of run identity, ignoring superseded responses. */
+export declare const useActiveScheduledTaskDetails: (scheduleId: string | undefined, getTask: ActiveScheduledTaskLoader) => ActiveScheduledTaskDetails;
+//# sourceMappingURL=useActiveScheduledTaskDetails.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useActiveScheduledTaskDetails.d.ts","sourceRoot":"","sources":["../../src/scheduled-task/useActiveScheduledTaskDetails.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AAEzE,6CAA6C;AAC7C,MAAM,MAAM,yBAAyB,GAAG,CACtC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,WAAW,KAChB,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAC/B,mEAAmE;AACnE,MAAM,WAAW,0BAA0B;IACzC,iCAAiC;IACjC,SAAS,EAAE,8BAA8B,CAAC;IAC1C,8CAA8C;IAC9C,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC9B,8CAA8C;IAC9C,SAAS,EAAE,KAAK,GAAG,IAAI,CAAC;IACxB,uDAAuD;IACvD,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AACD,uFAAuF;AACvF,eAAO,MAAM,6BAA6B,GACxC,YAAY,MAAM,GAAG,SAAS,EAC9B,SAAS,yBAAyB,KACjC,0BAyDF,CAAC"}

package/scheduled-task/useActiveScheduledTaskDetails.js

@@ -0,0 +1,40 @@
+import { getApiErrorStatus as e } from "../api-error/api-error.js";
+import { ActiveScheduledTaskDetailState as t } from "./active-scheduled-task.js";
+import { useCallback as n, useEffect as r, useState as i } from "react";
+//#region src/scheduled-task/useActiveScheduledTaskDetails.ts
+var a = (a, o) => {
+	let [s, c] = i(t.Idle), [l, u] = i(null), [d, f] = i(null), [p, m] = i(0);
+	return r(() => {
+		if (!a) {
+			c(t.Idle), u(null), f(null);
+			return;
+		}
+		c(t.Loading), u(null), f(null);
+		let n = { value: !1 }, r = new AbortController();
+		return (async () => {
+			try {
+				let e = await o(a, r.signal);
+				if (n.value) return;
+				u(e), c(t.Success);
+			} catch (r) {
+				if (n.value) return;
+				e(r) === 404 ? c(t.Unavailable) : (f(r instanceof Error ? r : /* @__PURE__ */ Error("Failed to load the scheduled task")), c(t.Error));
+			}
+		})(), () => {
+			n.value = !0, r.abort();
+		};
+	}, [
+		a,
+		p,
+		o
+	]), {
+		taskState: s,
+		task: l,
+		taskError: d,
+		retryTask: n(() => {
+			m((e) => e + 1);
+		}, [])
+	};
+};
+//#endregion
+export { a as useActiveScheduledTaskDetails };

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

@@ -0,0 +1,17 @@
+/** Metadata needed to display a selected skill. */
+export interface ScheduledTaskSkillName {
+    /** Human-readable name. */
+    name: string;
+}
+/** Inputs for selection-scoped skill name resolution. */
+export interface UseScheduledTaskSkillDisplayNamesOptions {
+    /** Selected references in display order. */
+    skillUrls?: readonly string[];
+    /** Authoritative names from the host's current listing. */
+    listed: ReadonlyMap<string, string>;
+    /** Loads missing names; undefined preserves the reference as fallback. */
+    getMetadata: (url: string, signal: AbortSignal) => Promise<ScheduledTaskSkillName | undefined>;
+}
+/** Resolves missing skill names while preserving order and authoritative listing names. */
+export declare const useScheduledTaskSkillDisplayNames: ({ skillUrls, listed, getMetadata, }: UseScheduledTaskSkillDisplayNamesOptions) => string[];
+//# sourceMappingURL=useScheduledTaskSkillDisplayNames.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useScheduledTaskSkillDisplayNames.d.ts","sourceRoot":"","sources":["../../../src/scheduled-task/useScheduledTaskSkillDisplayNames/useScheduledTaskSkillDisplayNames.ts"],"names":[],"mappings":"AAEA,mDAAmD;AACnD,MAAM,WAAW,sBAAsB;IACrC,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AACD,yDAAyD;AACzD,MAAM,WAAW,wCAAwC;IACvD,4CAA4C;IAC5C,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,2DAA2D;IAC3D,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,0EAA0E;IAC1E,WAAW,EAAE,CACX,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,KAChB,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CAAC;CAClD;AACD,2FAA2F;AAC3F,eAAO,MAAM,iCAAiC,GAAI,qCAI/C,wCAAwC,KAAG,MAAM,EA6CnD,CAAC"}

package/scheduled-task/useScheduledTaskSkillDisplayNames/useScheduledTaskSkillDisplayNames.js

@@ -0,0 +1,29 @@
+import { useEffect as e, useState as t } from "react";
+//#region src/scheduled-task/useScheduledTaskSkillDisplayNames/useScheduledTaskSkillDisplayNames.ts
+var n = ({ skillUrls: n, listed: r, getMetadata: i }) => {
+	let a = JSON.stringify(n ?? []), o = JSON.stringify((n ?? []).map((e) => r.get(e) ?? null)), s = `${a}:${o}`, [c, l] = t();
+	return e(() => {
+		let e = JSON.parse(a), t = JSON.parse(o), n = new AbortController();
+		return l(void 0), (async () => {
+			await Promise.all(e.map(async (e, r) => {
+				if (!t[r]) try {
+					let t = await i(e, n.signal);
+					!n.signal.aborted && t && l((n) => ({
+						key: s,
+						names: {
+							...n?.key === s ? n.names : {},
+							[e]: t.name
+						}
+					}));
+				} catch {}
+			}));
+		})(), () => n.abort();
+	}, [
+		a,
+		o,
+		s,
+		i
+	]), (n ?? []).map((e) => r.get(e) || (c?.key === s ? c.names[e] : void 0) || e);
+};
+//#endregion
+export { n as useScheduledTaskSkillDisplayNames };

package/scheduled-tasks.d.ts

@@ -1,250 +1,2 @@
-import { CreatedScheduledTaskDto } from '@epam/ai-dial-chat-api-client';
-import { CreateScheduledTaskBodyDto } from '@epam/ai-dial-chat-api-client';
-import { Dispatch } from 'react';
-import { ListScheduledTaskRunsResponseDto } from '@epam/ai-dial-chat-api-client';
-import { ListScheduledTasksResponseDto } from '@epam/ai-dial-chat-api-client';
-import { ListScheduledTasksSortEnum } from '@epam/ai-dial-chat-api-client';
-import { ScheduledTaskCreateFormValues } from '@epam/ai-dial-scheduled-tasks';
-import { ScheduledTaskDto } from '@epam/ai-dial-chat-api-client';
-import { ScheduledTaskRunDto } from '@epam/ai-dial-chat-api-client';
-import { ScheduledTaskValidationErrors } from '../../libs/scheduled-tasks/validation';
-import { ScheduledTaskValidationOptions } from '../../libs/scheduled-tasks/validation';
-import { ScheduleTriggerDto } from '@epam/ai-dial-chat-api-client';
-import { SetStateAction } from 'react';
-import { UpdatedScheduledTaskDto } from '@epam/ai-dial-chat-api-client';
-import { UpdateScheduledTaskBodyDto } from '@epam/ai-dial-chat-api-client';
-
-/**
- * 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;
-
-/**
- * Describes the complete trigger without requiring unrelated task metadata.
- * 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;
-
-/**
- * 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;
-
-/**
- * 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[];
-
-/**
- * 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>;
-
-/** Result of mapping a scheduled task DTO back to editable form values. */
-export declare type ScheduledTaskDtoMappingResult = {
-    ok: true;
-    values: ScheduledTaskCreateFormValues;
-} | {
-    ok: false;
-    reason: UnsupportedTriggerReason;
-};
-
-/** A checked request preparation result that never serializes invalid values. */
-export declare type ScheduledTaskPreparationResult<TBody> = {
-    ok: true;
-    body: TBody;
-} | {
-    ok: false;
-    errors: ScheduledTaskValidationErrors;
-};
-
-export declare interface ScheduledTaskRunsListRequest {
-    scheduleId: string;
-    limit?: number;
-    offset?: number;
-    signal?: AbortSignal;
-}
-
-export declare 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>;
-}
-
-/** Narrow configured generated-client surface required by scheduler hooks. */
-export declare 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 declare 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 declare interface ScheduledTaskTriggerDescription {
-    kind: ScheduledTaskTriggerDescriptionKind;
-    time?: string;
-    dayOfWeek?: string;
-    dayOfMonth?: string;
-    intervalMinutes?: number;
-    date?: Date;
-    expression?: string;
-    sourceTimezone: 'utc';
-}
-
-/** Display categories are independent of task editability. */
-export declare enum ScheduledTaskTriggerDescriptionKind {
-    OneTime = "oneTime",
-    Hourly = "hourly",
-    EveryNMinutes = "everyNMinutes",
-    Daily = "daily",
-    Weekly = "weekly",
-    Monthly = "monthly",
-    Custom = "custom",
-    Invalid = "invalid"
-}
-
-export declare interface ScheduledTaskTriggerDescriptionOptions {
-    /** Display timezone; defaults to UTC for backwards compatibility. */
-    timeZone?: string;
-    /** Date whose timezone offset is used. Defaults to now (the existing UTC-storage policy). */
-    referenceDate?: Date;
-}
-
-/** 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"
-}
-
-/** Shared, cancellation-safe pagination and background refresh for one schedule's run history. */
-export declare const useScheduledTaskRuns: (client: ScheduledTasksApiClient, { scheduleId, enabled, pageSize, nextRunTime, }: UseScheduledTaskRunsOptions) => {
-    items: ScheduledTaskRunDto[];
-    isLoading: boolean;
-    isLoadingMore: boolean;
-    initialError: Error | null;
-    loadMoreError: Error | null;
-    hasMore: boolean;
-    loadMore: () => void;
-    retryLoadMore: () => void;
-    refetch: () => void;
-};
-
-export declare 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;
-}
-
-/** Shared scheduler-list lifecycle with generation-scoped stale-response guards. */
-export declare const useScheduledTasks: (client: ScheduledTasksApiClient, { enabled, pageSize, debounceMs, initialSearch, initialSort, model, }?: UseScheduledTasksOptions) => {
-    items: ScheduledTaskDto[];
-    searchQuery: string;
-    setSearchQuery: Dispatch<SetStateAction<string>>;
-    sortKey: "firstToRun" | "lastToRun" | "newest" | "nameAZ";
-    setSortKey: Dispatch<SetStateAction<"firstToRun" | "lastToRun" | "newest" | "nameAZ">>;
-    isLoading: boolean;
-    isLoadingMore: boolean;
-    initialError: Error | null;
-    loadMoreError: Error | null;
-    hasMore: boolean;
-    loadMore: () => void;
-    retryLoadMore: () => void;
-    refetch: () => void;
-};
-
-export declare interface UseScheduledTasksOptions {
-    enabled?: boolean;
-    pageSize?: number;
-    debounceMs?: number;
-    initialSearch?: string;
-    initialSort?: ListScheduledTasksSortEnum;
-    /** Restricts the list to tasks of one model/application; changing it reloads from the first page. */
-    model?: string;
-}
-
-export { }
+export * from './entry-points/scheduled-tasks.js'
+export {}