@epam/ai-dial-chat-hooks 1.3.0-dev.98 → 1.3.0-rc.0

package/project/use-project-submit.d.ts

@@ -0,0 +1,49 @@
+import { CreateProjectResponseDto, UpdateProjectResponseDto } from '@epam/ai-dial-chat-api-client';
+import { ProjectFields, ProjectsApiClient, ProjectUpdateRequest } from './projects-api-client';
+/** A rejected create or save, normalised for the page. */
+export interface ProjectSubmitFailure {
+    /** `true` when the page unmounted mid-request; nothing should be shown. */
+    isAborted: boolean;
+    /** HTTP status of the rejection. */
+    status?: number;
+    /** The BFF's `ProjectCreateErrorCode`, when the rejection carried one. */
+    code?: string;
+    /** Trace id for the error toast. */
+    requestId?: string;
+}
+/** Result of one {@link useCreateProject} `create` call. */
+export type CreateProjectOutcome = {
+    isCreated: true;
+    project: CreateProjectResponseDto;
+} | ({
+    isCreated: false;
+} & ProjectSubmitFailure);
+/** Result of one {@link useSaveProject} `save` call. */
+export type SaveProjectOutcome = {
+    isSaved: true;
+    project: UpdateProjectResponseDto;
+} | ({
+    isSaved: false;
+} & ProjectSubmitFailure);
+/**
+ * Submits the New project form; the page owns the form state and decides
+ * what each outcome means.
+ *
+ * @param client - Configured project requests, from `createProjectsApiClient`.
+ */
+export declare const useCreateProject: (client: Pick<ProjectsApiClient, "createProject">) => {
+    create: (fields: ProjectFields, files: File[]) => Promise<CreateProjectOutcome>;
+    isSubmitting: boolean;
+};
+/**
+ * Submits the Edit project form as one atomic update, conditioned on the
+ * loaded `contentVersion`; the page owns the draft and decides what each
+ * outcome means.
+ *
+ * @param client - Configured project requests, from `createProjectsApiClient`.
+ */
+export declare const useSaveProject: (client: Pick<ProjectsApiClient, "updateProject">) => {
+    save: (request: ProjectUpdateRequest) => Promise<SaveProjectOutcome>;
+    isSubmitting: boolean;
+};
+//# sourceMappingURL=use-project-submit.d.ts.map

package/project/use-project-submit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-project-submit.d.ts","sourceRoot":"","sources":["../../src/project/use-project-submit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAE/B,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,SAAS,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,4DAA4D;AAC5D,MAAM,MAAM,oBAAoB,GAC5B;IAAE,SAAS,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,wBAAwB,CAAA;CAAE,GACtD,CAAC;IAAE,SAAS,EAAE,KAAK,CAAA;CAAE,GAAG,oBAAoB,CAAC,CAAC;AAElD,wDAAwD;AACxD,MAAM,MAAM,kBAAkB,GAC1B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,wBAAwB,CAAA;CAAE,GACpD,CAAC;IAAE,OAAO,EAAE,KAAK,CAAA;CAAE,GAAG,oBAAoB,CAAC,CAAC;AAkDhD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,IAAI,CAAC,iBAAiB,EAAE,eAAe,CAAC;qBAMpC,aAAa,SACd,IAAI,EAAE,KACZ,OAAO,CAAC,oBAAoB,CAAC;;CAYnC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GACzB,QAAQ,IAAI,CAAC,iBAAiB,EAAE,eAAe,CAAC;oBAK9B,oBAAoB,KAAG,OAAO,CAAC,kBAAkB,CAAC;;CAYrE,CAAC"}

package/project/use-project-submit.js

