@epam/ai-dial-chat-hooks 1.2.0-dev.20 → 1.2.0-dev.201

package/oauth/useToolsetLogin/useToolsetLogin.js

@@ -1,4 +1,5 @@
-import { OAuthResourceKind as e, ToolsetAuthStatus as t, ToolsetAuthTypes as n, ToolsetCredentialsLevel as r, ToolsetOAuthInitiationResultType as i, ToolsetOAuthResultType as a } from "../types.js";
+import { OAuthResourceKind as e, ToolsetAuthStatus as t, ToolsetAuthTypes as n, ToolsetOAuthInitiationResultType as r, ToolsetOAuthResultType as i } from "../types.js";
+import { selectToolsetAuthStatus as a } from "../toolset-id.js";
 import { emitToolsetLoginSuccess as o } from "../../shared/toolset-login-events.js";
 import { waitForToolsetOAuthResult as s } from "../handshake.js";
 import { initiateOAuthLogin as c, navigateToolsetOAuthPopup as l, openToolsetOAuthPopup as u } from "../popup.js";
@@ -24,23 +25,22 @@ var f = /* @__PURE__ */ function(e) {
 			codeChallengeMethod: _?.codeChallengeMethod
 		}, x = v ? await (async () => {
 			let t = u();
-			return t ? (await g(p, m, n.OAuth), l(t, b, p, f, m, e.Toolset, y)) : { type: i.Blocked };
+			return t ? (await g(p, m, n.OAuth), l(t, b, p, f, m, e.Toolset, y)) : { type: r.Blocked };
 		})() : c(b, p, f, m, y);
-		if (x.type === i.Blocked) return { type: "popup-blocked" };
-		if (x.type !== i.Started) return { type: "failure" };
+		if (x.type === r.Blocked) return { type: "popup-blocked" };
+		if (x.type !== r.Started) return { type: "failure" };
 		let S = await s(x.popup, x.flowId, {
 			toolsetId: p,
 			credentialsLevel: m,
 			callbackPath: f
 		});
