@epam/ai-dial-chat-hooks 1.3.0-dev.5 → 1.3.0-dev.55

package/prompt/prompt-resource.d.ts

@@ -0,0 +1,30 @@
+/** Which prompt namespace a catalog prompt item came from. */
+export declare enum PromptSource {
+    /** The caller's own prompt, editable and deletable by them. */
+    Personal = "personal",
+    /** Shared with the caller by another user; permissions determine editability. */
+    SharedWithMe = "sharedWithMe",
+    /** Organisation-wide prompt; read-only for every user. */
+    Public = "public"
+}
+/** A prompt resource URL split into the bucket and the path within it. */
+export interface ParsedPromptResourceUrl {
+    /** DIAL Core bucket name. */
+    bucket: string;
+    /** Path to the prompt within that bucket. */
+    path: string;
+}
+/**
+ * Splits a `prompts/{bucket}/{path}` resource URL into its parts, mirroring the
+ * backend's parser. Returns `null` for a different prefix, an empty bucket, or
+ * an empty path, so callers can treat "not a prompt resource id" as one case.
+ *
+ * `CatalogItem.id` for a prompt is always this full resource path — the read,
+ * update, delete, and move endpoints all take it unmodified. The one caller
+ * that still needs the bucket-relative sub-path on its own is the
+ * organisation (public) prompt read, whose endpoint kept its bucket-relative
+ * `path` argument because it only ever operates on the fixed `public`
+ * namespace.
+ */
+export declare const parsePromptResourceUrl: (url: string) => ParsedPromptResourceUrl | null;
+//# sourceMappingURL=prompt-resource.d.ts.map

package/prompt/prompt-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-resource.d.ts","sourceRoot":"","sources":["../../src/prompt/prompt-resource.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,oBAAY,YAAY;IACtB,+DAA+D;IAC/D,QAAQ,aAAa;IACrB,iFAAiF;IACjF,YAAY,iBAAiB;IAC7B,0DAA0D;IAC1D,MAAM,WAAW;CAClB;AAKD,0EAA0E;AAC1E,MAAM,WAAW,uBAAuB;IACtC,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,GACjC,KAAK,MAAM,KACV,uBAAuB,GAAG,IAS5B,CAAC"}

package/prompt/prompt.d.ts

@@ -0,0 +1,34 @@
+/** Why a prompt-editor field failed client-side validation. */
+export declare enum PromptFieldError {
+    /** The field is required and was left empty. */
+    Required = "required",
+    /** The value exceeds the backend's length limit for the field. */
+    TooLong = "tooLong",
+    /** The name contains characters the backend's allowlist rejects. */
+    InvalidName = "invalidName",
+    /** The backend reported an existing prompt or folder at the target path. */
+    Conflict = "conflict"
+}
+/** Maximum name length accepted by `CreatePromptDto.name`. */
+export declare const PROMPT_NAME_MAX_LENGTH = 256;
+/** Maximum description length accepted by `CreatePromptDto.description`. */
+export declare const PROMPT_DESCRIPTION_MAX_LENGTH = 2000;
+/** Maximum body length accepted by `CreatePromptDto.content`. */
+export declare const PROMPT_CONTENT_MAX_LENGTH = 50000;
+/** How close to a length limit the remaining-characters counter starts announcing. */
+export declare const PROMPT_COUNTER_ANNOUNCE_THRESHOLD = 10;
+/** Validates a prompt or folder name against the backend's own rules. */
+export declare const validatePromptName: (name: string) => PromptFieldError | null;
+/** Validates a prompt description; an empty description is valid. */
+export declare const validatePromptDescription: (description: string) => PromptFieldError | null;
+/** Validates a prompt body: required, and within the backend's length limit. */
+export declare const validatePromptContent: (content: string) => PromptFieldError | null;
+/**
+ * Returns the characters left before a limit, or `null` while still further
+ * away than the announce threshold — a counter that fires on every keystroke
+ * is unusable noise in a live region.
+ */
+export declare const getRemainingCharacters: (value: string, maxLength: number) => number | null;
+/** Joins a folder path and a prompt name into the DIAL prompt path used as an id. */
+export declare const buildPromptPath: (folderId: string, name: string) => string;
+//# sourceMappingURL=prompt.d.ts.map

package/prompt/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/prompt/prompt.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,oBAAY,gBAAgB;IAC1B,gDAAgD;IAChD,QAAQ,aAAa;IACrB,kEAAkE;IAClE,OAAO,YAAY;IACnB,oEAAoE;IACpE,WAAW,gBAAgB;IAC3B,4EAA4E;IAC5E,QAAQ,aAAa;CACtB;AAiBD,8DAA8D;AAC9D,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,4EAA4E;AAC5E,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAElD,iEAAiE;AACjE,eAAO,MAAM,yBAAyB,QAAQ,CAAC;AAE/C,sFAAsF;AACtF,eAAO,MAAM,iCAAiC,KAAK,CAAC;AAEpD,yEAAyE;AACzE,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,gBAAgB,GAAG,IAMpE,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,yBAAyB,GACpC,aAAa,MAAM,KAClB,gBAAgB,GAAG,IAGZ,CAAC;AAEX,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,GAChC,SAAS,MAAM,KACd,gBAAgB,GAAG,IAMrB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,OAAO,MAAM,EACb,WAAW,MAAM,KAChB,MAAM,GAAG,IAGX,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,MAAM,MAAM,KAAG,MACxB,CAAC"}

package/prompt/usePromptsState/usePromptsState.d.ts

