From 383e42a8d20485b33b1a16cc40e86dda26092660 Mon Sep 17 00:00:00 2001
From: Hadi Khazaee Asl <hadi_khazaee_asl@yahoo.com>
Date: Tue, 29 Sep 2026 17:41:48 +0330
Subject: [PATCH] last ...

---
 Controllers/XAiServiceControllerBase.cs | 200 +++++++++++++++++++++++-
 Interfaces/IXAiServiceBase.cs           |  56 +++++++
 Interfaces/IXAiServiceControllerBase.cs |  57 ++++++-
 Providers/XAIServiceBase.cs             | 117 ++++++++++++++
 4 files changed, 422 insertions(+), 8 deletions(-)

diff --git a/Controllers/XAiServiceControllerBase.cs b/Controllers/XAiServiceControllerBase.cs
index 5518da3..85bf350 100644
--- a/Controllers/XAiServiceControllerBase.cs
+++ b/Controllers/XAiServiceControllerBase.cs
@@ -166,11 +166,11 @@ namespace xAiApi.Controllers
         //
         #region Data Provided Actions ...
         /// <summary>
-        /// Load AI Projects ...
+        /// Retrieve AI Projects ...
         /// </summary>
         /// <param name="cancellationToken"></param>
         /// <returns></returns>
-        [HttpGet("LoadProjects")]
+        [HttpGet("Projects")]
         public async Task<ActionResult<IEnumerable<XAiProjectDto>>> LoadProjects(
             CancellationToken cancellationToken = default
         )
@@ -178,9 +178,6 @@ namespace xAiApi.Controllers
             //
             try
             {
-                //
-                // Validate ...
-
                 //
                 var userInfo = await GetUserInfo();
                 var connectionId = GetConnectionId();
@@ -203,6 +200,199 @@ namespace xAiApi.Controllers
             }
         }
 
+        /// <summary>
+        /// Retrieve Specified AI Project's Conversations ...
+        /// </summary>
+        /// <param name="projectId"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        [HttpGet("Projects/{projectId}/Conversations")]
+        public async Task<ActionResult<IEnumerable<XAiConversationDto>>> LoadConversations(
+            [FromRoute] Guid projectId,
+            CancellationToken cancellationToken = default
+        )
+        {
+            //
+            try
+            {
+                //
+                // Validate ...
+                if (projectId.IsDefaultGuid())
+                {
+                    XException.InvalidArgs.Throw();
+                }
+
+                //
+                var userInfo = await GetUserInfo();
+                var connectionId = GetConnectionId();
+
+                //
+                var result = await aiService.LoadConversations(
+                    projectId: projectId,
+                    connectionId: connectionId,
+                    cancellationToken: cancellationToken
+                );
+
+                //
+                return Ok(result);
+            }
+            catch (Exception ex)
+            {
+                //
+                var result = GetExceptionActionResult(ex);
+                return result;
+            }
+        }
+
+        /// <summary>
+        /// Retrieve Specified AI Conversation's Messages ...
+        /// </summary>
+        /// <param name="conversationId"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        [HttpGet("Conversations/{conversationId}/Messages")]
+        public async Task<ActionResult<IEnumerable<XAiMessageDto>>> LoadMessages(
+            [FromRoute] Guid conversationId,
+            CancellationToken cancellationToken = default
+        )
+        {
+            //
+            try
+            {
+                //
+                // Validate ...
+                if (conversationId.IsDefaultGuid())
+                {
+                    XException.InvalidArgs.Throw();
+                }
+
+                //
+                var result = await aiService.LoadMessages(
+                    conversationId: conversationId,
+                    cancellationToken: cancellationToken
+                );
+
+                //
+                return Ok(result);
+            }
+            catch (Exception ex)
+            {
+                //
+                var result = GetExceptionActionResult(ex);
+                return result;
+            }
+        }
+
+        /// <summary>
+        /// Create an AI Project ...
+        /// </summary>
+        /// <param name="item"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        [HttpPost("Projects")]
+        public async Task<ActionResult<XAiProjectDto>> CreateProject(
+            [FromBody] XAiProjectDto item,
+            CancellationToken cancellationToken = default
+        )
+        {
+            //
+            try
+            {
+                //
+                // Validate ...
+                if (item.IsNullOrDefault())
+                {
+                    XException.InvalidArgs.Throw();
+                }
+
+                //
+                var userInfo = await GetUserInfo();
+                var connectionId = GetConnectionId();
+
+                //
+                // Update Required Params ...
+                item.OwnerId = userInfo.UserId;
+                if (!item.IsValidForAddOrUpdate())
+                {
+                    XException.InvalidData.Throw();
+                }
+
+                //
+                var result = await aiService.CreateProject(
+                    item: item,
+                    ownerId: userInfo.UserId,
+                    connectionId: connectionId,
+                    cancellationToken: cancellationToken
+                );
+
+                //
+                return Ok(result);
+            }
+            catch (Exception ex)
+            {
+                //
+                var result = GetExceptionActionResult(ex);
+                return result;
+            }            
+        }
+
+        /// <summary>
+        /// Create an AI Conversation ...
+        /// </summary>
+        /// <param name="projectId"></param>
+        /// <param name="item"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        [HttpPost("Projects/{projectId}/Conversations")]
+        public async Task<ActionResult<XAiConversationDto>> CreateConversation(
+            [FromRoute] Guid projectId,
+            [FromBody] XAiConversationDto item,
+            CancellationToken cancellationToken = default
+        )
+        {
+            //
+            try
+            {
+                //
+                // Validate ...
+                if (projectId.IsDefaultGuid() || 
+                    item.IsNullOrDefault())
+                {
+                    XException.InvalidArgs.Throw();
+                }
+
+                //
+                var userInfo = await GetUserInfo();
+                var connectionId = GetConnectionId();
+
+                //
+                // Update Required Params ...
+                item.OwnerId = userInfo.UserId;
+                if (!item.IsValidForAddOrUpdate())
+                {
+                    XException.InvalidData.Throw();
+                }
+
+                //
+                var result = await aiService.CreateConversation(
+                    item: item,
+                    projectId: projectId,
+                    ownerId: userInfo.UserId,
+                    connectionId: connectionId,
+                    cancellationToken: cancellationToken
+                );
+
+                //
+                return Ok(result);
+            }
+            catch (Exception ex)
+            {
+                //
+                var result = GetExceptionActionResult(ex);
+                return result;
+            }                        
+        }
+
         /// <summary>
         /// Ask Question and Get Response ...
         /// </summary>
