v0.9.1

Changelog

v0.9.1

🎯 Pricing Integration

• feat(generations): Added Pricing model to Generation class with input_pricing, output_pricing, and total_pricing fields
• feat(providers): All major providers now automatically populate pricing information in Generation objects
  • OpenRouter: Dynamic pricing from API with automatic per-token to per-million conversion
  • OpenAI: Static pricing table with comprehensive model coverage
  • Google (Gemini): Static pricing for all Gemini models
  • Cerebras: Static pricing for Llama models
  • Amazon Bedrock: Static pricing for Claude and other models
• feat(adapters): Added async adapt_async() methods to all provider adapters for pricing calculation
• fix(openrouter): Corrected pricing calculation - OpenRouter returns per-token prices, now properly converted to per-million-tokens
• Pricing is calculated using the abstract methods price_per_million_tokens_input() and price_per_million_tokens_output()
• Costs are rounded to 8 decimal places for precision
• Graceful fallback to empty Pricing object if calculation fails

🐛 Bug Fixes

• fix(openrouter): when fallback models are used, use "models" in the requests, not "model"
• fix(openrouter): accept single string in with_fallback_models() method (was treating string as iterable)

🚨 Error Handling

• feat(openrouter): comprehensive custom exception hierarchy with detailed error messages
  • Created 16+ custom exception classes for all documented OpenRouter errors
  • Each exception includes clear descriptions, possible causes, and actionable solutions
  • Automatic error parsing from response status codes and error messages
  • Examples: ModelNotFoundError, InsufficientCreditsError, ContextLengthExceededError, etc.
  • See examples/openrouter_error_handling.py for usage examples

v0.9.0 🚀

Release Date: October 18, 2024

We're thrilled to announce Agentle v0.9.0, a major milestone packed with powerful new features, critical fixes, and performance improvements. This release represents months of refinement across our parsing, provider, and agent ecosystems.

---

✨ Highlights

🛡️ Guardrails System

• NEW: Comprehensive guardrails integration for safer AI interactions
• Tool Leakage Validator: Prevent sensitive tool information from leaking in responses

🔌 OpenRouter Provider

• Full OpenRouter integration with streaming support and structured outputs
• Dynamic price fetching for cost-aware model selection
• Model fallbacks for improved reliability
• Factory methods for easier instantiation
• Enhanced tool adapter with complex type expansion in JSON Schema conversion
• Configurable httpx client timeout for generation tasks

📄 Document Parsing Revolution

• Native PDF processing with PyMuPDF for superior performance
• RTF Document Parser - brand new format support
• Native DOCX processing option for faster document handling
• Enhanced PDF parsing with encrypted file support and structured exception handling
• PPTX parsing improvements with legacy conversion support
• Legacy .doc file conversion with improved error handling
• Optimized archive processing (ZIP, RAR) with better error messaging
• Page screenshot optimization to reduce per-image analysis costs
• Configurable render_scale for PDF screenshot quality control
• max_concurrent_pages field for PDF parsing concurrency control

🧠 Embeddings & Vector Stores

• DeepInfra Embedding Provider - OpenAI-compatible API integration
• Batch embedding generation methods for async processing
• Enhanced async embedding methods with None value handling
• Load balancer implementation (DuckDB and in-memory) with provider quotas and ranking

💬 WhatsApp Enhancements

• Enhanced markdown formatting (headers, tables, blockquotes, horizontal rules)
• Improved message splitting with list item grouping
• send_message method for independent message sending
• Multiple callback support with semantic type aliases
• Better table formatting (vertical lists for improved readability)

🔧 Developer Experience

• Circuit breaker implementation with DuckDB backend
• Static knowledge from_text class method for easier content creation
• append_content method for dynamic ParsedFile content addition
• Provider ID implementation across GenerationProvider subclasses
• Fallback models parameter for provider resilience
• Enhanced file validation with MIME type and content checks

---

🐛 Bug Fixes

WhatsApp

• Fixed Brazilian phone number formatting after Meta's privacy update
• Proper handling of Evolution API typed dicts (converted to BaseModels)
• Fixed from_number extraction from sender
• Corrected buffer handling for Evolution API fields
• Improved thinking tag removal logic
• Enhanced race condition protection and batch timing
• Rate limit checks now happen before message processing

Agents & Tools

• Fixed assistant message context handling before tool processing
• Removed unnecessary cast in _stream_with_tools function
• Corrected property "text" update logic
• Fixed duplicate tools in vector stores
• Resolved duplicated parameter issues

Parsing & Generation

• Fixed PDF extraction error handling
• Handled cases where no extraction is returned from PDF provider
• Updated PyMuPDF import for better compatibility
• Normalized model names (removed 'google/' prefix)
• Fixed pickling errors in RAG search by avoiding callable serialization
• Improved logging calls

---

⚡ Performance Improvements

• Single page screenshot per page when images are present (avoiding duplicate OCR)
• Optimized PDF page processing with PyMuPDF
• Eliminated redundant temp file creation in archive processing
• Better markdown parsing performance
• Fail-fast on DOCX→PDF conversion errors

---

🔄 Refactoring & Code Quality

• Converted Evolution API typed dicts to BaseModels for better type safety
• Renamed 'agent' parameters to 'provider' for consistency
• Renamed 'chunk_tokens' to 'output_tokens' with new 'input_tokens' property
• Protocol classes follow single underscore convention
• Cleaned up whitespace and improved exception handling
• Streamlined parser class retrieval
• Made Langfuse a parameter for better flexibility
• Enhanced CallbackWithContext with token propagation

---

📚 Documentation & Testing

• Added test for uppercase file extension handling
• Testing failover Generation Provider
• Updated examples with lightweight implementations
• Comprehensive changelog updates

---