@@ -0,0 +1,73 @@
+import { getApiErrorDetails as e } from "../api-error/api-error.js";
+import { useCallback as t, useEffect as n, useRef as r, useState as i } from "react";
+//#region src/project/use-project-submit.ts
+var a = () => {
+	let [a, o] = i(!1), s = r(null);
+	return n(() => () => {
+		s.current?.abort();
+	}, []), {
+		run: t(async (t) => {
+			s.current?.abort();
+			let n = new AbortController();
+			s.current = n, o(!0);
+			try {
+				return {
+					isOk: !0,
+					value: await t(n.signal)
+				};
+			} catch (t) {
+				if (n.signal.aborted) return {
+					isOk: !1,
+					isAborted: !0
+				};
+				let { status: r, code: i, traceId: a } = await e(t);
+				return {
+					isOk: !1,
+					isAborted: !1,
+					status: r,
+					code: i,
+					requestId: a
+				};
+			} finally {
+				n.signal.aborted || o(!1), s.current === n && (s.current = null);
+			}
+		}, []),
+		isSubmitting: a
+	};
+}, o = (e) => {
+	let { run: n, isSubmitting: r } = a();
+	return {
+		create: t(async (t, r) => {
+			let i = await n((n) => e.createProject(t, r, n));
+			if (i.isOk) return {
+				isCreated: !0,
+				project: i.value
+			};
+			let { isOk: a, ...o } = i;
+			return {
+				isCreated: !1,
+				...o
+			};
+		}, [e, n]),
+		isSubmitting: r
+	};
+}, s = (e) => {
+	let { run: n, isSubmitting: r } = a();
+	return {
+		save: t(async (t) => {
+			let r = await n((n) => e.updateProject(t, n));
+			if (r.isOk) return {
+				isSaved: !0,
+				project: r.value
+			};
+			let { isOk: i, ...a } = r;
+			return {
+				isSaved: !1,
+				...a
+			};
+		}, [e, n]),
+		isSubmitting: r
+	};
+};
+//#endregion
+export { o as useCreateProject, s as useSaveProject };

package/project/use-project-watch.d.ts

@@ -0,0 +1,24 @@
+import { ProjectsApiClient } from './projects-api-client';
+/** What `useProjectWatch` reports to the page that shows one project. */
+export interface ProjectWatchOptions {
+    /** The loaded snapshot's aggregate ETag; the watch opens once it is known, and an event carrying it is skipped. */
+    etag: string | undefined;
+    /** Silent refresh of everything the page shows; at most one runs at a time, and a rejection is ignored. */
+    onChange: () => Promise<void>;
+    /** The project was deleted elsewhere; called at most once per project id. */
+    onDelete: () => void;
+}
+/**
+ * Keeps a page showing one project current: it watches that project, runs
+ * `onChange` for each change the page has not loaded yet — one at a time,
+ * plus one trailing run for whatever arrived meanwhile — and `onDelete` once
+ * when the project is deleted. A dropped stream is reopened with a bounded
+ * backoff and followed by one `onChange`; a watch that cannot be opened is
+ * not retried for the rest of the visit.
+ *
+ * @param client - Configured project requests, from `createProjectsApiClient`; it must be referentially stable, because a new object resubscribes.
+ * @param projectId - The watched project's DIAL id, or `null` while none is known.
+ * @param options - The loaded ETag and the page's callbacks; read at event time, so new identities never resubscribe.
+ */
+export declare const useProjectWatch: (client: Pick<ProjectsApiClient, "watchProjects">, projectId: string | null, options: ProjectWatchOptions) => void;
+//# sourceMappingURL=use-project-watch.d.ts.map

package/project/use-project-watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-project-watch.d.ts","sourceRoot":"","sources":["../../src/project/use-project-watch.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,yEAAyE;AACzE,MAAM,WAAW,mBAAmB;IAClC,mHAAmH;IACnH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,2GAA2G;IAC3G,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,GAC1B,QAAQ,IAAI,CAAC,iBAAiB,EAAE,eAAe,CAAC,EAChD,WAAW,MAAM,GAAG,IAAI,EACxB,SAAS,mBAAmB,KAC3B,IAwEF,CAAC"}

