@epam/ai-dial-chat-hooks 1.3.0-dev.304 → 1.3.0-dev.305

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.3.0-dev.304",
+  "version": "1.3.0-dev.305",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -131,7 +131,7 @@
     }
   },
   "dependencies": {
-    "@epam/ai-dial-chat-api-client": "1.3.0-dev.304",
+    "@epam/ai-dial-chat-api-client": "1.3.0-dev.305",
     "dompurify": "3.4.17",
     "fflate": "^0.8.3",
     "lru-cache": "^10.4.3",
@@ -140,23 +140,23 @@
   },
   "peerDependencies": {
     "react": "^19.2.8",
-    "@epam/ai-dial-attachment-canvas": "1.3.0-dev.304",
-    "@epam/ai-dial-attachment-input": "1.3.0-dev.304",
-    "@epam/ai-dial-catalog": "1.3.0-dev.304",
-    "@epam/ai-dial-chat-overlay": "1.3.0-dev.304",
-    "@epam/ai-dial-chat-shared": "1.3.0-dev.304",
-    "@epam/ai-dial-conversation-input": "1.3.0-dev.304",
-    "@epam/ai-dial-mcp-apps": "1.3.0-dev.304",
-    "@epam/ai-dial-projects": "1.3.0-dev.304",
-    "@epam/ai-dial-publish-panel": "1.3.0-dev.304",
-    "@epam/ai-dial-quotations": "1.3.0-dev.304",
+    "@epam/ai-dial-attachment-canvas": "1.3.0-dev.305",
+    "@epam/ai-dial-attachment-input": "1.3.0-dev.305",
+    "@epam/ai-dial-catalog": "1.3.0-dev.305",
+    "@epam/ai-dial-chat-overlay": "1.3.0-dev.305",
+    "@epam/ai-dial-chat-shared": "1.3.0-dev.305",
+    "@epam/ai-dial-conversation-input": "1.3.0-dev.305",
+    "@epam/ai-dial-mcp-apps": "1.3.0-dev.305",
+    "@epam/ai-dial-projects": "1.3.0-dev.305",
+    "@epam/ai-dial-publish-panel": "1.3.0-dev.305",
+    "@epam/ai-dial-quotations": "1.3.0-dev.305",
     "@epam/ai-dial-react-file-manager": "^0.4.0-dev.25",
-    "@epam/ai-dial-scheduled-tasks": "1.3.0-dev.304",
-    "@epam/ai-dial-share": "1.3.0-dev.304",
-    "@epam/ai-dial-skill-editor": "1.3.0-dev.304",
-    "@epam/ai-dial-source-panel": "1.3.0-dev.304",
+    "@epam/ai-dial-scheduled-tasks": "1.3.0-dev.305",
+    "@epam/ai-dial-share": "1.3.0-dev.305",
+    "@epam/ai-dial-skill-editor": "1.3.0-dev.305",
+    "@epam/ai-dial-source-panel": "1.3.0-dev.305",
     "@epam/ai-dial-ui-kit": "^0.16.0-dev.67",
-    "@epam/ai-dial-usage-dashboard": "1.3.0-dev.304",
+    "@epam/ai-dial-usage-dashboard": "1.3.0-dev.305",
     "@modelcontextprotocol/sdk": "^1.32.2",
     "@epam/pdf-highlighter-kit": "^0.0.19"
   },

package/project/create-project-chat.d.ts

