fix: improve BaseChatMemory interface compatibility with ReactAgent

- Enhanced get_context() method in BaseChatMemory with full ReactAgent compatibility
  - Added query parameter for optional keyword search
  - Added max_tokens parameter for context size limit
  - Added use_search parameter to enable/disable search
  - Maintained backward compatibility with max_messages parameter

- Updated ReactAgent to support both memory interfaces
  - Accepts BaseMemory (legacy v0.9.x interface)
  - Accepts BaseChatMemory (new v0.10.0 interface)
  - Automatic conversion via ChatToLegacyAdapter when needed
  - Updated type hints to Union[BaseMemory, BaseChatMemory]

- Added necessary imports to ReactAgent
  - BaseChatMemory for type checking
  - ChatToLegacyAdapter for automatic interface conversion

- Improved documentation
  - Better docstring for memory parameter in ReactAgent.__init__()
  - Clear explanation of interface support

- Added EXAMPLES_GUIDE.md
  - Complete guide for running all framework examples
  - Detailed explanations of each example
  - Prerequisites and usage instructions
  - Memory system v0.10.0 migration guide

Bumped version: 0.10.0 → 0.10.1 (PATCH - bugfix)
Maintains 100% backward compatibility with v0.10.0 and v0.9.x

Author: marcosf63

CHANGELOG.md

@@ -5,6 +5,36 @@ Todas as mudanças notáveis neste projeto serão documentadas neste arquivo.
 O formato é baseado em [Keep a Changelog](https://keepachangelog.com/pt-BR/1.0.0/),
 e este projeto adere ao [Semantic Versioning](https://semver.org/lang/pt-BR/).
 
+## [0.10.1] - 2025-01-11
+
+### 🐛 Correções
+
+- **Interface BaseChatMemory**: Melhorado método `get_context()` para suportar parâmetros compatíveis com ReactAgent
+  - Adicionado parâmetro `query` (busca com palavra-chave opcional)
+  - Adicionado parâmetro `max_tokens` (limite de tokens no contexto)
+  - Adicionado parâmetro `use_search` (ativar/desativar busca)
+  - Mantida retrocompatibilidade com `max_messages`
+
+- **ReactAgent**: Suporte completo para ambas interfaces de memória
+  - Aceita `BaseMemory` (interface antiga/legada)
+  - Aceita `BaseChatMemory` (interface nova v0.10.0)
+  - Conversão automática via `ChatToLegacyAdapter` quando necessário
+  - Type hints atualizados: `Union[BaseMemory, BaseChatMemory]`
+
+- **Imports**: Adicionados imports necessários em `ReactAgent`
+  - `BaseChatMemory` para type checking
+  - `ChatToLegacyAdapter` para conversão automática
+
+### 📝 Documentação
+
+- Melhorada documentação do parâmetro `memory` em `ReactAgent.__init__()`
+- Explicação clara sobre suporte a ambas interfaces
+
+### 🔧 Técnico
+
+Esta é uma versão PATCH (bugfix) que corrige incompatibilidades de interface sem quebrar código existente.
+Mantém 100% de retrocompatibilidade com v0.10.0 e v0.9.x.
+
 ## [0.10.0] - 2025-01-10
 
 ### 🎯 BREAKING CHANGES