Feat/97 include tools support for cloud providers

Examples/Examples/Agents/AgentExampleTools.cs

@@ -0,0 +1,71 @@
+using Examples.Utils;
+using MaIN.Core.Hub;
+using MaIN.Core.Hub.Utils;
+
+namespace Examples.Agents;
+
+public class AgentExampleTools : IExample
+{
+    public async Task Start()
+    {
+        AnthropicExample.Setup();
+        Console.WriteLine("(Anthropic) Tool example is running!");
+
+        var context = await AIHub.Agent()
+            .WithModel("claude-sonnet-4-5-20250929")
+            .WithSteps(StepBuilder.Instance
+                .Answer()
+                .Build())
+            .WithTools(new ToolsConfigurationBuilder()
+                .AddTool<ListNotesArgs>(
+                    "list_notes",
+                    "List all available notes",
+                    new
+                    {
+                        type = "object",
+                        properties = new
+                        {
+                            folder = new { type = "string", description = "Notes folder", @default = "notes" }
+                        }
+                    },
+                    NoteTools.ListNotes)
+                .AddTool<ReadNoteArgs>(
+                    "read_note",
+                    "Read the content of a specific note",
+                    new
+                    {
+                        type = "object",
+                        properties = new
+                        {
+                            noteName = new
+                                { type = "string", description = "Name of the note (without .txt extension)" }
+                        },
+                        required = new[] { "noteName" }
+                    },
+                    NoteTools.ReadNote)
+                .AddTool<SaveNoteArgs>(
+                    "save_note",
+                    "Save or update a note with new content",
+                    new
+                    {
+                        type = "object",
+                        properties = new
+                        {
+                            noteName = new
+                                { type = "string", description = "Name of the note (without .txt extension)" },
+                            content = new { type = "string", description = "Content to save in the note" }
+                        },
+                        required = new[] { "noteName", "content" }
+                    },
+                    NoteTools.SaveNote)
+                .WithToolChoice("auto")
+                .Build())
+            .CreateAsync(interactiveResponse: true);
+
+        await context.ProcessAsync("What notes do I currently have?");
+
+        Console.WriteLine("--//--");
+
+        await context.ProcessAsync("Create a new note for a shopping list that includes healthy foods.");
+    }
+}

Examples/Examples/Chat/ChatExampleAnthropic.cs

@@ -1,5 +1,6 @@
 using Examples.Utils;
 using MaIN.Core.Hub;
+using MaIN.Domain.Configuration;
 
 namespace Examples.Chat;
 

Examples/Examples/Chat/ChatExampleToolsSimple.cs

@@ -0,0 +1,28 @@
+using Examples.Utils;
+using MaIN.Core.Hub;
+using MaIN.Core.Hub.Utils;
+using MaIN.Domain.Configuration;
+
+namespace Examples.Chat;
+
+public class ChatExampleToolsSimple : IExample
+{
+    public async Task Start()
+    {
+        OpenAiExample.Setup(); //We need to provide OpenAi API key
+
+        Console.WriteLine("(OpenAi) ChatExample with tools is running!"); 
+
+        await AIHub.Chat()
+            .WithModel("gpt-5-nano")
+            .WithMessage("What time is it right now?")
+            .WithTools(new ToolsConfigurationBuilder()
+                .AddTool(
+                    name: "get_current_time",
+                    description: "Get the current date and time",
+                    execute: Tools.GetCurrentTime) 
+                .WithToolChoice("auto")
+                .Build())
+            .CompleteAsync(interactive: true);
+    }
+}

Examples/Examples/Mcp/AgentWithKnowledgeMcpExample.cs

@@ -33,7 +33,8 @@ public async Task Start()
                     Arguments = ["-y",
                         "@modelcontextprotocol/server-filesystem",
                         "C:\\Users\\stach\\Desktop",  //Align paths to fit your system
-                        "C:\\WiseDev"], //Align paths to fit your system
+                        "C:\\WiseDev", //Align paths to fit your system
+                        ], //Align paths to fit your system
                     Backend = BackendType.GroqCloud,
                     Model = "openai/gpt-oss-20b"
                 }, ["filesystem", "file operations", "read write", "disk search"])