🙏 Thank You

This release wouldn't be possible without the dedication of our contributors and the valuable feedback from our community. We're committed to making Agentle the most powerful and reliable agentic AI framework.

Upgrade now and experience the future of AI agents!

pip install --upgrade agentle

---

v0.8.68

• feat(openrouter) streaming with structured outputs

v0.9.0

Changelog

v0.9.0 🚀

Release Date: October 18, 2024

We're thrilled to announce Agentle v0.9.0, a major milestone packed with powerful new features, critical fixes, and performance improvements. This release represents months of refinement across our parsing, provider, and agent ecosystems.

---

✨ Highlights

🛡️ Guardrails System

• NEW: Comprehensive guardrails integration for safer AI interactions
• Tool Leakage Validator: Prevent sensitive tool information from leaking in responses

🔌 OpenRouter Provider

• Full OpenRouter integration with streaming support and structured outputs
• Dynamic price fetching for cost-aware model selection
• Model fallbacks for improved reliability
• Factory methods for easier instantiation
• Enhanced tool adapter with complex type expansion in JSON Schema conversion
• Configurable httpx client timeout for generation tasks

📄 Document Parsing Revolution

• Native PDF processing with PyMuPDF for superior performance
• RTF Document Parser - brand new format support
• Native DOCX processing option for faster document handling
• Enhanced PDF parsing with encrypted file support and structured exception handling
• PPTX parsing improvements with legacy conversion support
• Legacy .doc file conversion with improved error handling
• Optimized archive processing (ZIP, RAR) with better error messaging
• Page screenshot optimization to reduce per-image analysis costs
• Configurable render_scale for PDF screenshot quality control
• max_concurrent_pages field for PDF parsing concurrency control

🧠 Embeddings & Vector Stores

• DeepInfra Embedding Provider - OpenAI-compatible API integration
• Batch embedding generation methods for async processing
• Enhanced async embedding methods with None value handling
• Load balancer implementation (DuckDB and in-memory) with provider quotas and ranking

💬 WhatsApp Enhancements

• Enhanced markdown formatting (headers, tables, blockquotes, horizontal rules)
• Improved message splitting with list item grouping
• send_message method for independent message sending
• Multiple callback support with semantic type aliases
• Better table formatting (vertical lists for improved readability)

🔧 Developer Experience

• Circuit breaker implementation with DuckDB backend
• Static knowledge from_text class method for easier content creation
• append_content method for dynamic ParsedFile content addition
• Provider ID implementation across GenerationProvider subclasses
• Fallback models parameter for provider resilience
• Enhanced file validation with MIME type and content checks

---

🐛 Bug Fixes

WhatsApp

• Fixed Brazilian phone number formatting after Meta's privacy update
• Proper handling of Evolution API typed dicts (converted to BaseModels)
• Fixed from_number extraction from sender
• Corrected buffer handling for Evolution API fields
• Improved thinking tag removal logic
• Enhanced race condition protection and batch timing
• Rate limit checks now happen before message processing

Agents & Tools

• Fixed assistant message context handling before tool processing
• Removed unnecessary cast in _stream_with_tools function
• Corrected property "text" update logic
• Fixed duplicate tools in vector stores
• Resolved duplicated parameter issues

Parsing & Generation

• Fixed PDF extraction error handling
• Handled cases where no extraction is returned from PDF provider
• Updated PyMuPDF import for better compatibility
• Normalized model names (removed 'google/' prefix)
• Fixed pickling errors in RAG search by avoiding callable serialization
• Improved logging calls

---

⚡ Performance Improvements

• Single page screenshot per page when images are present (avoiding duplicate OCR)
• Optimized PDF page processing with PyMuPDF
• Eliminated redundant temp file creation in archive processing
• Better markdown parsing performance
• Fail-fast on DOCX→PDF conversion errors

---

🔄 Refactoring & Code Quality

• Converted Evolution API typed dicts to BaseModels for better type safety
• Renamed 'agent' parameters to 'provider' for consistency
• Renamed 'chunk_tokens' to 'output_tokens' with new 'input_tokens' property
• Protocol classes follow single underscore convention
• Cleaned up whitespace and improved exception handling
• Streamlined parser class retrieval
• Made Langfuse a parameter for better flexibility
• Enhanced CallbackWithContext with token propagation

---

📚 Documentation & Testing

• Added test for uppercase file extension handling
• Testing failover Generation Provider
• Updated examples with lightweight implementations
• Comprehensive changelog updates

---

🙏 Thank You

This release wouldn't be possible without the dedication of our contributors and the valuable feedback from our community. We're committed to making Agentle the most powerful and reliable agentic AI framework.

Upgrade now and experience the future of AI agents!

pip install --upgrade agentle

---

v0.8.68

• feat(openrouter) streaming with structured outputs

v0.8.68

Changelog

v0.8.68

• feat(openrouter) streaming with structured outputs

v0.8.67

Changelog

v0.8.67

• fix(whatsapp) threat some fields as buffers as evolution sends

v0.8.66

Changelog

v0.8.66

• fix(agent): wrongly updating property "text"
• fix(DocumentMessage): accessing inexistant property "caption"

v0.8.65

Changelog

v0.8.65

• converted all TypedDict models in
  models to BaseModel instances and updated all code that accesses them.

v0.8.64

Changelog

v0.8.64

• feat(parsers): add use_native_docx_processing to constructor and propagate that

v0.8.63

Changelog

v0.8.63

• feat(ui) native DOCX processing in docx.py

v0.8.62

Changelog

v0.8.62

• fix(agent) ensure assistant message with tool calls is added to context before processing tools

v0.8.61

Changelog

v0.8.61

• refactor(whatsapp_bot) update table formatting to a vertical list for improved readability on WhatsApp