@@ -0,0 +1,34 @@
+import { PromptFolderResponseDto, PromptListResponseDto, PromptResponseDto } from '@epam/ai-dial-chat-api-client';
+/** Parameters for {@link usePromptsState}. */
+export interface UsePromptsStateParams {
+    /** Fetches the aggregate prompt listing from the server. */
+    listPrompts: () => Promise<PromptListResponseDto>;
+}
+/** Result returned by {@link usePromptsState}. */
+export interface UsePromptsStateResult {
+    /** The caller's own prompts. */
+    prompts: PromptResponseDto[];
+    /** Folders in the caller's own prompt namespace. */
+    folders: PromptFolderResponseDto[];
+    /** Prompts other users have shared with the caller. */
+    sharedWithMe: PromptResponseDto[];
+    /** Organisation-wide (public) prompts, read-only for every user. */
+    publicPrompts: PromptResponseDto[];
+    /** Folders in the organisation prompt namespace. */
+    publicFolders: PromptFolderResponseDto[];
+    /** True until the aggregate prompt listing has settled. */
+    isLoading: boolean;
+    /** Rejection reason of the most recent failed list request, or `null`. */
+    error: unknown;
+    /** Re-reads personal, shared-with-me, and organisation prompts. */
+    refetch: () => Promise<void>;
+    /** Compatibility alias for the aggregate refetch — same function reference as `refetch`. */
+    refetchPublicPrompts: () => Promise<void>;
+}
+/**
+ * Fetches all prompt namespaces (personal, shared, public) with a single
+ * aggregate request. Exposes `refetch` / `refetchPublicPrompts` for
+ * manual refresh. Does not import any app context, routing, or i18n.
+ */
+export declare const usePromptsState: ({ listPrompts, }: UsePromptsStateParams) => UsePromptsStateResult;
+//# sourceMappingURL=usePromptsState.d.ts.map

package/prompt/usePromptsState/usePromptsState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePromptsState.d.ts","sourceRoot":"","sources":["../../../src/prompt/usePromptsState/usePromptsState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,+BAA+B,CAAC;AAGvC,8CAA8C;AAC9C,MAAM,WAAW,qBAAqB;IACpC,4DAA4D;IAC5D,WAAW,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACnD;AAED,kDAAkD;AAClD,MAAM,WAAW,qBAAqB;IACpC,gCAAgC;IAChC,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,oDAAoD;IACpD,OAAO,EAAE,uBAAuB,EAAE,CAAC;IACnC,uDAAuD;IACvD,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,oEAAoE;IACpE,aAAa,EAAE,iBAAiB,EAAE,CAAC;IACnC,oDAAoD;IACpD,aAAa,EAAE,uBAAuB,EAAE,CAAC;IACzC,2DAA2D;IAC3D,SAAS,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,KAAK,EAAE,OAAO,CAAC;IACf,mEAAmE;IACnE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,4FAA4F;IAC5F,oBAAoB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,kBAE7B,qBAAqB,KAAG,qBA6E1B,CAAC"}

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

@@ -0,0 +1,38 @@
+import { ScheduleTriggerDto } from '@epam/ai-dial-chat-api-client';
+/** 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 interface ScheduledTaskTriggerDescription {
+    kind: ScheduledTaskTriggerDescriptionKind;
+    time?: string;
+    dayOfWeek?: string;
+    dayOfMonth?: string;
+    intervalMinutes?: number;
+    date?: Date;
+    expression?: string;
+    sourceTimezone: 'utc';
+}
+export 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;
+}
+/**
+ * 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;
+//# sourceMappingURL=scheduled-task-description.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-task-description.d.ts","sourceRoot":"","sources":["../../src/scheduled-task/scheduled-task-description.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAGxE,8DAA8D;AAC9D,oBAAY,mCAAmC;IAC7C,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,aAAa,kBAAkB;IAC/B,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,mCAAmC,CAAC;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,KAAK,CAAC;CACvB;AAED,MAAM,WAAW,sCAAsC;IACrD,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6FAA6F;IAC7F,aAAa,CAAC,EAAE,IAAI,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,GACvC,SAAS,kBAAkB,EAC3B,+BAGG,sCAA2C,KAC7C,+BA8JF,CAAC"}

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-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 '../../libs/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;AAuGlC;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GACpC,QAAQ,6BAA6B,KACpC,0BAsCF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GACpC,QAAQ,6BAA6B,KACpC,0BAGD,CAAC;AAqHH;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B,GAC1C,KAAK,gBAAgB,KACpB,6BA8FF,CAAC"}

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"}

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));
+				}), 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,40 +98,40 @@ 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(() => {
+	]), G = e(() => {
 		if (document.visibilityState !== "visible") {
-			B.current = !0;
+			V.current = !0;
 			return;
 		}
-		U();
-	}, [U]);
+		W();
+	}, [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;
+				V.current = !0;
 				return;
 			}
 			(async () => {
-				let t = await U();
+				let t = await W();
 				if (t === "changed") {
-					R.current = 0;
+					z.current = 0;
 					return;
 				}
-				(t === "unchanged" || t === "error") && (R.current += 1, R.current >= o && e !== null && (clearInterval(e), e = null));
+				(t === "unchanged" || t === "error") && (z.current += 1, z.current >= o && e !== null && (clearInterval(e), e = null));
 			})();
 		}, a);
 		return () => {
@@ -140,24 +140,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 +166,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: "firstToRun" | "lastToRun" | "newest" | "nameAZ";
+    setSortKey: import('react').Dispatch<import('react').SetStateAction<"firstToRun" | "lastToRun" | "newest" | "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"}