@@ -0,0 +1,34 @@
+import { ConversationResponseDto } from '@epam/ai-dial-chat-api-client';
+import { ChatSettingsValues } from '../useChatSettingsFormConfig/useChatSettingsFormConfig';
+import { ConversationCreateRequest, ProjectsApiClient } from './projects-api-client';
+/** Why creating a project chat failed, as the host explains it. */
+export declare enum ProjectChatCreateFailure {
+    /** The project has no room left for another chat. */
+    StorageFull = "storage-full",
+    /** Any other failure. */
+    Failed = "failed"
+}
+/** A failed chat create, classified for the host's message. */
+export interface ProjectChatCreateFailureDetails {
+    /** Why the create failed. */
+    failure: ProjectChatCreateFailure;
+    /** Trace id of the failed request, when the response carried one. */
+    requestId?: string;
+}
+/**
+ * Creates a project chat from its first message, saves the composer's chat
+ * settings onto it, and hands the saved chat to `onCreated` in every case where
+ * the chat exists, even when saving the settings fails (the chat exists either
+ * way, and opening it avoids a duplicate on retry). A failed save is rethrown
+ * after `onCreated` ran; a failed create rejects without calling it.
+ *
+ * @param client - Configured project requests, from `createProjectsApiClient`.
+ * @param projectId - The project's DIAL id.
+ * @param request - First message, deployment, attachments, tool configuration, form values and skills.
+ * @param settings - System prompt, temperature and response format saved onto the new chat.
+ * @param onCreated - Receives the chat with the settings applied, e.g. to open it.
+ */
+export declare const createProjectChat: (client: Pick<ProjectsApiClient, "createProjectConversation" | "saveProjectConversation">, projectId: string, request: ConversationCreateRequest, settings: ChatSettingsValues, onCreated: (saved: ConversationResponseDto) => void) => Promise<ConversationResponseDto>;
+/** Classifies a rejected project chat create as storage-full or a plain failure, with its trace id. */
+export declare const classifyProjectChatCreateError: (error: unknown) => Promise<ProjectChatCreateFailureDetails>;
+//# sourceMappingURL=create-project-chat.d.ts.map

package/project/create-project-chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-project-chat.d.ts","sourceRoot":"","sources":["../../src/project/create-project-chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wDAAwD,CAAC;AACjG,OAAO,KAAK,EACV,yBAAyB,EACzB,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAE/B,mEAAmE;AACnE,oBAAY,wBAAwB;IAClC,qDAAqD;IACrD,WAAW,iBAAiB;IAC5B,yBAAyB;IACzB,MAAM,WAAW;CAClB;AAED,+DAA+D;AAC/D,MAAM,WAAW,+BAA+B;IAC9C,6BAA6B;IAC7B,OAAO,EAAE,wBAAwB,CAAC;IAClC,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,IAAI,CACV,iBAAiB,EACjB,2BAA2B,GAAG,yBAAyB,CACxD,EACD,WAAW,MAAM,EACjB,SAAS,yBAAyB,EAClC,UAAU,kBAAkB,EAC5B,WAAW,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,KAClD,OAAO,CAAC,uBAAuB,CAiBjC,CAAC;AAEF,uGAAuG;AACvG,eAAO,MAAM,8BAA8B,GACzC,OAAO,OAAO,KACb,OAAO,CAAC,+BAA+B,CASzC,CAAC"}

package/project/create-project-chat.js

@@ -0,0 +1,27 @@
+import { getApiErrorDetails as e } from "../api-error/api-error.js";
+import { ProjectCreateErrorCode as t } from "@epam/ai-dial-chat-api-client";
+//#region src/project/create-project-chat.ts
+var n = /* @__PURE__ */ function(e) {
+	return e.StorageFull = "storage-full", e.Failed = "failed", e;
+}({}), r = async (e, t, n, r, i) => {
+	let a = await e.createProjectConversation(t, n), o = {
+		...a,
+		prompt: r.systemPrompt,
+		temperature: r.temperature,
+		responseFormat: r.responseFormat
+	};
+	try {
+		await e.saveProjectConversation(a.id, o);
+	} finally {
+		i(o);
+	}
+	return o;
+}, i = async (n) => {
+	let { code: r, traceId: i } = await e(n);
+	return {
+		failure: r === t.ProjectStorageFull ? "storage-full" : "failed",
+		requestId: i
+	};
+};
+//#endregion
+export { n as ProjectChatCreateFailure, i as classifyProjectChatCreateError, r as createProjectChat };

package/project/project-conversation-data-source.d.ts

