Improve recipes and Docs (#394)

Author: MikeAlhayek

Directory.Packages.props

@@ -7,20 +7,20 @@
   </PropertyGroup>
   <ItemGroup>
     <!-- Miscellaneous Packages -->
-    <PackageVersion Include="CrestApps.AgentSkills.OrchardCore" Version="1.0.0-preview-0003" />
-    <PackageVersion Include="CrestApps.AgentSkills.Mcp.OrchardCore" Version="1.0.0-preview-0003" />
-    <PackageVersion Include="DocumentFormat.OpenXml" Version="3.4.1" />
+    <PackageVersion Include="CrestApps.AgentSkills.OrchardCore" Version="1.0.0-preview-0004" />
+    <PackageVersion Include="CrestApps.AgentSkills.Mcp.OrchardCore" Version="1.0.0-preview-0004" />
+    <PackageVersion Include="DocumentFormat.OpenXml" Version="3.5.1" />
     <PackageVersion Include="Fluid.Core" Version="2.31.0" />
-    <PackageVersion Include="FluentFTP" Version="53.0.2" />
-    <PackageVersion Include="JsonSchema.Net" Version="7.4.0" />
+    <PackageVersion Include="FluentFTP" Version="54.0.2" />
+    <PackageVersion Include="JsonSchema.Net" Version="9.1.3" />
     <PackageVersion Include="Lucene.Net.Analysis.Common" Version="4.8.0-beta00017" />
     <PackageVersion Include="Markdig" Version="1.1.1" />
     <PackageVersion Include="Microsoft.Extensions.DataIngestion" Version="10.4.0-preview.1.26160.2" />
     <PackageVersion Include="Microsoft.Extensions.DataIngestion.Markdig" Version="10.4.0-preview.1.26160.2" />
     <PackageVersion Include="Microsoft.ML.Tokenizers.Data.O200kBase" Version="2.0.0" />
     <PackageVersion Include="MongoDB.Driver" Version="3.4.0" />
     <PackageVersion Include="NuGet.Versioning" Version="7.3.0" />
-    <PackageVersion Include="OllamaSharp" Version="5.4.23" />
+    <PackageVersion Include="OllamaSharp" Version="5.4.24" />
     <PackageVersion Include="SSH.NET" Version="2025.1.0" />
     <PackageVersion Include="ZString" Version="2.6.0" />
     <PackageVersion Include="YesSql.Abstractions" Version="5.4.7" />
@@ -30,8 +30,8 @@
     <PackageVersion Include="ModelContextProtocol" Version="$(ModelContextProtocolVersion)" />
     <PackageVersion Include="ModelContextProtocol.AspNetCore" Version="$(ModelContextProtocolVersion)" />
     <PackageVersion Include="ModelContextProtocol.Core" Version="$(ModelContextProtocolVersion)" />
-    <PackageVersion Include="PdfPig" Version="0.1.13" />
-    <PackageVersion Include="GitHub.Copilot.SDK" Version="0.1.32" />
+    <PackageVersion Include="PdfPig" Version="0.1.14" />
+    <PackageVersion Include="GitHub.Copilot.SDK" Version="0.2.0" />
   </ItemGroup>
   <ItemGroup>
     <!-- OrchardCore Packages -->
@@ -98,9 +98,9 @@
     <PackageVersion Include="Azure.Messaging.EventGrid" Version="5.0.0" />
     <PackageVersion Include="Azure.Search.Documents" Version="11.7.0" />
     <PackageVersion Include="Microsoft.AspNetCore.Authentication.OpenIdConnect" Version="10.0.3" />
-    <PackageVersion Include="Microsoft.Extensions.AI" Version="10.4.0" />
-    <PackageVersion Include="Microsoft.Extensions.AI.Abstractions" Version="10.4.0" />
-    <PackageVersion Include="Microsoft.Extensions.AI.OpenAI" Version="10.4.0" />
+    <PackageVersion Include="Microsoft.Extensions.AI" Version="10.4.1" />
+    <PackageVersion Include="Microsoft.Extensions.AI.Abstractions" Version="10.4.1" />
+    <PackageVersion Include="Microsoft.Extensions.AI.OpenAI" Version="10.4.1" />
     <PackageVersion Include="Microsoft.Extensions.AI.AzureAIInference" Version="10.0.0-preview.1.25559.3" />
     <PackageVersion Include="Microsoft.Extensions.DependencyInjection.Abstractions" Version="10.0.5" />
     <PackageVersion Include="Microsoft.Extensions.FileProviders.Physical" Version="10.0.5" />
@@ -124,9 +124,9 @@
   </ItemGroup>
   <ItemGroup>
     <!-- Aspire Packages -->
-    <PackageVersion Include="Aspire.Hosting.AppHost" Version="13.1.2" />
+    <PackageVersion Include="Aspire.Hosting.AppHost" Version="13.2.0" />
     <PackageVersion Include="Aspire.Hosting.Elasticsearch" Version="13.1.0" />
-    <PackageVersion Include="Aspire.Hosting.Redis" Version="13.1.2" />
+    <PackageVersion Include="Aspire.Hosting.Redis" Version="13.2.0" />
     <PackageVersion Include="CommunityToolkit.Aspire.Hosting.Ollama" Version="13.1.1" />
   </ItemGroup>
   <ItemGroup>

src/Abstractions/CrestApps.OrchardCore.AI.Abstractions/IAIClientFactory.cs

@@ -78,7 +78,9 @@ public interface IAIClientFactory
     /// <returns>
     /// A <see cref="ValueTask{TResult}"/> representing the asynchronous operation, with the created <see cref="ITextToSpeechClient"/>.
     /// </returns>
+#pragma warning disable MEAI001 // Type is for evaluation purposes only and is subject to change or removal in future updates. Suppress this diagnostic to proceed.
     ValueTask<ITextToSpeechClient> CreateTextToSpeechClientAsync(string providerName, string connectionName, string deploymentName = null);
+#pragma warning restore MEAI001 // Type is for evaluation purposes only and is subject to change or removal in future updates. Suppress this diagnostic to proceed.
 
     /// <summary>
     /// Asynchronously creates an <see cref="ITextToSpeechClient"/> instance from a deployment that may use
@@ -88,12 +90,8 @@ public interface IAIClientFactory
     /// <returns>
     /// A <see cref="ValueTask{TResult}"/> representing the asynchronous operation, with the created <see cref="ITextToSpeechClient"/>.
     /// </returns>
+#pragma warning disable MEAI001 // Type is for evaluation purposes only and is subject to change or removal in future updates. Suppress this diagnostic to proceed.
     ValueTask<ITextToSpeechClient> CreateTextToSpeechClientAsync(AIDeployment deployment);
+#pragma warning restore MEAI001 // Type is for evaluation purposes only and is subject to change or removal in future updates. Suppress this diagnostic to proceed.
 
-    /// <summary>
-    /// Gets the available speech voices for the specified deployment by delegating to the appropriate provider.
-    /// </summary>
-    /// <param name="deployment">The AI deployment containing provider, connection, and model information.</param>
-    /// <returns>An array of available <see cref="SpeechVoice"/> instances.</returns>
-    Task<SpeechVoice[]> GetSpeechVoicesAsync(AIDeployment deployment);
 }