package/project/use-project-watch.js

@@ -0,0 +1,41 @@
+import { runProjectWatch as e } from "./project-watch-stream.js";
+import { ProjectWatchAction as t } from "@epam/ai-dial-chat-api-client";
+import { useEffect as n, useRef as r } from "react";
+//#region src/project/use-project-watch.ts
+var i = (i, a, o) => {
+	let s = r(o);
+	n(() => {
+		s.current = o;
+	});
+	let c = r(null), l = o.etag != null, { watchProjects: u } = i;
+	n(() => {
+		if (u == null || a == null || !l || c.current === a) return;
+		let n = new AbortController(), r = !1, i = !1, o = () => {
+			n.signal.aborted || (r ? i = !0 : (r = !0, (async () => {
+				try {
+					await s.current.onChange();
+				} catch {} finally {
+					r = !1, i && (i = !1, o());
+				}
+			})()));
+		};
+		return e({
+			watchProjects: u,
+			ids: [a],
+			signal: n.signal,
+			onEvent: (e) => {
+				e.id !== a || n.signal.aborted || (e.action === t.Delete ? (i = !1, n.abort(), s.current.onDelete()) : (e.etag == null || e.etag !== s.current.etag) && o());
+			},
+			onReconnected: o,
+			onUnavailable: () => {
+				c.current = a;
+			}
+		}), () => n.abort();
+	}, [
+		u,
+		a,
+		l
+	]);
+};
+//#endregion
+export { i as useProjectWatch };

package/project/use-project.d.ts

@@ -0,0 +1,23 @@
+import { ProjectDetailsDto } from '@epam/ai-dial-chat-api-client';
+import { ProjectRefreshOutcome } from './project-refresh';
+import { ProjectsApiClient } from './projects-api-client';
+/**
+ * Loads one project's details. Loading is derived from whether a result
+ * answers the current id and reload token, so a page never renders a stale
+ * project for a new id. A `404` is a not-found result, every other failure an
+ * error; the request is aborted on unmount and on an id change. `refresh`
+ * re-reads the loaded project without the loading state, for live updates.
+ *
+ * @param client - Configured project requests, from `createProjectsApiClient`; it must be referentially stable, because a new object reloads.
+ * @param id - The project's DIAL id, or `null` when the route names none.
+ * @param enabled - Whether the page is enabled; no request is sent while `false`.
+ */
+export declare const useProject: (client: Pick<ProjectsApiClient, "getProject">, id: string | null, enabled: boolean) => {
+    project: ProjectDetailsDto | null;
+    isLoading: boolean;
+    hasError: boolean;
+    isNotFound: boolean;
+    retry: () => void;
+    refresh: () => Promise<ProjectRefreshOutcome>;
+};
+//# sourceMappingURL=use-project.d.ts.map

package/project/use-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-project.d.ts","sourceRoot":"","sources":["../../src/project/use-project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAGvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAU/D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,GACrB,QAAQ,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,EAC7C,IAAI,MAAM,GAAG,IAAI,EACjB,SAAS,OAAO;;;;;;mBA2CsB,OAAO,CAAC,qBAAqB,CAAC;CA8BrE,CAAC"}

package/project/use-project.js