@@ -0,0 +1,36 @@
+import { ConversationDataSource } from '../conversation/conversation-data-source';
+import { CreateChatStreamApiDeps } from '../conversation/create-chat-stream-api';
+import { SerializedKeyedWriter } from '../shared/serialized-writer';
+import { ProjectsApiClient } from './projects-api-client';
+/** Host ports of {@link createProjectConversationDataSource}. */
+export interface ProjectConversationDataSourceOptions {
+    /** The project's DIAL id. */
+    projectId: string;
+    /** Whether the caller owns the project; a conversation opens read-only without it. */
+    canEdit: boolean;
+    /** Configured project requests, from `createProjectsApiClient`; only the conversation requests are used. */
+    client: Pick<ProjectsApiClient, 'getProjectConversation' | 'saveProjectConversation' | 'deleteProjectConversation' | 'attachToProjectGeneration'>;
+    /** Where and how the completion stream is sent: the host's base path under the project, and its CSRF token store. */
+    stream: Pick<CreateChatStreamApiDeps, 'getCsrfToken' | 'setCsrfToken' | 'completionsBasePath'>;
+    /** The host's routes: a project conversation's page, and where a deleted or missing one goes. */
+    routes: {
+        /** Returns the page route of a conversation. */
+        getConversationRoute: (id: string) => string;
+        /** Returns the route a deleted or missing conversation navigates to. */
+        getExitRoute: () => string;
+    };
+    /** The queue viewed marks go through, shared with the host's other pages so they write one at a time. */
+    viewedWriter: SerializedKeyedWriter;
+    /** Translation key of the toast shown when the conversation cannot be loaded; the host resolves it. */
+    notFoundMessageKey?: string;
+}
+/**
+ * Returns the data source of a conversation stored inside a project: the
+ * project conversation requests for loads, saves and streams, the host's
+ * routes, read-only from `canEdit`, no sidebar list side effects and no
+ * Duplicate. A project chat has no sidebar row, so the open chat is marked
+ * viewed through `viewedWriter`, and a generation starting drops a mark still
+ * waiting for its chat.
+ */
+export declare const createProjectConversationDataSource: ({ projectId, canEdit, client, stream, routes, viewedWriter, notFoundMessageKey, }: ProjectConversationDataSourceOptions) => ConversationDataSource;
+//# sourceMappingURL=project-conversation-data-source.d.ts.map

package/project/project-conversation-data-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-conversation-data-source.d.ts","sourceRoot":"","sources":["../../src/project/project-conversation-data-source.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,sBAAsB,EAE5B,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,wCAAwC,CAAC;AAGhD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAU/D,iEAAiE;AACjE,MAAM,WAAW,oCAAoC;IACnD,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,OAAO,EAAE,OAAO,CAAC;IACjB,4GAA4G;IAC5G,MAAM,EAAE,IAAI,CACV,iBAAiB,EACf,wBAAwB,GACxB,yBAAyB,GACzB,2BAA2B,GAC3B,2BAA2B,CAC9B,CAAC;IACF,qHAAqH;IACrH,MAAM,EAAE,IAAI,CACV,uBAAuB,EACvB,cAAc,GAAG,cAAc,GAAG,qBAAqB,CACxD,CAAC;IACF,iGAAiG;IACjG,MAAM,EAAE;QACN,gDAAgD;QAChD,oBAAoB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;QAC7C,wEAAwE;QACxE,YAAY,EAAE,MAAM,MAAM,CAAC;KAC5B,CAAC;IACF,yGAAyG;IACzG,YAAY,EAAE,qBAAqB,CAAC;IACpC,uGAAuG;IACvG,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAsED;;;;;;;GAOG;AACH,eAAO,MAAM,mCAAmC,GAAI,mFAQjD,oCAAoC,KAAG,sBAiEzC,CAAC"}

package/project/project-conversation-data-source.js