src/Abstractions/CrestApps.OrchardCore.AI.Abstractions/IAIClientProvider.cs

@@ -57,7 +57,9 @@ public interface IAIClientProvider
     /// <param name="connection">The connection entry containing provider configuration.</param>
     /// <param name="deploymentName">The optional deployment name to use.</param>
     /// <returns>A <see cref="ValueTask{ITextToSpeechClient}"/> representing the asynchronous operation.</returns>
+#pragma warning disable MEAI001 // Type is for evaluation purposes only and is subject to change or removal in future updates. Suppress this diagnostic to proceed.
     ValueTask<ITextToSpeechClient> GetTextToSpeechClientAsync(AIProviderConnectionEntry connection, string deploymentName = null);
+#pragma warning restore MEAI001 // Type is for evaluation purposes only and is subject to change or removal in future updates. Suppress this diagnostic to proceed.
 
     /// <summary>
     /// Gets the available speech voices for the specified connection and deployment.

src/Abstractions/CrestApps.OrchardCore.AI.Abstractions/ISpeechVoiceResolver.cs

@@ -0,0 +1,16 @@
+using CrestApps.OrchardCore.AI.Models;
+
+namespace CrestApps.OrchardCore.AI;
+
+/// <summary>
+/// Resolves the available speech voices for a deployment by delegating to the matching AI client provider.
+/// </summary>
+public interface ISpeechVoiceResolver
+{
+    /// <summary>
+    /// Gets the available speech voices for the specified deployment.
+    /// </summary>
+    /// <param name="deployment">The AI deployment containing provider, connection, and model information.</param>
+    /// <returns>An array of available <see cref="SpeechVoice"/> instances.</returns>
+    Task<SpeechVoice[]> GetSpeechVoicesAsync(AIDeployment deployment);
+}