@epam/ai-dial-chat-api-client 1.3.0-dev.252 → 1.3.0-dev.256

package/generated/src/apis/ProjectsApi.js

@@ -19,6 +19,51 @@ const runtime = require("../runtime");
  *
  */
 class ProjectsApi extends runtime.BaseAPI {
+    /**
+     * Replays the active generation of a project conversation as SSE, exactly as `POST /api/v1/conversations/completions/attach` does.
+     * Attach to a generation of a project conversation
+     */
+    async attachToProjectGenerationRaw(requestParameters, initOverrides) {
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling attachToProjectGeneration().');
+        }
+        if (requestParameters['attachGenerationDto'] == null) {
+            throw new runtime.RequiredError('attachGenerationDto', 'Required parameter "attachGenerationDto" was null or undefined when calling attachToProjectGeneration().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        headerParameters['Content-Type'] = 'application/json';
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token('bearer', []);
+            if (tokenString) {
+                headerParameters['Authorization'] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/api/v1/projects/{id}/conversations/completions/attach`;
+        urlPath = urlPath.replace(`{${'id'}}`, encodeURIComponent(String(requestParameters['id'])));
+        const response = await this.request({
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: requestParameters['attachGenerationDto'],
+        }, initOverrides);
+        if (this.isJsonMime(response.headers.get('content-type'))) {
+            return new runtime.JSONApiResponse(response);
+        }
+        else {
+            return new runtime.TextApiResponse(response);
+        }
+    }
+    /**
+     * Replays the active generation of a project conversation as SSE, exactly as `POST /api/v1/conversations/completions/attach` does.
+     * Attach to a generation of a project conversation
+     */
+    async attachToProjectGeneration(requestParameters, initOverrides) {
+        const response = await this.attachToProjectGenerationRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
     /**
      * Creates a project at the root of the session user\'s bucket in one atomic, create-only DIAL Core call. The BFF writes PROJECT.md (YAML frontmatter with name and description, instructions as the body) and each context file under context/. Name, file names, types, per-file size, total size and file count are validated first; every domain rejection carries a ProjectCreateErrorCode.
      * Create a project
@@ -87,7 +132,47 @@ class ProjectsApi extends runtime.BaseAPI {
         return await response.value();
     }
     /**
-     * Deletes the project only if it is still the version named by `If-Match`, then removes it from the caller\'s pins. Only a project in the caller\'s own bucket can be deleted.
+     * Creates a conversation inside the project from its first message, as `POST /api/v1/conversations` does at the top level.
+     * Create a project conversation
+     */
+    async createProjectConversationRaw(requestParameters, initOverrides) {
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling createProjectConversation().');
+        }
+        if (requestParameters['createConversationDto'] == null) {
+            throw new runtime.RequiredError('createConversationDto', 'Required parameter "createConversationDto" was null or undefined when calling createProjectConversation().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        headerParameters['Content-Type'] = 'application/json';
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token('bearer', []);
+            if (tokenString) {
+                headerParameters['Authorization'] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/api/v1/projects/{id}/conversations`;
+        urlPath = urlPath.replace(`{${'id'}}`, encodeURIComponent(String(requestParameters['id'])));
+        const response = await this.request({
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: requestParameters['createConversationDto'],
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response);
+    }
+    /**
+     * Creates a conversation inside the project from its first message, as `POST /api/v1/conversations` does at the top level.
+     * Create a project conversation
+     */
+    async createProjectConversation(requestParameters, initOverrides) {
+        const response = await this.createProjectConversationRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Deletes the project, its conversations included, only if its content is still the `contentVersion` named by `If-Match`, then removes it from the caller\'s pins. Only a project in the caller\'s own bucket can be deleted.
      * Delete a project
      */
     async deleteProjectRaw(requestParameters, initOverrides) {
@@ -120,12 +205,48 @@ class ProjectsApi extends runtime.BaseAPI {
         return new runtime.VoidApiResponse(response);
     }
     /**
-     * Deletes the project only if it is still the version named by `If-Match`, then removes it from the caller\'s pins. Only a project in the caller\'s own bucket can be deleted.
+     * Deletes the project, its conversations included, only if its content is still the `contentVersion` named by `If-Match`, then removes it from the caller\'s pins. Only a project in the caller\'s own bucket can be deleted.
      * Delete a project
      */
     async deleteProject(requestParameters, initOverrides) {
         await this.deleteProjectRaw(requestParameters, initOverrides);
     }
+    /**
+     * Delete a project conversation
+     */
+    async deleteProjectConversationRaw(requestParameters, initOverrides) {
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling deleteProjectConversation().');
+        }
+        if (requestParameters['conversationName'] == null) {
+            throw new runtime.RequiredError('conversationName', 'Required parameter "conversationName" was null or undefined when calling deleteProjectConversation().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token('bearer', []);
+            if (tokenString) {
+                headerParameters['Authorization'] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/api/v1/projects/{id}/conversations/{conversationName}`;
+        urlPath = urlPath.replace(`{${'id'}}`, encodeURIComponent(String(requestParameters['id'])));
+        urlPath = urlPath.replace(`{${'conversationName'}}`, encodeURIComponent(String(requestParameters['conversationName'])));
+        const response = await this.request({
+            path: urlPath,
+            method: 'DELETE',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+        return new runtime.VoidApiResponse(response);
+    }
+    /**
+     * Delete a project conversation
+     */
+    async deleteProjectConversation(requestParameters, initOverrides) {
+        await this.deleteProjectConversationRaw(requestParameters, initOverrides);
+    }
     /**
      * Streams DIAL Core\'s archive of the whole project (`PROJECT.md` and `context/`) as an attachment.
      * Download a project as a ZIP archive
@@ -235,6 +356,84 @@ class ProjectsApi extends runtime.BaseAPI {
         const response = await this.getProjectRaw(requestParameters, initOverrides);
         return await response.value();
     }
+    /**
+     * Get a project conversation
+     */
+    async getProjectConversationRaw(requestParameters, initOverrides) {
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling getProjectConversation().');
+        }
+        if (requestParameters['conversationName'] == null) {
+            throw new runtime.RequiredError('conversationName', 'Required parameter "conversationName" was null or undefined when calling getProjectConversation().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token('bearer', []);
+            if (tokenString) {
+                headerParameters['Authorization'] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/api/v1/projects/{id}/conversations/{conversationName}`;
+        urlPath = urlPath.replace(`{${'id'}}`, encodeURIComponent(String(requestParameters['id'])));
+        urlPath = urlPath.replace(`{${'conversationName'}}`, encodeURIComponent(String(requestParameters['conversationName'])));
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response);
+    }
+    /**
+     * Get a project conversation
+     */
+    async getProjectConversation(requestParameters, initOverrides) {
+        const response = await this.getProjectConversationRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Lists the conversations stored in the project\'s `conversations/` folder, newest first, with their titles and authors.
+     * List a project\'s conversations
+     */
+    async listProjectConversationsRaw(requestParameters, initOverrides) {
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling listProjectConversations().');
+        }
+        const queryParameters = {};
+        if (requestParameters['limit'] != null) {
+            queryParameters['limit'] = requestParameters['limit'];
+        }
+        if (requestParameters['offset'] != null) {
+            queryParameters['offset'] = requestParameters['offset'];
+        }
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token('bearer', []);
+            if (tokenString) {
+                headerParameters['Authorization'] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/api/v1/projects/{id}/conversations`;
+        urlPath = urlPath.replace(`{${'id'}}`, encodeURIComponent(String(requestParameters['id'])));
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response);
+    }
+    /**
+     * Lists the conversations stored in the project\'s `conversations/` folder, newest first, with their titles and authors.
+     * List a project\'s conversations
+     */
+    async listProjectConversations(requestParameters, initOverrides) {
+        const response = await this.listProjectConversationsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
     /**
      * Returns every DIAL project visible to the session user: the user\'s own bucket, the public (organization) bucket, and projects shared with the user, merged and de-duplicated by id. The BFF follows DIAL Core paging itself, so the list is complete up to a per-source page cap. A failing source is omitted; the request fails only when both bucket listings fail.
      * List projects
@@ -267,7 +466,177 @@ class ProjectsApi extends runtime.BaseAPI {
         return await response.value();
     }
     /**
-     * Saves the name, description, instructions and context of a project in one conditional DIAL Core write: the BFF rebuilds PROJECT.md, keeps every stored context file not listed in `removedFileNames`, adds the `files` parts and writes the whole project with `If-Match`. A different name then moves the project in its folder and keeps the caller\'s pin. Only a project in the caller\'s own bucket can be saved. Every domain rejection carries a ProjectCreateErrorCode.
+     * Rewrites the conversation\'s display name; its file name does not change.
+     * Rename a project conversation
+     */
+    async renameProjectConversationRaw(requestParameters, initOverrides) {
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling renameProjectConversation().');
+        }
+        if (requestParameters['conversationName'] == null) {
+            throw new runtime.RequiredError('conversationName', 'Required parameter "conversationName" was null or undefined when calling renameProjectConversation().');
+        }
+        if (requestParameters['renameConversationBodyDto'] == null) {
+            throw new runtime.RequiredError('renameConversationBodyDto', 'Required parameter "renameConversationBodyDto" was null or undefined when calling renameProjectConversation().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        headerParameters['Content-Type'] = 'application/json';
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token('bearer', []);
+            if (tokenString) {
+                headerParameters['Authorization'] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/api/v1/projects/{id}/conversations/{conversationName}`;
+        urlPath = urlPath.replace(`{${'id'}}`, encodeURIComponent(String(requestParameters['id'])));
+        urlPath = urlPath.replace(`{${'conversationName'}}`, encodeURIComponent(String(requestParameters['conversationName'])));
+        const response = await this.request({
+            path: urlPath,
+            method: 'PATCH',
+            headers: headerParameters,
+            query: queryParameters,
+            body: requestParameters['renameConversationBodyDto'],
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response);
+    }
+    /**
+     * Rewrites the conversation\'s display name; its file name does not change.
+     * Rename a project conversation
+     */
+    async renameProjectConversation(requestParameters, initOverrides) {
+        const response = await this.renameProjectConversationRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Overwrites the conversation body, never over a pending background answer, as `PUT /api/v1/conversations` does.
+     * Save a project conversation
+     */
+    async saveProjectConversationRaw(requestParameters, initOverrides) {
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling saveProjectConversation().');
+        }
+        if (requestParameters['conversationName'] == null) {
+            throw new runtime.RequiredError('conversationName', 'Required parameter "conversationName" was null or undefined when calling saveProjectConversation().');
+        }
+        if (requestParameters['saveConversationBodyDto'] == null) {
+            throw new runtime.RequiredError('saveConversationBodyDto', 'Required parameter "saveConversationBodyDto" was null or undefined when calling saveProjectConversation().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        headerParameters['Content-Type'] = 'application/json';
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token('bearer', []);
+            if (tokenString) {
+                headerParameters['Authorization'] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/api/v1/projects/{id}/conversations/{conversationName}`;
+        urlPath = urlPath.replace(`{${'id'}}`, encodeURIComponent(String(requestParameters['id'])));
+        urlPath = urlPath.replace(`{${'conversationName'}}`, encodeURIComponent(String(requestParameters['conversationName'])));
+        const response = await this.request({
+            path: urlPath,
+            method: 'PUT',
+            headers: headerParameters,
+            query: queryParameters,
+            body: requestParameters['saveConversationBodyDto'],
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response);
+    }
+    /**
+     * Overwrites the conversation body, never over a pending background answer, as `PUT /api/v1/conversations` does.
+     * Save a project conversation
+     */
+    async saveProjectConversation(requestParameters, initOverrides) {
+        const response = await this.saveProjectConversationRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Stop a generation of a project conversation
+     */
+    async stopProjectCompletionRaw(requestParameters, initOverrides) {
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling stopProjectCompletion().');
+        }
+        if (requestParameters['stopCompletionDto'] == null) {
+            throw new runtime.RequiredError('stopCompletionDto', 'Required parameter "stopCompletionDto" was null or undefined when calling stopProjectCompletion().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        headerParameters['Content-Type'] = 'application/json';
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token('bearer', []);
+            if (tokenString) {
+                headerParameters['Authorization'] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/api/v1/projects/{id}/conversations/completions/stop`;
+        urlPath = urlPath.replace(`{${'id'}}`, encodeURIComponent(String(requestParameters['id'])));
+        const response = await this.request({
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: requestParameters['stopCompletionDto'],
+        }, initOverrides);
+        return new runtime.VoidApiResponse(response);
+    }
+    /**
+     * Stop a generation of a project conversation
+     */
+    async stopProjectCompletion(requestParameters, initOverrides) {
+        await this.stopProjectCompletionRaw(requestParameters, initOverrides);
+    }
+    /**
+     * Streams a completion as SSE exactly as `POST /api/v1/conversations/completions` does, with the `x-project-id` header on the model call and nothing else added to the request.
+     * Stream a completion of a project conversation
+     */
+    async streamProjectCompletionRaw(requestParameters, initOverrides) {
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling streamProjectCompletion().');
+        }
+        if (requestParameters['sendCompletionDto'] == null) {
+            throw new runtime.RequiredError('sendCompletionDto', 'Required parameter "sendCompletionDto" was null or undefined when calling streamProjectCompletion().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        headerParameters['Content-Type'] = 'application/json';
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token('bearer', []);
+            if (tokenString) {
+                headerParameters['Authorization'] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/api/v1/projects/{id}/conversations/completions`;
+        urlPath = urlPath.replace(`{${'id'}}`, encodeURIComponent(String(requestParameters['id'])));
+        const response = await this.request({
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: requestParameters['sendCompletionDto'],
+        }, initOverrides);
+        if (this.isJsonMime(response.headers.get('content-type'))) {
+            return new runtime.JSONApiResponse(response);
+        }
+        else {
+            return new runtime.TextApiResponse(response);
+        }
+    }
+    /**
+     * Streams a completion as SSE exactly as `POST /api/v1/conversations/completions` does, with the `x-project-id` header on the model call and nothing else added to the request.
+     * Stream a completion of a project conversation
+     */
+    async streamProjectCompletion(requestParameters, initOverrides) {
+        const response = await this.streamProjectCompletionRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Saves the name, description, instructions and context of a project in one conditional DIAL Core write: the BFF rebuilds PROJECT.md, keeps every stored context file not listed in `removedFileNames`, adds the `files` parts, carries the stored conversations over, and writes the whole project conditioned on the fresh snapshot\'s ETag, retrying a concurrent conversation write while `If-Match` still names the `contentVersion`. A different name then moves the project in its folder and keeps the caller\'s pin. Only a project in the caller\'s own bucket can be saved. Every domain rejection carries a ProjectCreateErrorCode.
      * Save a project edit
      */
     async updateProjectRaw(requestParameters, initOverrides) {
@@ -339,7 +708,7 @@ class ProjectsApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response);
     }
     /**
-     * Saves the name, description, instructions and context of a project in one conditional DIAL Core write: the BFF rebuilds PROJECT.md, keeps every stored context file not listed in `removedFileNames`, adds the `files` parts and writes the whole project with `If-Match`. A different name then moves the project in its folder and keeps the caller\'s pin. Only a project in the caller\'s own bucket can be saved. Every domain rejection carries a ProjectCreateErrorCode.
+     * Saves the name, description, instructions and context of a project in one conditional DIAL Core write: the BFF rebuilds PROJECT.md, keeps every stored context file not listed in `removedFileNames`, adds the `files` parts, carries the stored conversations over, and writes the whole project conditioned on the fresh snapshot\'s ETag, retrying a concurrent conversation write while `If-Match` still names the `contentVersion`. A different name then moves the project in its folder and keeps the caller\'s pin. Only a project in the caller\'s own bucket can be saved. Every domain rejection carries a ProjectCreateErrorCode.
      * Save a project edit
      */
     async updateProject(requestParameters, initOverrides) {

package/generated/src/models/index.d.ts

@@ -5930,6 +5930,62 @@ export interface ProjectContextFileDto {
      */
     size: number;
 }
+/**
+ *
+ * @export
+ * @interface ProjectConversationItemDto
+ */
+export interface ProjectConversationItemDto {
+    /**
+     * Locator of the conversation, `projects/{bucket}/{projectPath}/conversations/{name}`; it is the conversation id.
+     * @type {string}
+     * @memberof ProjectConversationItemDto
+     */
+    id: string;
+    /**
+     * File name under the project `conversations/` folder.
+     * @type {string}
+     * @memberof ProjectConversationItemDto
+     */
+    name: string;
+    /**
+     * Display title: the stored body's `name`, or the title derived from the file name when the body cannot be read.
+     * @type {string}
+     * @memberof ProjectConversationItemDto
+     */
+    title: string;
+    /**
+     * Display name of the conversation's last writer, from DIAL Core.
+     * @type {string}
+     * @memberof ProjectConversationItemDto
+     */
+    author?: string;
+    /**
+     * Last update time, in epoch milliseconds.
+     * @type {number}
+     * @memberof ProjectConversationItemDto
+     */
+    updatedAt?: number;
+}
+/**
+ *
+ * @export
+ * @interface ProjectConversationListResponseDto
+ */
+export interface ProjectConversationListResponseDto {
+    /**
+     * Conversations, newest first.
+     * @type {Array<ProjectConversationItemDto>}
+     * @memberof ProjectConversationListResponseDto
+     */
+    items: Array<ProjectConversationItemDto>;
+    /**
+     * Whether the project holds more conversations than `items`.
+     * @type {boolean}
+     * @memberof ProjectConversationListResponseDto
+     */
+    hasMore: boolean;
+}
 /**
  *
  * @export
@@ -5947,6 +6003,7 @@ export declare const ProjectCreateErrorCode: {
     readonly IfMatchRequired: "if-match-required";
     readonly ProjectTooLarge: "project-too-large";
     readonly UnknownFile: "unknown-file";
+    readonly ProjectStorageFull: "project-storage-full";
 };
 export type ProjectCreateErrorCode = (typeof ProjectCreateErrorCode)[keyof typeof ProjectCreateErrorCode];
 /**
@@ -6065,11 +6122,23 @@ export interface ProjectDetailsDto {
      */
     contextFiles: Array<ProjectContextFileDto>;
     /**
-     * Aggregate ETag of the version these details were read from; send it as `If-Match` on update and delete.
+     * Aggregate ETag of the version these details were read from. It changes on every write, project conversation writes included.
      * @type {string}
      * @memberof ProjectDetailsDto
      */
     etag: string;
+    /**
+     * Version of the project content (`PROJECT.md`, `context/` and every other non-conversation file). A conversation write leaves it unchanged. Send it as `If-Match` on update and delete.
+     * @type {string}
+     * @memberof ProjectDetailsDto
+     */
+    contentVersion: string;
+    /**
+     * Number of conversations stored in the project.
+     * @type {number}
+     * @memberof ProjectDetailsDto
+     */
+    conversationCount: number;
     /**
      * Whether the caller may edit, delete, share and publish the project — `true` only in the caller's own bucket.
      * @type {boolean}
@@ -9134,6 +9203,12 @@ export interface UserProfileDto {
      * @memberof UserProfileDto
      */
     isAdmin: boolean;
+    /**
+     * URL of the user's profile picture: the IdP's absolute http(s) `picture` claim, or the same-origin `GET /auth/me/picture` path when the IdP supplied the image inline. Omitted when there is no picture.
+     * @type {string}
+     * @memberof UserProfileDto
+     */
+    pictureUrl?: string;
 }
 /**
  *