Release 1.3.0

Author: amikhail48

BUILD

@@ -4,8 +4,9 @@
 cc_import(
     name = "python",
     shared_library = select({
-        "@platforms//os:macos": "lib/macos/libpython3.11.dylib",
         "@platforms//os:linux": "lib/linux/libpython3.11.so",
+        "@platforms//os:macos": "lib/macos/libpython3.11.dylib",
+        "@platforms//os:windows": "lib/windows/libpython3.11.dll",
         "//conditions:default": None,
     }),
 )
@@ -21,8 +22,9 @@ cc_import(
         "include",
     ],
     shared_library = select({
-        "@platforms//os:macos": "lib/macos/libagents_cpp_shared_lib.dylib",
         "@platforms//os:linux": "lib/linux/libagents_cpp_shared_lib.so",
+        "@platforms//os:macos": "lib/macos/libagents_cpp_shared_lib.dylib",
+        "@platforms//os:windows": "lib/windows/libagents_cpp_shared_lib.dll",
         "//conditions:default": None,
     }),
     deps = [

README.md

@@ -3,7 +3,7 @@
 
 ![Linux](https://img.shields.io/badge/Linux-FCC624?logo=linux&logoColor=black)
 ![macOS](https://img.shields.io/badge/macOS-000000?logo=apple&logoColor=F0F0F0)
-
+![Windows](https://custom-icon-badges.demolab.com/badge/Windows-0078D6?logo=windows11&logoColor=white)
 
 **Agents-SDK** is a **portable, high-performance C++ framework** for building **on-device, agentic AI systems** — think **LangChain for the edge**. This SDK is purpose-built for developers who want to create **local-first AI agents** that can reason, plan, and act without relying on the cloud.
 
@@ -85,7 +85,7 @@ You can configure API keys and other settings in three ways:
    ```bash
    export OPENAI_API_KEY=your_api_key_here
    export ANTHROPIC_API_KEY=your_api_key_here
-   export SERPAPI_KEY=your_api_key_here
+   export WEBSEARCH_API_KEY=your_api_key_here
    ```
 
 3. Passing API keys as command-line arguments (not recommended for production):
@@ -129,7 +129,7 @@ int main() {
     JsonObject result = agent.run("Research the latest developments in quantum computing");
 
     // Access the result
-    std::cout << result["answer"].get<String>() << std::endl;
+    std::cout << result["answer"].get<std::string>() << std::endl;
 
     return 0;
 }
@@ -261,7 +261,7 @@ auto custom_tool = createTool(
         {"expression", "The expression to evaluate", "string", true}
     },
     [](const JsonObject& params) -> ToolResult {
-        String expr = params["expression"];
+        std::string expr = params["expression"];
         // Implement calculation logic here
         double result = evaluate(expr);
         return ToolResult{
@@ -285,7 +285,7 @@ public:
     CustomWorkflow(std::shared_ptr<Context> context)
         : Workflow(context) {}
 
-    JsonObject run(const String& input) override {
+    JsonObject run(const std::string& input) override {
         // Implement your custom workflow logic here
     }
 };

examples/actor_agent_example.cpp

@@ -21,7 +21,7 @@ using namespace agents::workflows;
 ToolResult calculatorTool(const JsonObject& params) {
     try {
         if (params.contains("expression")) {
-            String expr = params["expression"];
+            std::string expr = params["expression"];
             // Very simple calculator for demo purposes
             // In a real-world scenario, you'd use a proper expression evaluator
             double result = 0.0;
@@ -51,7 +51,7 @@ ToolResult calculatorTool(const JsonObject& params) {
     } catch (const std::exception& e) {
         return {
             false,
-            "Error calculating result: " + String(e.what()),
+            "Error calculating result: " + std::string(e.what()),
             {{"error", e.what()}}
         };
     }
@@ -61,10 +61,10 @@ ToolResult calculatorTool(const JsonObject& params) {
 ToolResult weatherTool(const JsonObject& params) {
     try {
         if (params.contains("location")) {
-            String location = params["location"];
+            std::string location = params["location"];
 
             // Just a dummy implementation for demo purposes
-            String weather = "sunny";
+            std::string weather = "sunny";
             double temperature = 22.0;
 
             return {
@@ -86,7 +86,7 @@ ToolResult weatherTool(const JsonObject& params) {
     } catch (const std::exception& e) {
         return {
             false,
-            "Error getting weather: " + String(e.what()),
+            "Error getting weather: " + std::string(e.what()),
             {{"error", e.what()}}
         };
     }
@@ -97,7 +97,7 @@ int main(int argc, char* argv[]) {
     Logger::setLevel(Logger::Level::INFO);
 
     // Get API key from .env, environment, or command line
-    String api_key;
+    std::string api_key;
     auto& config = ConfigLoader::getInstance();
 
     // Try to get API key from config or environment
@@ -225,15 +225,15 @@ int main(int argc, char* argv[]) {
         agent->setOptions(agent_options);
 
         // Register status callback
-        agent->setStatusCallback([](const String& status) {
+        agent->setStatusCallback([](const std::string& status) {
             Logger::info("Agent status: {}", status);
         });
 
         // Initialize and run the agent
         agent->init();
 
         // Run the agent with multiple tasks
-        std::vector<String> tasks = {
+        std::vector<std::string> tasks = {
             "What is 1+1?",
             "What's the weather like in New York?",
             "Tell me a short story about a robot learning to feel emotions."
@@ -253,4 +253,4 @@ int main(int argc, char* argv[]) {
         Logger::error("Error: {}", e.what());
         return EXIT_FAILURE;
     }
-}
+}

examples/autonomous_agent_example.cpp

@@ -33,7 +33,7 @@ void detailedStepCallback(const AutonomousAgent::Step& step) {
 }
 
 // Custom callback for human-in-the-loop
-bool detailedHumanApproval(const String& message, const JsonObject& context, String& modifications) {
+bool detailedHumanApproval(const std::string& message, const JsonObject& context, std::string& modifications) {
     if (!context.empty()) {
         Logger::info("\nContext Information:");
         Logger::info("{}", context.dump(2));
@@ -48,7 +48,7 @@ bool detailedHumanApproval(const String& message, const JsonObject& context, Str
 
     if (response == 'm' || response == 'M') {
         Logger::info("Enter your modifications or instructions: ");
-        String user_modifications;
+        std::string user_modifications;
         std::getline(std::cin, user_modifications);
 
         // Set modifications output parameter
@@ -79,33 +79,20 @@ int main() {
     auto& config = ConfigLoader::getInstance();
 
     // Proceed based on provider choice and API key in the environment
-    if (provider_choice == 1) {
-        bool hasOpenAI = config.has("OPENAI_API_KEY");
-        if (hasOpenAI) {
-            llm = createLLM("openai", config.get("OPENAI_API_KEY"), "gpt-4o-2024-05-13");
+    try {
+        if (provider_choice == 1) {
+            llm = createLLM("openai", config.get("OPENAI_API_KEY"), "gpt-4o");
+        } else if (provider_choice == 2) {
+            llm = createLLM("anthropic", config.get("ANTHROPIC_API_KEY"), "claude-sonnet-4-5");
+        } else if (provider_choice == 3) {
+            llm = createLLM("google", config.get("GEMINI_API_KEY"), "gemini-2.5-flash");
         } else {
-            Logger::error("OPENAI_API_KEY not found in environment.");
+            Logger::error("Invalid provider choice.");
             return EXIT_FAILURE;
         }
-    } else if (provider_choice == 2) {
-        // Note: This assumes the user has the Anthropic API key in the environment
-        bool hasAnthropic = config.has("ANTHROPIC_API_KEY");
-        if (hasAnthropic) {
-            llm = createLLM("anthropic", config.get("ANTHROPIC_API_KEY"), "claude-3-5-sonnet-20240620");
-        } else {
-            Logger::error("ANTHROPIC_API_KEY not found in environment.");
-            return EXIT_FAILURE;
-        }
-    } else if (provider_choice == 3) {
-        bool hasGoogle = config.has("GEMINI_API_KEY");
-        if (hasGoogle) {
-            llm = createLLM("google", config.get("GEMINI_API_KEY"), "gemini-2.0-flash");
-        } else {
-            Logger::error("GEMINI_API_KEY not found in environment.");
-            return EXIT_FAILURE;
-        }
-    } else {
-        Logger::error("Invalid provider choice.");
+    } catch (const std::exception& e) {
+        Logger::error("Error creating LLM: {}", e.what());
+        Logger::error("Please ensure the appropriate API key is set in the environment.");
         return EXIT_FAILURE;
     }
 
@@ -121,17 +108,15 @@ int main() {
 
     // Set system prompt for the context
     context->setSystemPrompt(
-        "You are a helpful, autonomous assistant with access to tools."
-        "You can use these tools to accomplish tasks for the user."
+        "You are a helpful, autonomous assistant with access to tools. "
+        "You can use these tools to accomplish tasks for the user. "
         "Think step by step and be thorough in your approach."
     );
 
-    // Register tools
-    context->registerTool(tools::createWebSearchTool());
-    context->registerTool(tools::createWikipediaTool());
-    // Uncomment when tools are implemented
-    // context->registerTool(tools::createWeatherTool());
-    // context->registerTool(tools::createCalculatorTool());
+    // Register tools from tool registry
+    auto registry = tools::ToolRegistry::global();
+    tools::registerStandardTools(registry, llm);
+    context->registerToolRegistry(registry);
 
     // Create a custom tool
     auto summarize_tool = createTool(
@@ -142,7 +127,7 @@ int main() {
             {"max_length", "Maximum length of summary in words", "integer", false}
         },
         [context](const JsonObject& params) -> ToolResult {
-            String text = params["text"];
+            std::string text = params["text"];
             int max_length = params.contains("max_length") ? params["max_length"].get<int>() : 100;
 
             // Create a specific context for summarization
@@ -152,11 +137,11 @@ int main() {
                 "that capture the main points of the provided text."
             );
 
-            String prompt = "Summarize the following text in no more than " +
+            std::string prompt = "Summarize the following text in no more than " +
                             std::to_string(max_length) + " words:\n\n" + text;
 
             LLMResponse llm_response = summary_context->getLLM()->chat(prompt);
-            String summary = llm_response.content;
+            std::string summary = llm_response.content;
 
             return ToolResult{
                 true,
@@ -182,12 +167,15 @@ int main() {
     // Set planning strategy based on user choice
     AutonomousAgent::PlanningStrategy strategy;
     switch (strategy_choice) {
+        case 1:
+            strategy = AutonomousAgent::PlanningStrategy::REACT;
+            break;
         case 2:
             strategy = AutonomousAgent::PlanningStrategy::PLAN_AND_EXECUTE;
             break;
-        case 1:
         default:
-            strategy = AutonomousAgent::PlanningStrategy::REACT;
+            Logger::error("Invalid strategy choice.");
+            return EXIT_FAILURE;
     }
     agent.setPlanningStrategy(strategy);
 
@@ -228,7 +216,7 @@ int main() {
     Logger::info("==================================================");
     Logger::info("Enter a question or task for the agent (or 'exit' to quit):");
 
-    String user_input;
+    std::string user_input;
     while (true) {
         Logger::info("\n> ");
         std::getline(std::cin, user_input);
@@ -256,7 +244,7 @@ int main() {
             Logger::info("\n==================================================");
             Logger::info("                  FINAL RESULT                    ");
             Logger::info("==================================================");
-            Logger::info("{}", result["answer"].get<String>());
+            Logger::info("{}", result["answer"].get<std::string>());
 
             // Display completion statistics
             Logger::info("\n--------------------------------------------------");
@@ -274,4 +262,4 @@ int main() {
     }
 
     return EXIT_SUCCESS;
-}
+}