@@ -0,0 +1,67 @@
+import { createChatStreamApi as e } from "../conversation/create-chat-stream-api.js";
+import { NO_CONVERSATION_LIST_SYNC as t } from "../conversation/conversation-data-source.js";
+import { getBrowserTimezone as n } from "../shared/browser-timezone.js";
+import { sleep as r } from "../shared/sleep.js";
+//#region src/project/project-conversation-data-source.ts
+var i = "projects/", a = 5, o = 2e3, s = 5e3, c = "data: {\"action\":\"UPDATE\"}\n\n", l = (e) => e.startsWith(i) ? e : `${i}${e}`, u = (e) => {
+	let t = new TextEncoder().encode(c);
+	return new ReadableStream({ async pull(n) {
+		await r(s, e), e.aborted ? n.close() : n.enqueue(t);
+	} }, { highWaterMark: 0 });
+}, d = (e, t, n, i) => {
+	let s = new AbortController();
+	return (async () => {
+		for (let c = 0; c < a; c++) {
+			if (await r(o, s.signal), s.signal.aborted) return;
+			try {
+				let { name: r } = await e(t, s.signal);
+				if (s.signal.aborted) return;
+				if (r && r !== n) {
+					i(r);
+					return;
+				}
+			} catch {
+				if (s.signal.aborted) return;
+			}
+		}
+	})(), () => s.abort();
+}, f = ({ projectId: r, canEdit: i, client: a, stream: o, routes: s, viewedWriter: c, notFoundMessageKey: f }) => {
+	let { streamCompletion: p, stopCompletion: m } = e({
+		...o,
+		getTimezone: n
+	}), h = {
+		...t,
+		markUnread: (e) => c.drop(e),
+		markViewed: async (e) => {
+			try {
+				await c.enqueue(e);
+			} catch {}
+		},
+		shouldMarkOpenChatViewed: !0
+	}, g = (e, t) => a.saveProjectConversation(l(e), t);
+	return {
+		transport: {
+			streamCompletion: p,
+			stopCompletion: m,
+			watchConversation: async (e, t) => u(t),
+			attachToGeneration: (e, t) => a.attachToProjectGeneration(r, e, t),
+			getConversation: async (e, t) => await a.getProjectConversation(e, t),
+			saveConversation: async (e, t) => await g(e, t)
+		},
+		getConversation: a.getProjectConversation,
+		saveConversation: g,
+		handlersApi: {
+			saveConversation: ({ path: e, saveConversationBodyDto: t }) => g(e, t.conversation),
+			deleteConversation: ({ path: e }) => a.deleteProjectConversation(l(e))
+		},
+		watchTitle: (e, t, n) => d(a.getProjectConversation, e, t, n),
+		getConversationRoute: s.getConversationRoute,
+		getExitRoute: s.getExitRoute,
+		isReadOnly: () => !i,
+		listSync: h,
+		canDuplicate: !1,
+		notFoundMessageKey: f
+	};
+};
+//#endregion
+export { f as createProjectConversationDataSource };

package/project/project-file-preview.d.ts

@@ -0,0 +1,28 @@
+import { DisplayAttachment } from '@epam/ai-dial-chat-shared';
+import { ProjectContextFile, ProjectOutputItem } from '@epam/ai-dial-projects';
+/** A project file card the page opens in the canvas: its card id, name and MIME type. */
+export interface ProjectFileCard {
+    /** Id of the card on the page; also the attachment id. */
+    id: string;
+    /** File name shown in the canvas header. */
+    name: string;
+    /** MIME type of the file. */
+    contentType: string;
+}
+/** Builds the locator a canvas content resolver fetches for a project file, from the project id and the file name. The host owns the scheme. */
+export type ProjectFileLocatorBuilder = (projectId: string, name: string) => string;
+/** Returns the canvas key of a project file, `{scope}::{id}`; the scope keeps one file name in two projects apart. */
+export declare const toProjectPreviewKey: (scope: string, id: string) => string;
+/** Returns the card id behind a canvas key, or `undefined` when the key belongs to another scope or is not a project key. */
+export declare const fromProjectPreviewKey: (scope: string, key: string | undefined) => string | undefined;
+/** Returns the card id of an output in a project preview key, `artifacts/{name}`. */
+export declare const toProjectOutputCardId: (name: string) => string;
+/** Returns the output name behind a card id, or `undefined` when the card is not an output. */
+export declare const fromProjectOutputCardId: (cardId: string | undefined) => string | undefined;
+/** Returns the attachment for a file stored in a project; its `url` is the host-built locator the canvas content resolvers fetch like any DIAL file. */
+export declare const toStoredProjectFileAttachment: ({ id, name, contentType }: ProjectFileCard, projectId: string, toLocator: ProjectFileLocatorBuilder) => DisplayAttachment;
+/** Returns the attachment the project view opens in the canvas for one of its outputs; its `url` is the host-built output locator. */
+export declare const toProjectOutputAttachment: ({ name, contentType }: ProjectOutputItem, projectId: string, toLocator: ProjectFileLocatorBuilder) => DisplayAttachment;
+/** Returns the attachment a project form opens in the canvas for one of its cards: a file added in this session is its own attachment (it carries the `File`), a stored one is built from its project, and a stored file with no project yields `undefined`. */
+export declare const toProjectContextFileAttachment: (file: ProjectContextFile, projectId: string | null, toLocator: ProjectFileLocatorBuilder) => DisplayAttachment | undefined;
+//# sourceMappingURL=project-file-preview.d.ts.map