-		if (S.type === a.Success) return o({
+		if (S.type === i.Success) return o({
 			toolsetId: p,
 			credentialsLevel: m
 		}), { type: "success" };
-		if (S.type === a.Failure) return { type: "failure" };
+		if (S.type === i.Failure) return { type: "failure" };
 		try {
-			let e = await h(p);
-			if ((m === r.User ? e.authSettings?.userLevelAuthStatus : e.authSettings?.globalAuthStatus) === t.SignedIn) return o({
+			if (a((await h(p)).authSettings, m) === t.SignedIn) return o({
 				toolsetId: p,
 				credentialsLevel: m
 			}), { type: "success" };

package/oauth.d.ts

@@ -1,3 +1,4 @@
+import { DialToolsetAuthSettingsDto } from '@epam/ai-dial-chat-api-client';
 import { DialToolsetDto } from '@epam/ai-dial-chat-api-client';
 import { ToolsetLoginBodyDto } from '@epam/ai-dial-chat-api-client';
 import { ToolsetLogoutBodyDto } from '@epam/ai-dial-chat-api-client';
@@ -74,6 +75,19 @@ export declare const isPublicToolsetId: (toolsetId: string) => boolean;
  */
 export declare const navigateToolsetOAuthPopup: (popup: Window, auth: ToolsetOAuthSettings, toolsetId: string, callbackPath: string, credentialsLevel?: ToolsetCredentialsLevel, resourceKind?: OAuthResourceKind, offlineUsageConsent?: boolean) => ToolsetOAuthInitiationResult;
 
+/**
+ * Encodes a toolset id to its single-encoded form regardless of whether the
+ * value received it in was already percent-encoded or the raw,
+ * human-readable form — decoding first then re-encoding once is idempotent
+ * either way, since `decodeToolsetId` on a raw (unencoded) id is a no-op.
+ * Use this instead of `encodeToolsetId` at a boundary that cannot guarantee
+ * which form it receives, such as a `postMessage` payload from an embedded
+ * iframe: calling `encodeToolsetId` directly on a value the sender already
+ * encoded escapes the existing `%` characters a second time (`%20` becomes
+ * `%2520`), which the backend only ever undoes once and so 404s on.
+ */
+export declare const normalizeToolsetId: (toolsetId: string) => string;
+
 /** Arguments handed to the host's exchange callback. */
 export declare interface OAuthExchangeParams {
     /** One-time authorization code the provider returned. */
@@ -115,6 +129,24 @@ export declare enum OAuthResourceKind {
  */
 export declare const openToolsetOAuthPopup: () => Window | null;
 
+/**
+ * Resolves which credentials level a toolset's login applies to, per DIAL
+ * Core's public/private toolset convention: a `public`-bucket toolset is
+ * shared credentials-wise at `User` level, while a private/workspace toolset
+ * is scoped at `Global` level. Every surface that drives a toolset login
+ * (the sign-in-interrupt dialog, the QuickApps editor iframe bridge,
+ * `useToolsetLogin`) must resolve the level this way rather than assuming one.
+ */
+export declare const resolveToolsetCredentialsLevel: (toolsetId: string) => ToolsetCredentialsLevel.User | ToolsetCredentialsLevel.Global;
+
+/**
+ * Picks the auth-status field matching one credentials level out of a
+ * toolset's `authSettings` — DIAL Core reports `userLevelAuthStatus` and
+ * `globalAuthStatus` as independent fields rather than one status keyed by
+ * level.
+ */
+export declare const selectToolsetAuthStatus: (authSettings: Pick<DialToolsetAuthSettingsDto, "userLevelAuthStatus" | "globalAuthStatus"> | undefined, credentialsLevel: ToolsetCredentialsLevel) => string | undefined;
+
 export declare const subscribeToolsetLoginSuccess: <T>(listener: (detail: ToolsetLoginSuccessDetail<T>) => void) => (() => void);
 
 /** `sessionStorage` key the flow writes its `ToolsetRedirectState` under, in the popup it opens. */

package/oauth.js

@@ -1,9 +1,9 @@
-import { decodeToolsetId as e, encodeToolsetId as t, isPublicToolsetId as n } from "./oauth/toolset-id.js";
-import { OAuthResourceKind as r, TOOLSET_REDIRECT_STATE_KEY as i, ToolsetAuthStatus as a, ToolsetAuthTypes as o, ToolsetCredentialsLevel as s, ToolsetOAuthCallbackQuery as c, ToolsetOAuthChannelControlType as l, ToolsetOAuthFailureReason as u, ToolsetOAuthInitiationResultType as d, ToolsetOAuthResultType as f, WithLogin as p } from "./oauth/types.js";
-import { emitToolsetLoginSuccess as m, subscribeToolsetLoginSuccess as h } from "./shared/toolset-login-events.js";
-import { getToolsetOAuthChannelName as g, waitForToolsetOAuthResult as _ } from "./oauth/handshake.js";
-import { buildToolsetAuthorizeUrl as v, getToolsetRedirectUri as y } from "./oauth/authorize-url.js";
-import { initiateOAuthLogin as b, navigateToolsetOAuthPopup as x, openToolsetOAuthPopup as S } from "./oauth/popup.js";
-import { ToolsetLoginOutcomeType as C, useToolsetLogin as w } from "./oauth/useToolsetLogin/useToolsetLogin.js";
-import { useOAuthCallbackCompletion as T } from "./oauth/useOAuthCallbackCompletion/useOAuthCallbackCompletion.js";
-export { r as OAuthResourceKind, i as TOOLSET_REDIRECT_STATE_KEY, a as ToolsetAuthStatus, o as ToolsetAuthTypes, s as ToolsetCredentialsLevel, C as ToolsetLoginOutcomeType, c as ToolsetOAuthCallbackQuery, l as ToolsetOAuthChannelControlType, u as ToolsetOAuthFailureReason, d as ToolsetOAuthInitiationResultType, f as ToolsetOAuthResultType, p as WithLogin, v as buildToolsetAuthorizeUrl, e as decodeToolsetId, m as emitToolsetLoginSuccess, t as encodeToolsetId, g as getToolsetOAuthChannelName, y as getToolsetRedirectUri, b as initiateOAuthLogin, n as isPublicToolsetId, x as navigateToolsetOAuthPopup, S as openToolsetOAuthPopup, h as subscribeToolsetLoginSuccess, T as useOAuthCallbackCompletion, w as useToolsetLogin, _ as waitForToolsetOAuthResult };
+import { OAuthResourceKind as e, TOOLSET_REDIRECT_STATE_KEY as t, ToolsetAuthStatus as n, ToolsetAuthTypes as r, ToolsetCredentialsLevel as i, ToolsetOAuthCallbackQuery as a, ToolsetOAuthChannelControlType as o, ToolsetOAuthFailureReason as s, ToolsetOAuthInitiationResultType as c, ToolsetOAuthResultType as l, WithLogin as u } from "./oauth/types.js";
+import { decodeToolsetId as d, encodeToolsetId as f, isPublicToolsetId as p, normalizeToolsetId as m, resolveToolsetCredentialsLevel as h, selectToolsetAuthStatus as g } from "./oauth/toolset-id.js";
+import { emitToolsetLoginSuccess as _, subscribeToolsetLoginSuccess as v } from "./shared/toolset-login-events.js";
+import { getToolsetOAuthChannelName as y, waitForToolsetOAuthResult as b } from "./oauth/handshake.js";
+import { buildToolsetAuthorizeUrl as x, getToolsetRedirectUri as S } from "./oauth/authorize-url.js";
+import { initiateOAuthLogin as C, navigateToolsetOAuthPopup as w, openToolsetOAuthPopup as T } from "./oauth/popup.js";
+import { ToolsetLoginOutcomeType as E, useToolsetLogin as D } from "./oauth/useToolsetLogin/useToolsetLogin.js";
+import { useOAuthCallbackCompletion as O } from "./oauth/useOAuthCallbackCompletion/useOAuthCallbackCompletion.js";
+export { e as OAuthResourceKind, t as TOOLSET_REDIRECT_STATE_KEY, n as ToolsetAuthStatus, r as ToolsetAuthTypes, i as ToolsetCredentialsLevel, E as ToolsetLoginOutcomeType, a as ToolsetOAuthCallbackQuery, o as ToolsetOAuthChannelControlType, s as ToolsetOAuthFailureReason, c as ToolsetOAuthInitiationResultType, l as ToolsetOAuthResultType, u as WithLogin, x as buildToolsetAuthorizeUrl, d as decodeToolsetId, _ as emitToolsetLoginSuccess, f as encodeToolsetId, y as getToolsetOAuthChannelName, S as getToolsetRedirectUri, C as initiateOAuthLogin, p as isPublicToolsetId, w as navigateToolsetOAuthPopup, m as normalizeToolsetId, T as openToolsetOAuthPopup, h as resolveToolsetCredentialsLevel, g as selectToolsetAuthStatus, v as subscribeToolsetLoginSuccess, O as useOAuthCallbackCompletion, D as useToolsetLogin, b as waitForToolsetOAuthResult };

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.20",
+  "version": "1.2.0-dev.201",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -29,6 +29,11 @@
       "import": "./conversation.js",
       "default": "./conversation.js"
     },
+    "./conversation-overlay": {
+      "types": "./conversation-overlay.d.ts",
+      "import": "./conversation-overlay.js",
+      "default": "./conversation-overlay.js"
+    },
     "./conversation-transfer": {
       "types": "./conversation-transfer.d.ts",
       "import": "./conversation-transfer.js",
@@ -44,6 +49,11 @@
       "import": "./file-manager.js",
       "default": "./file-manager.js"
     },
+    "./file-manager-canvas": {
+      "types": "./file-manager-canvas.d.ts",
+      "import": "./file-manager-canvas.js",
+      "default": "./file-manager-canvas.js"
+    },
     "./source-content": {
       "types": "./source-content.d.ts",
       "import": "./source-content.js",
@@ -89,6 +99,11 @@
       "import": "./utils.js",
       "default": "./utils.js"
     },
+    "./usage": {
+      "types": "./usage.d.ts",
+      "import": "./usage.js",
+      "default": "./usage.js"
+    },
     "./mcp-apps": {
       "types": "./mcp-apps.d.ts",
       "import": "./mcp-apps.js",
@@ -96,7 +111,7 @@
     }
   },
   "dependencies": {
-    "@epam/ai-dial-chat-api-client": "1.2.0-dev.20",
+    "@epam/ai-dial-chat-api-client": "1.2.0-dev.201",
     "dompurify": "3.4.15",
     "fflate": "^0.8.3",
     "lru-cache": "^10.4.3",
@@ -105,21 +120,21 @@
   },
   "peerDependencies": {
     "react": "^19.2.8",
-    "@epam/ai-dial-attachment-canvas": "1.2.0-dev.20",
-    "@epam/ai-dial-attachment-input": "1.2.0-dev.20",
-    "@epam/ai-dial-builder-form": "1.2.0-dev.20",
-    "@epam/ai-dial-catalog": "1.2.0-dev.20",
-    "@epam/ai-dial-chat-overlay": "1.2.0-dev.20",
-    "@epam/ai-dial-chat-shared": "1.2.0-dev.20",
-    "@epam/ai-dial-mcp-apps": "1.2.0-dev.20",
-    "@epam/ai-dial-publish-panel": "1.2.0-dev.20",
-    "@epam/ai-dial-quotations": "1.2.0-dev.20",
-    "@epam/ai-dial-react-file-manager": "^0.2.0",
-    "@epam/ai-dial-scheduled-tasks": "1.2.0-dev.20",
-    "@epam/ai-dial-share": "1.2.0-dev.20",
-    "@epam/ai-dial-skill-editor": "1.2.0-dev.20",
-    "@epam/ai-dial-source-panel": "1.2.0-dev.20",
-    "@epam/ai-dial-ui-kit": "^0.14.2",
+    "@epam/ai-dial-attachment-canvas": "1.2.0-dev.201",
+    "@epam/ai-dial-attachment-input": "1.2.0-dev.201",
+    "@epam/ai-dial-catalog": "1.2.0-dev.201",
+    "@epam/ai-dial-chat-overlay": "1.2.0-dev.201",
+    "@epam/ai-dial-chat-shared": "1.2.0-dev.201",
+    "@epam/ai-dial-mcp-apps": "1.2.0-dev.201",
+    "@epam/ai-dial-publish-panel": "1.2.0-dev.201",
+    "@epam/ai-dial-quotations": "1.2.0-dev.201",
+    "@epam/ai-dial-react-file-manager": "^0.3.0-dev.16",
+    "@epam/ai-dial-scheduled-tasks": "1.2.0-dev.201",
+    "@epam/ai-dial-share": "1.2.0-dev.201",
+    "@epam/ai-dial-skill-editor": "1.2.0-dev.201",
+    "@epam/ai-dial-source-panel": "1.2.0-dev.201",
+    "@epam/ai-dial-ui-kit": "^0.15.0-dev.23",
+    "@epam/ai-dial-usage-dashboard": "1.2.0-dev.201",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@epam/pdf-highlighter-kit": "^0.0.19",
     "@mcp-ui/client": "^7.1.1"
@@ -131,9 +146,6 @@
     "@epam/ai-dial-attachment-input": {
       "optional": true
     },
-    "@epam/ai-dial-builder-form": {
-      "optional": true
-    },
     "@epam/ai-dial-catalog": {
       "optional": true
     },
@@ -170,6 +182,9 @@
     "@epam/ai-dial-ui-kit": {
       "optional": true
     },
+    "@epam/ai-dial-usage-dashboard": {
+      "optional": true
+    },
     "@mcp-ui/client": {
       "optional": true
     },
@@ -182,7 +197,7 @@
   },
   "sideEffects": [
     "./oauth.js",
-    "./file-manager.js",
+    "./file-manager-canvas.js",
     "./shared/toolset-login-events.js",
     "./files/attachment-canvas.js"
   ],

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

@@ -0,0 +1,77 @@
+//#region src/scheduled-task/scheduled-task-description.ts
+var e = /* @__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 = {}) => ({
+		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 });
+	}
+	let i = e.cron?.fields;
+	if (!i || Object.keys(i).length === 0) return r("invalid");
+	let a = () => r("custom", { expression: JSON.stringify(i) }), o = {
+		hour: [0, 23],
+		minute: [0, 59],
+		day: [1, 31],
+		day_of_week: [0, 6],
+		month: [1, 12],
+		second: [0, 59]
+	};
+	for (let [e, t] of Object.entries(i)) {
+		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 (e === "second" && t !== "0" || ![
+			"hour",
+			"minute",
+			"day",
+			"day_of_week"
+		].includes(e) && t !== "*" && !(e === "second" && t === "0")) return a();
+	}
+	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 ? [
+		"monday",
+		"tuesday",
+		"wednesday",
+		"thursday",
+		"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");
+	}
+	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);
+	}
+	let g = new Intl.DateTimeFormat("en-GB", {
+		timeZone: t,
+		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 });
+};
+//#endregion
+export { e as ScheduledTaskTriggerDescriptionKind, t as describeScheduledTaskTrigger };

package/scheduled-task/scheduled-task-preparation.js

@@ -0,0 +1,24 @@
+import { mapFormValuesToCreateBody as e, mapFormValuesToUpdateBody as t } from "./scheduled-task-trigger.js";
+import { validateScheduledTaskFormValues as n } from "@epam/ai-dial-scheduled-tasks/validation";
+//#region src/scheduled-task/scheduled-task-preparation.ts
+var r = (t, r) => {
+	let i = n(t, r);
+	return Object.keys(i).length > 0 ? {
+		ok: !1,
+		errors: i
+	} : {
+		ok: !0,
+		body: e(t)
+	};
+}, i = (e, r) => {
+	let i = n(e, r);
+	return Object.keys(i).length > 0 ? {
+		ok: !1,
+		errors: i
+	} : {
+		ok: !0,
+		body: t(e)
+	};
+};
+//#endregion
+export { r as prepareScheduledTaskCreateBody, i as prepareScheduledTaskUpdateBody };

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

@@ -42,9 +42,13 @@ var a = new Set([
 		trigger: t,
 		model: e.modelId,
 		prompt: e.prompt.trim(),
+		...e.skillUrl ? { skillUrl: e.skillUrl } : {},
 		...n ? { description: n } : {}
 	};
-}, u = (e) => l(e), d = (t) => {
+}, u = (e) => ({
+	...l(e),
+	skillUrl: e.skillUrl || null
+}), d = (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) => {
@@ -82,7 +86,7 @@ var a = new Set([
 		...c ? { dayOfMonth: String(d.getDate()) } : {}
 	};
 }, m = (e) => {
-	if (!e.model || !e.prompt) return {
+	if (!e.model || typeof e.prompt != "string" || !e.prompt.trim() && !e.skillUrl) return {
 		ok: !1,
 		reason: t.MissingRequiredFields
 	};
@@ -95,6 +99,7 @@ var a = new Set([
 		displayName: e.displayName,
 		modelId: e.model,
 		prompt: e.prompt,
+		...e.skillUrl ? { skillUrl: e.skillUrl } : {},
 		...e.description ? { description: e.description } : {}
 	};
 	if (a) return {

package/scheduled-task/scheduled-tasks-api-client.js

@@ -0,0 +1,19 @@
+//#region src/scheduled-task/scheduled-tasks-api-client.ts
+var e = (e) => {
+	if (!Array.isArray(e.items)) throw TypeError("Scheduled tasks API returned a malformed page response");
+	return e;
+}, t = (t) => ({
+	listScheduledTasks: async ({ signal: n, ...r } = {}) => e(await t.listScheduledTasks(r, n ? { signal: n } : void 0)),
+	listScheduledTaskRuns: async ({ signal: n, ...r }) => e(await t.listScheduledTaskRuns(r, n ? { signal: n } : void 0)),
+	createScheduledTask: (e) => t.createScheduledTask({ createScheduledTaskBodyDto: e }),
+	getScheduledTask: (e) => t.getScheduledTask({ scheduleId: e }),
+	updateScheduledTask: (e, n) => t.updateScheduledTask({
+		scheduleId: e,
+		updateScheduledTaskBodyDto: n
+	}),
+	pauseScheduledTask: (e) => t.pauseScheduledTask({ scheduleId: e }),
+	resumeScheduledTask: (e) => t.resumeScheduledTask({ scheduleId: e }),
+	deleteScheduledTask: (e) => t.deleteScheduledTask({ scheduleId: e })
+});
+//#endregion
+export { t as createScheduledTasksApiClient };

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

@@ -0,0 +1,194 @@
+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) => {
+	if (e <= c) {
+		let n = setTimeout(t, Math.max(e, 0));
+		return () => clearTimeout(n);
+	}
+	let n, r = setTimeout(() => {
+		n = l(e - c, t);
+	}, c);
+	return n = () => clearTimeout(r), () => n();
+}, u = (e, t) => {
+	let n = new Map(t.map((e) => [e.id, e])), r = new Set(e.map((e) => e.id)), i = e.map((e) => n.get(e.id) ?? e);
+	return [...t.filter((e) => !r.has(e.id)), ...i];
+}, d = (e, t) => {
+	if (e.length !== t.length) return !0;
+	let n = new Map(e.map((e) => [e.id, e]));
+	return t.some((e) => {
+		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);
+	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 n = () => {
+			++A.current, t.abort(), N.current?.abort(), N.current = null, L.current?.abort(), L.current = null;
+		};
+		return !p || !f ? (y(!1), _([]), D(!1), n) : ((async () => {
+			y(!0);
+			try {
+				let n = await c.listScheduledTaskRuns({
+					scheduleId: f,
+					limit: m,
+					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));
+			} catch (t) {
+				A.current === e && C(t instanceof Error ? t : /* @__PURE__ */ Error("Failed to load scheduled task runs"));
+			} finally {
+				A.current === e && y(!1);
+			}
+		})(), n);
+	}, [
+		c,
+		p,
+		m,
+		O,
+		f
+	]);
+	let H = e(() => {
+		if (!p || !f || !E || v || M.current) return;
+		M.current = !0;
+		let e = new AbortController();
+		N.current = e;
+		let t = A.current, n = j.current;
+		(async () => {
+			x(!0), T(null);
+			try {
+				let r = await c.listScheduledTaskRuns({
+					scheduleId: f,
+					limit: m,
+					offset: n,
+					signal: e.signal
+				});
+				if (A.current !== t) return;
+				_((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));
+			} catch (e) {
+				A.current === t && T(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);
+			}
+		})();
+	}, [
+		c,
+		p,
+		E,
+		v,
+		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;
+		try {
+			let n = await c.listScheduledTaskRuns({
+				scheduleId: f,
+				limit: m,
+				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";
+		} catch {
+			return "error";
+		} finally {
+			L.current === t && (L.current = null);
+		}
+	}, [
+		c,
+		f,
+		m
+	]), W = e(() => {
+		if (document.visibilityState !== "visible") {
+			B.current = !0;
+			return;
+		}
+		U();
+	}, [U]);
+	return t(() => {
+		if (!p || !f || !V) return;
+		R.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));
+			})();
+		}, a);
+		return () => {
+			e !== null && clearInterval(e);
+		};
+	}, [
+		p,
+		f,
+		V,
+		U
+	]), 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();
+		});
+	}, [
+		p,
+		f,
+		h,
+		W
+	]), t(() => {
+		if (!p || !f) return;
+		let e = () => {
+			document.visibilityState !== "visible" || !B.current || (async () => {
+				await U() !== "skipped" && (B.current = !1);
+			})();
+		};
+		return document.addEventListener("visibilitychange", e), () => {
+			document.removeEventListener("visibilitychange", e);
+		};
+	}, [
+		p,
+		f,
+		U
+	]), t(() => {
+		if (!p || !f || !h || v || b) return;
+		let e = new Date(h).getTime();
+		Number.isNaN(e) || e > Date.now() || z.current !== h && (z.current = h, W());
+	}, [
+		p,
+		f,
+		h,
+		v,
+		b,
+		W
+	]), {
+		items: g,
+		isLoading: v,
+		isLoadingMore: b,
+		initialError: S,
+		loadMoreError: w,
+		hasMore: E,
+		loadMore: H,
+		retryLoadMore: H,
+		refetch: e(() => k((e) => e + 1), [])
+	};
+};
+//#endregion
+export { u as mergeRunsById, f as useScheduledTaskRuns };

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