@@ -0,0 +1,73 @@
+import { getApiErrorStatus as e } from "../api-error/api-error.js";
+import { ProjectRefreshOutcome as t } from "./project-refresh.js";
+import { useCallback as n, useEffect as r, useRef as i, useState as a } from "react";
+//#region src/project/use-project.ts
+var o = (o, s, c) => {
+	let [l, u] = a(0), [d, f] = a(), p = `${l}:${s ?? ""}`;
+	r(() => {
+		if (!c || s == null) return;
+		let t = new AbortController();
+		return (async () => {
+			try {
+				let e = await o.getProject(s, t.signal);
+				if (t.signal.aborted) return;
+				f({
+					key: p,
+					project: e,
+					hasError: !1,
+					isNotFound: !1
+				});
+			} catch (n) {
+				if (t.signal.aborted) return;
+				let r = e(n) === 404;
+				f({
+					key: p,
+					project: null,
+					hasError: !r,
+					isNotFound: r
+				});
+			}
+		})(), () => t.abort();
+	}, [
+		o,
+		c,
+		s,
+		p
+	]);
+	let m = n(() => {
+		u((e) => e + 1);
+	}, []), h = d?.key === p ? d : void 0, g = h?.project ?? null, _ = i(null);
+	r(() => () => {
+		_.current?.abort(), _.current = null;
+	}, [p]);
+	let v = n(async () => {
+		if (g == null || s == null) return t.Skipped;
+		_.current?.abort();
+		let n = new AbortController();
+		_.current = n;
+		try {
+			let e = await o.getProject(s, n.signal);
+			return n.signal.aborted ? t.Skipped : (f((t) => t?.key === p ? {
+				...t,
+				project: e
+			} : t), t.Updated);
+		} catch (r) {
+			return n.signal.aborted ? t.Skipped : e(r) === 404 ? t.NotFound : t.Failed;
+		}
+	}, [
+		o,
+		s,
+		p,
+		g
+	]);
+	return {
+		project: g,
+		isLoading: c && s != null && h == null,
+		hasError: h?.hasError ?? !1,
+		isNotFound: h?.isNotFound ?? !1,
+		retry: m,
+		refresh: v
+	};
+};
+//#endregion
+export { o as useProject };

package/project/use-projects.d.ts

@@ -0,0 +1,27 @@
+import { ProjectItem, ProjectSource } from '@epam/ai-dial-projects';
+import { ProjectsApiClient } from './projects-api-client';
+/**
+ * Loads the projects the session user can see, mapped to the Projects lib's
+ * cards, and keeps them current while mounted. Loading is derived from
+ * whether a result answers the current reload token, so an enabled page is
+ * loading from its very first render. The request is aborted on unmount or
+ * when `enabled` turns false.
+ *
+ * When the client offers `watchProjects`, a successful load opens one watch
+ * stream for the listed projects: an update moves a card's `updatedAt`
+ * forward and a delete removes it. A stream that drops is reopened with a
+ * bounded backoff and followed by a silent reload, so changes made during
+ * the gap are not lost; a watch that cannot be opened at all is not retried
+ * for the rest of the visit.
+ *
+ * @param client - Configured project requests, from `createProjectsApiClient`; it must be referentially stable, because a new object reloads.
+ * @param enabled - Whether the page is enabled; no request is sent while `false`.
+ */
+export declare const useProjects: (client: Pick<ProjectsApiClient, "listProjects" | "watchProjects">, enabled: boolean) => {
+    projects: ProjectItem[];
+    incompleteSources: ProjectSource[];
+    isLoading: boolean;
+    hasError: boolean;
+    retry: () => void;
+};
+//# sourceMappingURL=use-projects.d.ts.map

package/project/use-projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-projects.d.ts","sourceRoot":"","sources":["../../src/project/use-projects.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAKzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAoC/D;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,WAAW,GACtB,QAAQ,IAAI,CAAC,iBAAiB,EAAE,cAAc,GAAG,eAAe,CAAC,EACjE,SAAS,OAAO;;;;;;CAmGjB,CAAC"}

package/project/use-projects.js