package/project/project-file-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-file-preview.d.ts","sourceRoot":"","sources":["../../src/project/project-file-preview.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,iBAAiB,EAGvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAMhC,yFAAyF;AACzF,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,EAAE,EAAE,MAAM,CAAC;IACX,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,gJAAgJ;AAChJ,MAAM,MAAM,yBAAyB,GAAG,CACtC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,KACT,MAAM,CAAC;AAEZ,sHAAsH;AACtH,eAAO,MAAM,mBAAmB,GAAI,OAAO,MAAM,EAAE,IAAI,MAAM,KAAG,MACvB,CAAC;AAE1C,6HAA6H;AAC7H,eAAO,MAAM,qBAAqB,GAChC,OAAO,MAAM,EACb,KAAK,MAAM,GAAG,SAAS,KACtB,MAAM,GAAG,SAGX,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,KAAG,MAClB,CAAC;AAEpC,+FAA+F;AAC/F,eAAO,MAAM,uBAAuB,GAClC,QAAQ,MAAM,GAAG,SAAS,KACzB,MAAM,GAAG,SAGG,CAAC;AAEhB,wJAAwJ;AACxJ,eAAO,MAAM,6BAA6B,GACxC,2BAA2B,eAAe,EAC1C,WAAW,MAAM,EACjB,WAAW,yBAAyB,KACnC,iBAOD,CAAC;AAEH,sIAAsI;AACtI,eAAO,MAAM,yBAAyB,GACpC,uBAAuB,iBAAiB,EACxC,WAAW,MAAM,EACjB,WAAW,yBAAyB,KACnC,iBAKA,CAAC;AAEJ,gQAAgQ;AAChQ,eAAO,MAAM,8BAA8B,GACzC,MAAM,kBAAkB,EACxB,WAAW,MAAM,GAAG,IAAI,EACxB,WAAW,yBAAyB,KACnC,iBAAiB,GAAG,SAKtB,CAAC"}

package/project/project-file-preview.js

@@ -0,0 +1,20 @@
+import { RequestStatus as e, getAttachmentTypeFromMime as t } from "@epam/ai-dial-chat-shared";
+import { isStoredContextFile as n } from "@epam/ai-dial-projects";
+//#region src/project/project-file-preview.ts
+var r = "::", i = "artifacts/", a = (e, t) => `${e}${r}${t}`, o = (e, t) => {
+	let n = `${e}${r}`;
+	return t?.startsWith(n) ? t.slice(n.length) : void 0;
+}, s = (e) => `${i}${e}`, c = (e) => e?.startsWith(i) ? e.slice(10) : void 0, l = ({ id: n, name: r, contentType: i }, a, o) => ({
+	id: n,
+	name: r,
+	contentType: i,
+	type: t(i),
+	status: e.Idle,
+	url: o(a, r)
+}), u = ({ name: e, contentType: t }, n, r) => l({
+	id: e,
+	name: e,
+	contentType: t
+}, n, r), d = (e, t, r) => n(e) ? t == null ? void 0 : l(e, t, r) : e;
+//#endregion
+export { c as fromProjectOutputCardId, o as fromProjectPreviewKey, d as toProjectContextFileAttachment, u as toProjectOutputAttachment, s as toProjectOutputCardId, a as toProjectPreviewKey, l as toStoredProjectFileAttachment };

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