@@ -0,0 +1,93 @@
+import { useCallback as e, useEffect as t, useRef as n, useState as r } from "react";
+//#region src/scheduled-task/use-scheduled-tasks.ts
+var i = (i, { enabled: a = !0, pageSize: o = 20, debounceMs: s = 300, initialSearch: c = "", initialSort: l = "first_to_run" } = {}) => {
+	let [u, d] = r([]), [f, p] = r(c), [m, h] = r(l), [g, _] = r(a), [v, y] = r(!1), [b, x] = r(null), [S, C] = r(null), [w, T] = r(!1), [E, D] = r(0), O = n(0), k = n(0), A = n(!1), j = n(null), [M, N] = r(c);
+	t(() => {
+		let e = setTimeout(() => N(f), s);
+		return () => clearTimeout(e);
+	}, [s, f]), t(() => {
+		let e = ++O.current, t = new AbortController();
+		j.current?.abort(), j.current = null, A.current = !1, y(!1), x(null), C(null), d([]), T(!1), k.current = 0;
+		let n = () => {
+			++O.current, t.abort(), j.current?.abort(), j.current = null;
+		};
+		return a ? ((async () => {
+			_(!0);
+			try {
+				let n = await i.listScheduledTasks({
+					limit: o,
+					offset: 0,
+					search: M,
+					sort: m,
+					signal: t.signal
+				});
+				if (O.current !== e) return;
+				d(n.items), k.current = n.items.length, T(n.next != null);
+			} catch (t) {
+				O.current === e && x(t instanceof Error ? t : /* @__PURE__ */ Error("Failed to load scheduled tasks"));
+			} finally {
+				O.current === e && _(!1);
+			}
+		})(), n) : (_(!1), d([]), T(!1), n);
+	}, [
+		i,
+		M,
+		a,
+		o,
+		E,
+		m
+	]);
+	let P = e(() => {
+		if (!a || !w || g || A.current) return;
+		A.current = !0;
+		let e = new AbortController();
+		j.current = e;
+		let t = O.current, n = k.current;
+		(async () => {
+			y(!0), C(null);
+			try {
+				let r = await i.listScheduledTasks({
+					limit: o,
+					offset: n,
+					signal: e.signal,
+					search: M,
+					sort: m
+				});
+				if (O.current !== t) return;
+				d((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))];
+				}), k.current = n + r.items.length, T(r.next != null);
+			} catch (e) {
+				O.current === t && C(e instanceof Error ? e : /* @__PURE__ */ Error("Failed to load more scheduled tasks"));
+			} finally {
+				O.current === t && (y(!1), A.current = !1, j.current = null);
+			}
+		})();
+	}, [
+		i,
+		M,
+		a,
+		w,
+		g,
+		o,
+		m
+	]);
+	return {
+		items: u,
+		searchQuery: f,
+		setSearchQuery: p,
+		sortKey: m,
+		setSortKey: h,
+		isLoading: g,
+		isLoadingMore: v,
+		initialError: b,
+		loadMoreError: S,
+		hasMore: w,
+		loadMore: P,
+		retryLoadMore: P,
+		refetch: e(() => D((e) => e + 1), [])
+	};
+};
+//#endregion
+export { i as useScheduledTasks };