@@ -0,0 +1,92 @@
+import { mapProjectDtoToItem as e, mapProjectSource as t } from "./project-mapping.js";
+import { applyProjectEvent as n } from "./project-events.js";
+import { runProjectWatch as r } from "./project-watch-stream.js";
+import { useCallback as i, useEffect as a, useRef as o, useState as s } from "react";
+//#region src/project/use-projects.ts
+var c = 1e3, l = "\n", u = ({ items: n, incompleteSources: r }, i) => {
+	let a = n.map(e);
+	return {
+		reloadToken: i,
+		projects: a,
+		incompleteSources: r.map(t),
+		hasError: !1,
+		watchKey: a.slice(0, c).map(({ id: e }) => e).sort().join(l)
+	};
+}, d = (e, t) => {
+	let [c, d] = s(0), [f, p] = s(), m = o(!1), h = o(void 0);
+	a(() => {
+		if (!t) return;
+		let n = new AbortController();
+		return (async () => {
+			try {
+				let t = await e.listProjects(n.signal);
+				if (n.signal.aborted) return;
+				p(u(t, c));
+			} catch {
+				if (n.signal.aborted) return;
+				p({
+					reloadToken: c,
+					projects: [],
+					incompleteSources: [],
+					hasError: !0,
+					watchKey: ""
+				});
+			}
+		})(), () => n.abort();
+	}, [
+		e,
+		t,
+		c
+	]);
+	let g = i(async () => {
+		h.current?.abort();
+		let t = new AbortController();
+		h.current = t;
+		try {
+			let n = await e.listProjects(t.signal);
+			if (t.signal.aborted) return;
+			p((e) => e == null || e.hasError ? e : u(n, e.reloadToken));
+		} catch {}
+	}, [e]);
+	a(() => () => h.current?.abort(), []);
+	let _ = f?.reloadToken === c ? f : void 0, v = t ? _?.watchKey ?? "" : "", { watchProjects: y } = e;
+	a(() => {
+		if (y == null || v === "" || m.current) return;
+		let e = new AbortController();
+		return r({
+			watchProjects: y,
+			ids: v.split(l),
+			signal: e.signal,
+			onEvent: (e) => p((t) => {
+				if (t == null) return t;
+				let r = n(t.projects, e);
+				return r === t.projects ? t : {
+					...t,
+					projects: r
+				};
+			}),
+			onReconnected: () => {
+				g();
+			},
+			onUnavailable: () => {
+				m.current = !0;
+			}
+		}), () => e.abort();
+	}, [
+		y,
+		v,
+		g
+	]);
+	let b = i(() => {
+		d((e) => e + 1);
+	}, []);
+	return {
+		projects: _?.projects ?? [],
+		incompleteSources: _?.incompleteSources ?? [],
+		isLoading: t && _ == null,
+		hasError: _?.hasError ?? !1,
+		retry: b
+	};
+};
+//#endregion
+export { d as useProjects };

package/project.d.ts

@@ -0,0 +1,2 @@
+export * from './entry-points/project.js'
+export {}

package/project.js