@@ -0,0 +1,46 @@
+import { ProjectDetailsDto } from '@epam/ai-dial-chat-api-client';
+import { ProjectContextFile, ProjectCreateFormErrors, ProjectCreateFormValues } from '@epam/ai-dial-projects';
+import { Dispatch, SetStateAction } from 'react';
+/** Which project form a {@link useProjectDraft} draft backs. */
+export declare enum ProjectDraftMode {
+    /** The New project form: empty at the start, nothing stored yet. */
+    Create = "create",
+    /** The Edit project form: seeded from a loaded project. */
+    Edit = "edit"
+}
+/** Mode of a {@link useProjectDraft} draft, and the loaded project of an edit draft. */
+export type UseProjectDraftOptions = {
+    /** The New project form. */
+    mode: ProjectDraftMode.Create;
+} | {
+    /** The Edit project form. */
+    mode: ProjectDraftMode.Edit;
+    /** The loaded project, or `null` while none is; the draft is seeded once per its `contentVersion`. */
+    project: ProjectDetailsDto | null;
+};
+/** State and handlers of a project form draft. */
+export interface UseProjectDraftResult {
+    /** Name and instructions as typed. */
+    values: ProjectCreateFormValues;
+    /** The form's context file cards: stored files (edit mode) and files added in this session. */
+    contextFiles: ProjectContextFile[];
+    /** Field errors the host set, e.g. from a rejected request. */
+    errors: ProjectCreateFormErrors;
+    /** Sets the field errors, for a rejection the host maps to a field. */
+    setErrors: Dispatch<SetStateAction<ProjectCreateFormErrors>>;
+    /** Changes one text field; a change to the name clears its error. */
+    onFieldChange: <K extends keyof ProjectCreateFormValues>(field: K, value: ProjectCreateFormValues[K]) => void;
+    /** Replaces the context file cards and clears the context error. */
+    onContextFilesChange: (files: ProjectContextFile[]) => void;
+    /** Whether the draft is ready to submit: always in create mode, once seeded from the loaded project in edit mode. */
+    isSeeded: boolean;
+    /** Whether the draft holds edits that leaving would discard. */
+    isDirty: boolean;
+    /** Names of stored files the user removed (edit mode); empty in create mode. */
+    removedFileNames: string[];
+    /** Files added in this session, not yet stored. */
+    newFiles: File[];
+}
+/** Owns the form state of the New project and Edit project pages: values, context files, field errors, dirtiness, and the removed and new files a save sends. */
+export declare const useProjectDraft: (options: UseProjectDraftOptions) => UseProjectDraftResult;
+//# sourceMappingURL=use-project-draft.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-project-draft.d.ts","sourceRoot":"","sources":["../../src/project/use-project-draft.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAKL,KAAK,QAAQ,EACb,KAAK,cAAc,EACpB,MAAM,OAAO,CAAC;AAGf,gEAAgE;AAChE,oBAAY,gBAAgB;IAC1B,oEAAoE;IACpE,MAAM,WAAW;IACjB,2DAA2D;IAC3D,IAAI,SAAS;CACd;AAED,wFAAwF;AACxF,MAAM,MAAM,sBAAsB,GAC9B;IACE,4BAA4B;IAC5B,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC;CAC/B,GACD;IACE,6BAA6B;IAC7B,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC;IAC5B,sGAAsG;IACtG,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACnC,CAAC;AAEN,kDAAkD;AAClD,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,MAAM,EAAE,uBAAuB,CAAC;IAChC,+FAA+F;IAC/F,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,+DAA+D;IAC/D,MAAM,EAAE,uBAAuB,CAAC;IAChC,uEAAuE;IACvE,SAAS,EAAE,QAAQ,CAAC,cAAc,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAC7D,qEAAqE;IACrE,aAAa,EAAE,CAAC,CAAC,SAAS,MAAM,uBAAuB,EACrD,KAAK,EAAE,CAAC,EACR,KAAK,EAAE,uBAAuB,CAAC,CAAC,CAAC,KAC9B,IAAI,CAAC;IACV,oEAAoE;IACpE,oBAAoB,EAAE,CAAC,KAAK,EAAE,kBAAkB,EAAE,KAAK,IAAI,CAAC;IAC5D,qHAAqH;IACrH,QAAQ,EAAE,OAAO,CAAC;IAClB,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB,gFAAgF;IAChF,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,mDAAmD;IACnD,QAAQ,EAAE,IAAI,EAAE,CAAC;CAClB;AAKD,iKAAiK;AACjK,eAAO,MAAM,eAAe,GAC1B,SAAS,sBAAsB,KAC9B,qBA4FF,CAAC"}

package/project/use-project-draft.js

