Add support for Maritaca.AI API integration

[Copilot]

This PR adds comprehensive support for maritaca.ai API to the ProsaAI system, enabling the use of Portuguese-specialized Sabiá language models for generating ENEM essay themes.

What's Added

🤖 New Maritaca Provider

• Added Maritaca provider class following existing patterns
• Supports Sabiá models: sabia-2, sabia-2-small, sabia-2-medium
• OpenAI-compatible API integration at https://chat.maritaca.ai/api/chat/completions

🔧 Seamless Integration

• Works with existing ChatAPI and make_llm_call functions
• No breaking changes to current codebase
• Follows established provider registration pattern

🧪 Comprehensive Testing

• 7 new test cases covering provider registration, API calls, and error handling
• Mocked API responses for reliable testing
• Validates proper URL, headers, and payload construction

📚 Complete Documentation

• Created docs/MARITACA_INTEGRATION.md with usage examples
• Configuration instructions for environment variables
• API format specifications and integration guide

Usage Example

from core.chat_api import ChatAPI

# Create API instance
api = ChatAPI('maritaca', 'sabia-2', 'your-api-key')

# Generate ENEM essay theme
response = api.gera_conteudo(
    "Você é um especialista em temas de redação do ENEM.", 
    "Gere um tema sobre sustentabilidade ambiental."
)

Or using the service layer:

from core.servico_llm import make_llm_call

response = make_llm_call(
    provider='maritaca',
    model='sabia-2',
    contexto='Especialista em redação ENEM',
    prompt='Tema sobre educação digital',
    api_key='your-api-key'
)

Benefits

• 🇧🇷 Portuguese Specialization: Sabiá models trained specifically for Brazilian Portuguese
• 📝 ENEM Context: Better cultural understanding for Brazilian essay themes
• 💰 Cost Efficiency: Potentially more economical than international providers
• 🔄 Easy Integration: Drop-in replacement in existing pipeline

Configuration

Add to your .env file:

# Use as primary provider
PROVIDER1=maritaca
PROVIDER1_API_KEY=your_maritaca_key
MODEL1=sabia-2

# Or as secondary provider
PROVIDER2=maritaca
PROVIDER2_API_KEY=your_maritaca_key
MODEL2=sabia-2-small

Code Quality

• All tests passing (7/7)
• Pylint score: 9.78/10
• Follows existing code patterns and conventions

Fixes #29.

Warning

Firewall rules blocked me from connecting to one or more addresses

I tried to connect to the following addresses, but was blocked by firewall rules:

• api.maritaca.ai
  • Triggering command: curl -s REDACTED -H User-Agent: Mozilla/5.0 (dns block)
• chat.maritaca.ai
  • Triggering command: curl -s REDACTED -H User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (dns block)
• docs.maritaca.ai
  • Triggering command: python -c import requests try: resp = requests.get('REDACTED', timeout=10, headers={'User-Agent': 'Mozilla/5.0'}) print('Docs response:', resp.status_code) if resp.status_code == 200: if 'api' in resp.text.lower(): print('API info found in docs') except Exception as e: print('Error accessing docs:', e) (dns block)
• huggingface.co
  • Triggering command: python -m pytest tests/ -v --tb=short (dns block)
• platform.maritaca.ai
  • Triggering command: curl -s REDACTED -H User-Agent: Mozilla/5.0 (dns block)
• www.maritaca.ai
  • Triggering command: curl -s REDACTED (dns block)
  • Triggering command: python -c import requests try: resp = requests.get('REDACTED', timeout=10, headers={'User-Agent': 'Mozilla/5.0'}) print('Website response:', resp.status_code) if resp.status_code == 200: content = resp.text.lower() api_mentions = [] if 'api' in content: print('API mentioned on website') if 'chat/completions' in content: print('OpenAI-compatible API detected') if 'maritaca-api' in content: print('Maritaca-specific API detected') except Exception as e: print('Error accessing website:', e) (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.