docs: enhance README with expanded features and benefits section

Author: ciro-maciel

README.md

@@ -5,7 +5,36 @@
 ![GitHub Release Date](https://img.shields.io/github/release-date/riligar/agents-sdk)
 ![NPM Downloads](https://img.shields.io/npm/dw/%40riligar%2Fagents-sdk)
 
-RiLiGar Agents SDK - JavaScript framework for building intelligent AI agents with LLM support via OpenRouter, custom tools, and MCP integration.
+## 🔗 Resources
+
+-   **[OpenRouter](https://openrouter.ai/docs/quickstart)** - Unified API for multiple LLM providers
+-   **[OpenAI](https://platform.openai.com)** | [SDK](https://github.com/openai/openai-node)
+-   **[Anthropic](https://console.anthropic.com/)** | [SDK](https://github.com/anthropics/anthropic-sdk-typescript)
+-   **[Google AI](https://ai.google.dev/gemini-api/)** | [SDK](https://www.npmjs.com/package/@google/genai)
+-   **[Meta Llama](https://www.llama.com/)**
+-   **[Model Context Protocol](https://modelcontextprotocol.io)** 
+    -   [Documentation](https://modelcontextprotocol.info/docs/)
+    -   [TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)
+    -   [Inspector](https://github.com/modelcontextprotocol/inspector)
+
+---
+
+## 🚀 **The Ultimate AI Agents Framework**
+
+**Stop wrestling with complex AI integrations.** RiLiGar Agents SDK gives you **enterprise-grade AI agents in just 5 lines of code.**
+
+✨ **What used to take weeks, now takes minutes.** Built on top of industry giants like **OpenAI, Anthropic, Google, and Meta** through OpenRouter's unified API, this framework packs **thousands of hours of engineering** into an elegantly simple package.
+
+🎯 **One SDK. All AI Providers. Infinite Possibilities.**
+
+- **🤖 Smart Agents** with custom personalities and instructions
+- **🔧 Custom Tools** that agents can execute seamlessly  
+- **🛡️ Built-in Guardrails** for safe, controlled AI interactions
+- **📡 Real-time Streaming** for responsive user experiences
+- **🔗 MCP Protocol** for enterprise-grade integrations
+- **📝 Intelligent Logging** with contextual insights
+
+**From startup MVPs to enterprise solutions** - RiLiGar Agents SDK scales with you.
 
 ## 🚀 Installation
 
@@ -126,18 +155,6 @@ const tools = await tool.build(
 );
 ```
 
-## 🔗 Resources
-
--   **[OpenRouter](https://openrouter.ai/docs/quickstart)** - Unified API for multiple LLM providers
--   **[OpenAI](https://platform.openai.com)** | [SDK](https://github.com/openai/openai-node)
--   **[Anthropic](https://console.anthropic.com/)** | [SDK](https://github.com/anthropics/anthropic-sdk-typescript)
--   **[Google AI](https://ai.google.dev/gemini-api/)** | [SDK](https://www.npmjs.com/package/@google/genai)
--   **[Meta Llama](https://www.llama.com/)**
--   **[Model Context Protocol](https://modelcontextprotocol.io)** 
-    -   [Documentation](https://modelcontextprotocol.info/docs/)
-    -   [TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)
-    -   [Inspector](https://github.com/modelcontextprotocol/inspector)
-
 ## 📄 License
 
 Apache-2.0