@@ -0,0 +1,54 @@
+import { mapStoredContextFiles as e } from "./project-mapping.js";
+import { useCallback as t, useEffect as n, useMemo as r, useState as i } from "react";
+import { isStoredContextFile as a } from "@epam/ai-dial-projects";
+//#region src/project/use-project-draft.ts
+var o = /* @__PURE__ */ function(e) {
+	return e.Create = "create", e.Edit = "edit", e;
+}({}), s = {
+	name: "",
+	instructions: ""
+}, c = [], l = (o) => {
+	let l = o.mode === "edit" ? o.project : null, u = o.mode === "edit", [d, f] = i(s), [p, m] = i(c), [h, g] = i({}), [_, v] = i(null);
+	n(() => {
+		u && l != null && l.contentVersion !== _ && (f({
+			name: l.name,
+			instructions: l.instructions
+		}), m(e(l)), g({}), v(l.contentVersion));
+	}, [
+		u,
+		l,
+		_
+	]);
+	let y = r(() => {
+		if (l == null) return [];
+		let e = new Set(p.filter(a).map((e) => e.name));
+		return l.contextFiles.map((e) => e.name).filter((t) => !e.has(t));
+	}, [l, p]), b = r(() => p.flatMap((e) => a(e) ? [] : [e.file]), [p]), x = !u || l != null && _ === l.contentVersion, S = u ? l != null && x && (d.name !== l.name || d.instructions !== l.instructions || y.length > 0 || b.length > 0) : d.name !== "" || d.instructions !== "" || p.length > 0;
+	return {
+		values: d,
+		contextFiles: p,
+		errors: h,
+		setErrors: g,
+		onFieldChange: t((e, t) => {
+			f((n) => ({
+				...n,
+				[e]: t
+			})), e === "name" && g((e) => e.name ? {
+				...e,
+				name: void 0
+			} : e);
+		}, []),
+		onContextFilesChange: t((e) => {
+			m(e), g((e) => e.context ? {
+				...e,
+				context: void 0
+			} : e);
+		}, []),
+		isSeeded: x,
+		isDirty: S,
+		removedFileNames: y,
+		newFiles: b
+	};
+};
+//#endregion
+export { o as ProjectDraftMode, l as useProjectDraft };

package/project/use-project-file-preview.d.ts

@@ -0,0 +1,42 @@
+import { DisplayAttachment } from '@epam/ai-dial-chat-shared';
+/** Tells whether the request that produced a result may still show it; `false` once a newer request superseded it. */
+export type ProjectPreviewCommitGuard = () => boolean;
+/** Opens an attachment in the host's canvas under a key, showing it only while the guard allows; the host's `openAttachmentCanvas` fits. */
+export type OpenProjectPreviewAttachment = (attachment: DisplayAttachment, canvasAttachmentId: string, shouldCommit: ProjectPreviewCommitGuard) => unknown;
+/** Host canvas operations and card lookups for the project file preview. */
+export interface UseProjectFilePreviewOptions {
+    /** Id of the project the page shows, or a fixed value before it exists; it keeps one file name in two projects apart. */
+    scope: string;
+    /** Id of the attachment the canvas holds now, or `undefined` when it is closed. */
+    attachmentId: string | undefined;
+    /** Opens an attachment in the canvas under a key. */
+    openAttachment: OpenProjectPreviewAttachment;
+    /** Closes the canvas. */
+    closeCanvas: () => void;
+    /** Starts a canvas request and returns the guard that says whether it is still the latest. */
+    startRequest: () => ProjectPreviewCommitGuard;
+    /** Returns the attachment to open for a context card id, or `undefined` for a card the page does not hold; it should keep its identity while the cards are unchanged. */
+    resolveContextAttachment: (cardId: string) => DisplayAttachment | undefined;
+    /** Returns the attachment to open for an output name; omit it where outputs are not shown. */
+    resolveOutputAttachment?: (name: string) => DisplayAttachment | undefined;
+}
+/** Selection state and stable card callbacks of the project file preview. */
+export interface UseProjectFilePreviewResult {
+    /** Card id of the open project file, an output's card id included, or `undefined` when none of this scope is open. */
+    selectedCardId: string | undefined;
+    /** Card id of the open context file; `undefined` while an output or nothing is open. */
+    selectedContextFileId: string | undefined;
+    /** Name of the open output; `undefined` while a context file or nothing is open. */
+    selectedOutputName: string | undefined;
+    /** Opens a context card, or closes the canvas when that card is already open. */
+    onContextFileClick: (cardId: string) => void;
+    /** Opens an output, or closes the canvas when that output is already open. */
+    onOutputClick: (name: string) => void;
+    /** Closes the canvas when the open context card is no longer among the page's cards. */
+    closeIfRemoved: (cards: readonly {
+        id: string;
+    }[]) => void;
+}
+/** Opens project files in the host's attachment canvas for the New project, Edit project and project view pages, deriving the selected card from the canvas. */
+export declare const useProjectFilePreview: ({ scope, attachmentId, openAttachment, closeCanvas, startRequest, resolveContextAttachment, resolveOutputAttachment, }: UseProjectFilePreviewOptions) => UseProjectFilePreviewResult;
+//# sourceMappingURL=use-project-file-preview.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-project-file-preview.d.ts","sourceRoot":"","sources":["../../src/project/use-project-file-preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AASnE,sHAAsH;AACtH,MAAM,MAAM,yBAAyB,GAAG,MAAM,OAAO,CAAC;AAEtD,4IAA4I;AAC5I,MAAM,MAAM,4BAA4B,GAAG,CACzC,UAAU,EAAE,iBAAiB,EAC7B,kBAAkB,EAAE,MAAM,EAC1B,YAAY,EAAE,yBAAyB,KACpC,OAAO,CAAC;AAEb,4EAA4E;AAC5E,MAAM,WAAW,4BAA4B;IAC3C,yHAAyH;IACzH,KAAK,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,qDAAqD;IACrD,cAAc,EAAE,4BAA4B,CAAC;IAC7C,yBAAyB;IACzB,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,8FAA8F;IAC9F,YAAY,EAAE,MAAM,yBAAyB,CAAC;IAC9C,yKAAyK;IACzK,wBAAwB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,iBAAiB,GAAG,SAAS,CAAC;IAC5E,8FAA8F;IAC9F,uBAAuB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,iBAAiB,GAAG,SAAS,CAAC;CAC3E;AAED,6EAA6E;AAC7E,MAAM,WAAW,2BAA2B;IAC1C,sHAAsH;IACtH,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,wFAAwF;IACxF,qBAAqB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,oFAAoF;IACpF,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,iFAAiF;IACjF,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,8EAA8E;IAC9E,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,wFAAwF;IACxF,cAAc,EAAE,CAAC,KAAK,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,KAAK,IAAI,CAAC;CAC5D;AAED,gKAAgK;AAChK,eAAO,MAAM,qBAAqB,GAAI,wHAQnC,4BAA4B,KAAG,2BA6EjC,CAAC"}