Examples/Examples/Program.cs

@@ -51,6 +51,8 @@ static void RegisterExamples(IServiceCollection services)
     services.AddTransient<ChatWithImageGenExample>();
     services.AddTransient<ChatFromExistingExample>();
     services.AddTransient<ChatWithReasoningExample>();
+    services.AddTransient<ChatExampleToolsSimple>();
+    services.AddTransient<AgentExampleTools>();
     services.AddTransient<AgentExample>();
     services.AddTransient<AgentConversationExample>();
     services.AddTransient<AgentWithRedirectExample>();
@@ -142,6 +144,7 @@ public class ExampleRegistry(IServiceProvider serviceProvider)
             ("\u25a0 Chat with custom grammar", serviceProvider.GetRequiredService<ChatCustomGrammarExample>()),
             ("\u25a0 Chat with Files from stream", serviceProvider.GetRequiredService<ChatWithFilesFromStreamExample>()),
             ("\u25a0 Chat with Vision", serviceProvider.GetRequiredService<ChatWithVisionExample>()),
+            ("\u25a0 Chat with Tools (simple)", serviceProvider.GetRequiredService<ChatExampleToolsSimple>()),
             ("\u25a0 Chat with Image Generation", serviceProvider.GetRequiredService<ChatWithImageGenExample>()),
             ("\u25a0 Chat from Existing", serviceProvider.GetRequiredService<ChatFromExistingExample>()),
             ("\u25a0 Chat with reasoning", serviceProvider.GetRequiredService<ChatWithReasoningExample>()),
@@ -151,6 +154,7 @@ public class ExampleRegistry(IServiceProvider serviceProvider)
             ("\u25a0 Agent with Redirect (Multi backends)", serviceProvider.GetRequiredService<MultiBackendAgentWithRedirectExample>()),
             ("\u25a0 Agent with Redirect Image", serviceProvider.GetRequiredService<AgentWithRedirectImageExample>()),
             ("\u25a0 Agent with Become", serviceProvider.GetRequiredService<AgentWithBecomeExample>()),
+            ("\u25a0 Agent with Tools (advanced)", serviceProvider.GetRequiredService<AgentExampleTools>()),
             ("\u25a0 Agent with Knowledge", serviceProvider.GetRequiredService<AgentWithKnowledgeFileExample>()),
             ("\u25a0 Agent with Web Knowledge", serviceProvider.GetRequiredService<AgentWithKnowledgeWebExample>()),
             ("\u25a0 Agent with Mcp Knowledge", serviceProvider.GetRequiredService<AgentWithKnowledgeMcpExample>()),

Examples/Examples/Utils/Tools.cs