@@ -0,0 +1,20 @@
+import { buildCreateConversationDto as e, createProjectsApiClient as t, splitProjectConversationId as n } from "./project/projects-api-client.js";
+import { mapProjectArtifactsToOutputs as r, mapProjectDetailsToViewModel as i, mapProjectDtoToItem as a, mapProjectSource as o, mapProjectSourceToFilterTab as s, mapStoredContextFiles as c } from "./project/project-mapping.js";
+import { DEFAULT_PROJECT_CONTEXT_ALLOWED_EXTENSIONS as l, DEFAULT_PROJECT_CONTEXT_FILE_MAX_BYTES as u, DEFAULT_PROJECT_CONTEXT_TOTAL_MAX_BYTES as d, getMimeTypesForExtensions as f, resolveByteLimit as p, resolveExtensionList as m } from "./project/project-limits.js";
+import { ProjectFormErrorField as h, ProjectFormErrorReason as g, getProjectFormError as _ } from "./project/project-form-errors.js";
+import { downloadProjectFileAttachment as v, fromProjectOutputCardId as y, fromProjectPreviewKey as b, toProjectContextFileAttachment as x, toProjectOutputAttachment as S, toProjectOutputCardId as C, toProjectPreviewKey as w, toStoredProjectFileAttachment as T } from "./project/project-file-preview.js";
+import { useProjectFilePreview as E } from "./project/use-project-file-preview.js";
+import { ProjectDraftMode as D, useProjectDraft as O } from "./project/use-project-draft.js";
+import { ProjectChatCreateFailure as k, classifyProjectChatCreateError as A, createProjectChat as j } from "./project/create-project-chat.js";
+import { createProjectConversationDataSource as M } from "./project/project-conversation-data-source.js";
+import { useProjects as N } from "./project/use-projects.js";
+import { ProjectRefreshOutcome as P } from "./project/project-refresh.js";
+import { useProject as F } from "./project/use-project.js";
+import { useProjectWatch as I } from "./project/use-project-watch.js";
+import { useCreateProject as L, useSaveProject as R } from "./project/use-project-submit.js";
+import { useProjectConversations as z } from "./project/use-project-conversations.js";
+import { PINNED_PROJECT_CHATS_LIMIT as B, usePinnedProjectChats as V } from "./project/use-pinned-project-chats.js";
+import { useProjectArtifacts as H } from "./project/use-project-artifacts.js";
+import { ProjectActionError as U, useProjectActions as W } from "./project/use-project-actions.js";
+import { createSerializedKeyedWriter as G } from "./shared/serialized-writer.js";
+export { l as DEFAULT_PROJECT_CONTEXT_ALLOWED_EXTENSIONS, u as DEFAULT_PROJECT_CONTEXT_FILE_MAX_BYTES, d as DEFAULT_PROJECT_CONTEXT_TOTAL_MAX_BYTES, B as PINNED_PROJECT_CHATS_LIMIT, U as ProjectActionError, k as ProjectChatCreateFailure, D as ProjectDraftMode, h as ProjectFormErrorField, g as ProjectFormErrorReason, P as ProjectRefreshOutcome, e as buildCreateConversationDto, A as classifyProjectChatCreateError, j as createProjectChat, M as createProjectConversationDataSource, t as createProjectsApiClient, G as createSerializedKeyedWriter, v as downloadProjectFileAttachment, y as fromProjectOutputCardId, b as fromProjectPreviewKey, f as getMimeTypesForExtensions, _ as getProjectFormError, r as mapProjectArtifactsToOutputs, i as mapProjectDetailsToViewModel, a as mapProjectDtoToItem, o as mapProjectSource, s as mapProjectSourceToFilterTab, c as mapStoredContextFiles, p as resolveByteLimit, m as resolveExtensionList, n as splitProjectConversationId, x as toProjectContextFileAttachment, S as toProjectOutputAttachment, C as toProjectOutputCardId, w as toProjectPreviewKey, T as toStoredProjectFileAttachment, L as useCreateProject, V as usePinnedProjectChats, F as useProject, W as useProjectActions, H as useProjectArtifacts, z as useProjectConversations, O as useProjectDraft, E as useProjectFilePreview, I as useProjectWatch, N as useProjects, R as useSaveProject };

package/prompt/prompt.d.ts

@@ -23,6 +23,17 @@ export declare const validatePromptName: (name: string) => PromptFieldError | nu
 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;