diff --git a/Interfaces/IXAiServiceBase.cs b/Interfaces/IXAiServiceBase.cs
index c590aa7..7869fb4 100644
--- a/Interfaces/IXAiServiceBase.cs
+++ b/Interfaces/IXAiServiceBase.cs
@@ -100,6 +100,62 @@ namespace xAiApi.Interfaces
             CancellationToken cancellationToken = default
         );
 
+        /// <summary>
+        /// Load Conversations of Specified AI Project ...
+        /// </summary>
+        /// <param name="projectId"></param>
+        /// <param name="connectionId"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        Task<IEnumerable<XAiConversationDto>> LoadConversations(
+            Guid projectId,
+            string connectionId = null,
+            CancellationToken cancellationToken = default
+        );
+
+        /// <summary>
+        /// Load Messages of Specified Conversation ...
+        /// </summary>
+        /// <param name="conversationId"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        Task<IEnumerable<XAiMessageDto>> LoadMessages(
+            Guid conversationId,
+            CancellationToken cancellationToken = default
+        );
+
+        /// <summary>
+        /// Create an AI Project ...
+        /// </summary>
+        /// <param name="ownerId"></param>
+        /// <param name="item"></param>
+        /// <param name="connectionId"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        Task<XAiProjectDto> CreateProject(
+            string ownerId,
+            XAiProjectDto item,
+            string connectionId = null,
+            CancellationToken cancellationToken = default
+        );
+
+        /// <summary>
+        /// Create an AI Conversation ...
+        /// </summary>
+        /// <param name="ownerId"></param>
+        /// <param name="projectId"></param>
+        /// <param name="item"></param>
+        /// <param name="connectionId"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        Task<XAiConversationDto> CreateConversation(
+            string ownerId,
+            Guid projectId,
+            XAiConversationDto item,
+            string connectionId = null,
+            CancellationToken cancellationToken = default
+        );
+
         /// <summary>
         /// Ask a Question as Prompt and Retrieve Response ...
         /// </summary>
diff --git a/Interfaces/IXAiServiceControllerBase.cs b/Interfaces/IXAiServiceControllerBase.cs
index 848889e..c733f1f 100644
--- a/Interfaces/IXAiServiceControllerBase.cs
+++ b/Interfaces/IXAiServiceControllerBase.cs
@@ -1,3 +1,4 @@
+using System;
 using System.Threading;
 using xAiModels.Models;
 using xAiModels.Models.Dtos;
@@ -39,15 +40,65 @@ namespace xAiApi.Interfaces
         //
         #region Data Provided Actions ...
         /// <summary>
-        /// Load AI Projects ...
+        /// Retrieve AI Projects ...
         /// </summary>
         /// <param name="cancellationToken"></param>
         /// <returns></returns>
-        [HttpGet("LoadProjects")]
+        [HttpGet("Projects")]
         Task<ActionResult<IEnumerable<XAiProjectDto>>> LoadProjects(
             CancellationToken cancellationToken = default
         );