package/project/use-project-file-preview.js

@@ -0,0 +1,46 @@
+import { fromProjectOutputCardId as e, fromProjectPreviewKey as t, toProjectOutputCardId as n, toProjectPreviewKey as r } from "./project-file-preview.js";
+import { useCallback as i } from "react";
+//#region src/project/use-project-file-preview.ts
+var a = ({ scope: a, attachmentId: o, openAttachment: s, closeCanvas: c, startRequest: l, resolveContextAttachment: u, resolveOutputAttachment: d }) => {
+	let f = t(a, o), p = e(f), m = p == null ? f : void 0;
+	return {
+		selectedCardId: f,
+		selectedContextFileId: m,
+		selectedOutputName: p,
+		onContextFileClick: i((e) => {
+			if (e === m) {
+				c();
+				return;
+			}
+			let t = u(e);
+			t && s(t, r(a, e), l());
+		}, [
+			c,
+			s,
+			u,
+			a,
+			m,
+			l
+		]),
+		onOutputClick: i((e) => {
+			if (e === p) {
+				c();
+				return;
+			}
+			let t = d?.(e);
+			t && s(t, r(a, n(e)), l());
+		}, [
+			c,
+			s,
+			d,
+			a,
+			p,
+			l
+		]),
+		closeIfRemoved: i((e) => {
+			m != null && !e.some((e) => e.id === m) && c();
+		}, [c, m])
+	};
+};
+//#endregion
+export { a as useProjectFilePreview };

package/project.js

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

package/shared/sleep.d.ts

@@ -0,0 +1,3 @@
+/** Resolves after `ms`, or immediately once `signal` aborts; a signal that is already aborted sets no timer. */
+export declare const sleep: (ms: number, signal: AbortSignal) => Promise<void>;
+//# sourceMappingURL=sleep.d.ts.map

package/shared/sleep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../src/shared/sleep.ts"],"names":[],"mappings":"AAAA,gHAAgH;AAChH,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,EAAE,QAAQ,WAAW,KAAG,OAAO,CAAC,IAAI,CAehE,CAAC"}

package/shared/sleep.js

@@ -0,0 +1,13 @@
+//#region src/shared/sleep.ts
+var e = (e, t) => new Promise((n) => {
+	if (t.aborted) {
+		n();
+		return;
+	}
+	let r = setTimeout(n, e);
+	t.addEventListener("abort", () => {
+		clearTimeout(r), n();
+	}, { once: !0 });
+});
+//#endregion
+export { e as sleep };