@@ -0,0 +1,96 @@
+using System.Text.Json;
+
+namespace Examples.Utils;
+
+public static class Tools
+{
+    public static object GetCurrentTime()
+    {
+        var now = DateTime.Now;
+        var timeInfo = new
+        {
+            date = now.ToString("yyyy-MM-dd"),
+            time = now.ToString("HH:mm:ss"),
+            dayOfWeek = now.DayOfWeek.ToString()
+        };
+
+        return $"Date: {timeInfo.date}, Time: {timeInfo.time}, Day of week: {timeInfo.dayOfWeek}";
+    }
+}
+
+public static class NoteTools
+{
+    private const string NotesFolder = "notes";
+
+
+    public static async Task<object> ListNotes(ListNotesArgs args)
+    {
+        if (!Directory.Exists(args.Folder))
+            Directory.CreateDirectory(args.Folder);
+
+        var files = Directory.GetFiles(args.Folder, "*.txt");
+
+        return new
+        {
+            count = files.Length,
+            notes = files.Select(f => new
+            {
+                name = Path.GetFileNameWithoutExtension(f),
+                lastModified = File.GetLastWriteTime(f).ToString("yyyy-MM-dd HH:mm:ss"),
+                sizeBytes = new FileInfo(f).Length
+            }).ToArray()
+        };
+    }
+
+    public static async Task<object> ReadNote(ReadNoteArgs args)
+    {
+        var filePath = Path.Combine(NotesFolder, $"{args.NoteName}.txt");
+
+        if (!File.Exists(filePath))
+            return new { error = $"Note '{args.NoteName}' not found" };
+
+        var content = await File.ReadAllTextAsync(filePath);
+
+        return new
+        {
+            name = args.NoteName,
+            content = content,
+            lastModified = File.GetLastWriteTime(filePath).ToString("yyyy-MM-dd HH:mm:ss")
+        };
+    }
+
+    public static async Task<object> SaveNote(SaveNoteArgs args)
+    {
+        if (!Directory.Exists(NotesFolder))
+            Directory.CreateDirectory(NotesFolder);
+
+        var filePath = Path.Combine(NotesFolder, $"{args.NoteName}.txt");
+        var isNew = !File.Exists(filePath);
+
+        await File.WriteAllTextAsync(filePath, args.Content);
+
+        return new
+        {
+            success = true,
+            name = args.NoteName,
+            action = isNew ? "created" : "updated",
+            path = filePath
+        };
+    }
+}
+
+public class ListNotesArgs
+{
+    public string Folder { get; set; } = "notes";
+}
+
+public class ReadNoteArgs
+{
+    public string NoteName { get; set; } = null!;
+}
+
+public class SaveNoteArgs
+{
+    public string NoteName { get; set; } = null!;
+    public string Content { get; set; } = null!;
+}

Releases/0.7.0.md

@@ -0,0 +1,15 @@
+# 0.7.0 release
+
+- Add full tool support for all available cloud providers
+
+On chat/agent context
+
+```
+.WithTools(new ToolsConfigurationBuilder()
+                .AddTool(
+                    name: "get_current_time",
+                    description: "Get the current date and time",
+                    execute: Tools.GetCurrentTime) 
+                .WithToolChoice("auto")
+                .Build())
+```

src/MaIN.Core/.nuspec

@@ -2,7 +2,7 @@
 <package>
   <metadata>
     <id>MaIN.NET</id>
-    <version>0.6.4</version>
+    <version>0.7.0</version>
     <authors>Wisedev</authors>
     <owners>Wisedev</owners>
     <icon>favicon.png</icon>

src/MaIN.Core/Hub/Contexts/AgentContext.cs

@@ -7,6 +7,7 @@
 using MaIN.Services.Services.Models;
 using MaIN.Core.Hub.Utils;
 using MaIN.Domain.Entities.Agents.Knowledge;
+using MaIN.Domain.Entities.Tools;
 
 namespace MaIN.Core.Hub.Contexts;
 
@@ -51,7 +52,7 @@ public AgentContext WithId(string id)
         _agent.Id = id;
         return this;
     }
-
+    
     public string GetAgentId() => _agent.Id;
 
     public Agent GetAgent() => _agent;
@@ -187,6 +188,12 @@ public AgentContext Create(bool flow = false, bool interactiveResponse = false)
         return this;
     }
 
+    public AgentContext WithTools(ToolsConfiguration toolsConfiguration)
+    {
+        _agent.ToolsConfiguration = toolsConfiguration;
+        return this;
+    }
+
     internal void LoadExistingKnowledgeIfExists()
     {
         _knowledge ??= new Knowledge(_agent);

src/MaIN.Core/Hub/Contexts/ChatContext.cs

@@ -1,5 +1,6 @@
 using MaIN.Domain.Configuration;
 using MaIN.Domain.Entities;
+using MaIN.Domain.Entities.Tools;
 using MaIN.Domain.Models;
 using MaIN.Services;
 using MaIN.Services.Constants;
@@ -47,6 +48,12 @@ public ChatContext WithInferenceParams(InferenceParams inferenceParams)
         return this;
     }
 
+    public ChatContext WithTools(ToolsConfiguration toolsConfiguration)
+    {
+        _chat.ToolsConfiguration = toolsConfiguration;
+        return this;
+    }
+
     public ChatContext WithMemoryParams(MemoryParams memoryParams)
     {
         _chat.MemoryParams = memoryParams;