-        
+
+        /// <summary>
+        /// Retrieve Specified AI Project's Conversations ...
+        /// </summary>
+        /// <param name="projectId"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        [HttpGet("Projects/{projectId}/Conversations")]
+        Task<ActionResult<IEnumerable<XAiConversationDto>>> LoadConversations(
+            [FromRoute] Guid projectId,
+            CancellationToken cancellationToken = default
+        );
+
+        /// <summary>
+        /// Retrieve Specified AI Conversation's Messages ...
+        /// </summary>
+        /// <param name="conversationId"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        [HttpGet("Conversations/{conversationId}/Messages")]
+        Task<ActionResult<IEnumerable<XAiMessageDto>>> LoadMessages(
+            [FromRoute] Guid conversationId,
+            CancellationToken cancellationToken = default
+        );
+
+        /// <summary>
+        /// Create an AI Project ...
+        /// </summary>
+        /// <param name="item"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        [HttpPost("Projects")]
+        Task<ActionResult<XAiProjectDto>> CreateProject(
+            [FromBody] XAiProjectDto item,
+            CancellationToken cancellationToken = default
+        );
+
+        /// <summary>
+        /// Create an AI Conversation ...
+        /// </summary>
+        /// <param name="projectId"></param>
+        /// <param name="item"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        [HttpPost("Projects/{projectId}/Conversations")]
+        Task<ActionResult<XAiConversationDto>> CreateConversation(
+            [FromRoute] Guid projectId,
+            [FromBody] XAiConversationDto item,
+            CancellationToken cancellationToken = default
+        );
+
         /// <summary>
         /// Ask Question and Get Response ...
         /// </summary>
diff --git a/Providers/XAIServiceBase.cs b/Providers/XAIServiceBase.cs
index 839a39f..63acec0 100644
--- a/Providers/XAIServiceBase.cs
+++ b/Providers/XAIServiceBase.cs
@@ -413,6 +413,123 @@ namespace xAiApi.Providers
             return result;
         }
 
+        /// <summary>
+        /// Load Conversations of Specified AI Project ...
+        /// </summary>
+        /// <param name="projectId"></param>
+        /// <param name="connectionId"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public async Task<IEnumerable<XAiConversationDto>> LoadConversations(
+            Guid projectId,
+            string connectionId = null,
+            CancellationToken cancellationToken = default
+        )
+        {
+            //
+            // Validate Args ...
+            if (projectId.IsDefaultGuid())
+            {
+                XException.InvalidArgs.Throw();
+            }
+
+            //
+            var result = await dataProvider.LoadConversations(
+                fillMessages: false,
+                projectId: projectId,
+                connectionId: connectionId,
+                cancellationToken: cancellationToken
+            );
+
+            //
+            return result;
+        }
+
+        /// <summary>
+        /// Load Messages of Specified Conversation ...
+        /// </summary>
+        /// <param name="conversationId"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public async Task<IEnumerable<XAiMessageDto>> LoadMessages(
+            Guid conversationId,
+            CancellationToken cancellationToken = default
+        )
+        {
+            //
+            // Validate Args ...
+            if (conversationId.IsDefaultGuid())
+            {
+                XException.InvalidArgs.Throw();
+            }
+
+            //
+            var result = await dataProvider.LoadMessages(
+                conversationId: conversationId,
+                cancellationToken: cancellationToken
+            );
+
+            //
+            return result;            
+        }
+
+        /// <summary>
+        /// Create an AI Project ...
+        /// </summary>
+        /// <param name="ownerId"></param>
+        /// <param name="item"></param>
+        /// <param name="connectionId"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public async Task<XAiProjectDto> CreateProject(
+            string ownerId,
+            XAiProjectDto item,
+            string connectionId = null,
+            CancellationToken cancellationToken = default
+        )
+        {
+            //
+            var result = await dataProvider.CreateProject(
+                item: item,
+                ownerId: ownerId,
+                connectionId: connectionId,
+                cancellationToken: cancellationToken
+            );
+
+            //
+            return result;
+        }
+
+        /// <summary>
+        /// Create an AI Conversation ...
+        /// </summary>
+        /// <param name="ownerId"></param>
+        /// <param name="projectId"></param>
+        /// <param name="item"></param>
+        /// <param name="connectionId"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public async Task<XAiConversationDto> CreateConversation(
+            string ownerId,
+            Guid projectId,
+            XAiConversationDto item,
+            string connectionId = null,
+            CancellationToken cancellationToken = default
+        )
+        {
+            //
+            var result = await dataProvider.CreateConversation(
+                item: item,
+                ownerId: ownerId,
+                projectId: projectId,
+                connectionId: connectionId,
+                cancellationToken: cancellationToken
+            );
+
+            //
+            return result;
+        }
+
         /// <summary>
         /// Ask a Question as Prompt and Retrieve Response ...
         /// </summary>