+/** Field errors of a prompt form, keyed by field. */
+export interface PromptFieldErrors {
+    /** Error of the name field. */
+    name?: PromptFieldError;
+    /** Error of the description field. */
+    description?: PromptFieldError;
+    /** Error of the prompt body field. */
+    content?: PromptFieldError;
+}
+/** The validator of each prompt form field. */
+export declare const PROMPT_FIELD_VALIDATORS: Record<keyof PromptFieldErrors, (value: 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

package/prompt/prompt.d.ts.map

@@ -1 +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"}
+{"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,qDAAqD;AACrD,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,sCAAsC;IACtC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,sCAAsC;IACtC,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAED,+CAA+C;AAC/C,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAC1C,MAAM,iBAAiB,EACvB,CAAC,KAAK,EAAE,MAAM,KAAK,gBAAgB,GAAG,IAAI,CAK3C,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/prompt.js

@@ -4,9 +4,13 @@ var e = /* @__PURE__ */ function(e) {
 }({}), t = /^(?!\.{1,2}$)[a-zA-Z0-9 _.-]+$/, n = 256, r = 2e3, i = 5e4, a = 10, o = (e) => {
 	let n = e.trim();
 	return n.length === 0 ? "required" : n.length > 256 ? "tooLong" : t.test(n) ? null : "invalidName";
-}, s = (e) => e.length > 2e3 ? "tooLong" : null, c = (e) => e.trim().length === 0 ? "required" : e.length > 5e4 ? "tooLong" : null, l = (e, t) => {
+}, s = (e) => e.length > 2e3 ? "tooLong" : null, c = (e) => e.trim().length === 0 ? "required" : e.length > 5e4 ? "tooLong" : null, l = {
+	name: o,
+	description: s,
+	content: c
+}, u = (e, t) => {
 	let n = t - e.length;
 	return n <= 10 ? n : null;
-}, u = (e, t) => e ? `${e}/${t}` : t;
+}, d = (e, t) => e ? `${e}/${t}` : t;
 //#endregion
-export { i as PROMPT_CONTENT_MAX_LENGTH, a as PROMPT_COUNTER_ANNOUNCE_THRESHOLD, r as PROMPT_DESCRIPTION_MAX_LENGTH, n as PROMPT_NAME_MAX_LENGTH, e as PromptFieldError, u as buildPromptPath, l as getRemainingCharacters, c as validatePromptContent, s as validatePromptDescription, o as validatePromptName };
+export { i as PROMPT_CONTENT_MAX_LENGTH, a as PROMPT_COUNTER_ANNOUNCE_THRESHOLD, r as PROMPT_DESCRIPTION_MAX_LENGTH, l as PROMPT_FIELD_VALIDATORS, n as PROMPT_NAME_MAX_LENGTH, e as PromptFieldError, d as buildPromptPath, u as getRemainingCharacters, c as validatePromptContent, s as validatePromptDescription, o as validatePromptName };

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

@@ -0,0 +1,58 @@
+/** Resolution status of scheduler metadata for the currently routed conversation. */
+export declare enum ActiveScheduledTaskStatus {
+    Resolving = "resolving",
+    NotATaskConversation = "not-a-task-conversation",
+    TaskConversation = "task-conversation"
+}
+/** Fetch status of the active task's own details (separate from its run history). */
+export declare enum ActiveScheduledTaskDetailState {
+    Idle = "idle",
+    Loading = "loading",
+    Error = "error",
+    Unavailable = "unavailable",
+    Success = "success"
+}
+/** Minimal scheduler metadata supplied by the host. */
+export interface ActiveScheduledTaskCandidate {
+    /** Opaque conversation identity. */
+    id: string;
+    /** Whether the scheduler created this conversation. */
+    isScheduledTask?: boolean;
+    /** Schedule identity. */
+    scheduleId?: string;
+    /** Run identity. */
+    runId?: string;
+    /** Conversation update epoch. */
+    updatedAt?: number;
+    /** Conversation display title. */
+    title?: string;
+}
+/** Inputs for resolving scheduler metadata without routing knowledge. */
+export interface ResolveActiveScheduledTaskOptions {
+    /** Guarded route identity, or null outside a conversation. */
+    routeConversationId: string | null;
+    /** Host feature decision. */
+    enabled: boolean;
+    /** Whether the conversation list is loading. */
+    isLoading: boolean;
+    /** Current conversation candidates. */
+    items: readonly ActiveScheduledTaskCandidate[];
+    /** Host identity matching policy. */
+    matches: (candidateId: string, routeId: string) => boolean;
+}
+/** Resolved active-task metadata. */
+export interface ActiveScheduledTaskResolution {
+    /** Classification of the supplied conversation. */
+    status: ActiveScheduledTaskStatus;
+    /** Matched schedule identity. */
+    scheduleId?: string;
+    /** Matched run identity. */
+    runId?: string;
+    /** Matched conversation update epoch. */
+    conversationUpdatedAt?: number;
+    /** Matched conversation title. */
+    conversationTitle?: string;
+}
+/** Resolves scheduler metadata using the caller's identity policy. */
+export declare const resolveActiveScheduledTask: ({ routeConversationId, enabled, isLoading, items, matches, }: ResolveActiveScheduledTaskOptions) => ActiveScheduledTaskResolution;
+//# sourceMappingURL=active-scheduled-task.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"active-scheduled-task.d.ts","sourceRoot":"","sources":["../../src/scheduled-task/active-scheduled-task.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,oBAAY,yBAAyB;IACnC,SAAS,cAAc;IACvB,oBAAoB,4BAA4B;IAChD,gBAAgB,sBAAsB;CACvC;AAED,qFAAqF;AACrF,oBAAY,8BAA8B;IACxC,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,WAAW,gBAAgB;IAC3B,OAAO,YAAY;CACpB;AAED,uDAAuD;AACvD,MAAM,WAAW,4BAA4B;IAC3C,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,uDAAuD;IACvD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AACD,yEAAyE;AACzE,MAAM,WAAW,iCAAiC;IAChD,8DAA8D;IAC9D,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,6BAA6B;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,KAAK,EAAE,SAAS,4BAA4B,EAAE,CAAC;IAC/C,qCAAqC;IACrC,OAAO,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5D;AACD,qCAAqC;AACrC,MAAM,WAAW,6BAA6B;IAC5C,mDAAmD;IACnD,MAAM,EAAE,yBAAyB,CAAC;IAClC,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kCAAkC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AACD,sEAAsE;AACtE,eAAO,MAAM,0BAA0B,GAAI,8DAMxC,iCAAiC,KAAG,6BAmBtC,CAAC"}

package/scheduled-task/active-scheduled-task.js

@@ -0,0 +1,18 @@
+//#region src/scheduled-task/active-scheduled-task.ts
+var e = /* @__PURE__ */ function(e) {
+	return e.Resolving = "resolving", e.NotATaskConversation = "not-a-task-conversation", e.TaskConversation = "task-conversation", e;
+}({}), t = /* @__PURE__ */ function(e) {
+	return e.Idle = "idle", e.Loading = "loading", e.Error = "error", e.Unavailable = "unavailable", e.Success = "success", e;
+}({}), n = ({ routeConversationId: e, enabled: t, isLoading: n, items: r, matches: i }) => {
+	if (!e || !t) return { status: "not-a-task-conversation" };
+	let a = r.find((t) => i(t.id, e));
+	return a ? !a.isScheduledTask || !a.scheduleId || !a.runId ? { status: "not-a-task-conversation" } : {
+		status: "task-conversation",
+		scheduleId: a.scheduleId,
+		runId: a.runId,
+		conversationUpdatedAt: a.updatedAt,
+		conversationTitle: a.title
+	} : { status: n ? "resolving" : "not-a-task-conversation" };
+};
+//#endregion
+export { t as ActiveScheduledTaskDetailState, e as ActiveScheduledTaskStatus, n as resolveActiveScheduledTask };

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

@@ -14,6 +14,8 @@ export interface ScheduledTaskTriggerDescription {
     kind: ScheduledTaskTriggerDescriptionKind;
     time?: string;
     dayOfWeek?: string;
+    /** Every display-timezone weekday of a `Weekly` description, Monday first; `dayOfWeek` is its first entry. */
+    daysOfWeek?: string[];
     dayOfMonth?: string;
     intervalMinutes?: number;
     date?: Date;

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

@@ -1 +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"}
+{"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,8GAA8G;IAC9G,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,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,+BAuKF,CAAC"}