# CleverAgents v3.6.0 and v3.7.0 Release Notes ## Overview This document provides a comprehensive overview of features, enhancements, and improvements introduced in CleverAgents v3.6.0 and v3.7.0. ## v3.6.0 Release Summary **Release Date**: January 2024 **Focus**: Advanced Context Management, Enhanced Security, Improved Observability ### Major Features #### 1. Advanced Context Management - **Context Tier Hydration**: Dynamic context loading with lazy loading support - **Hierarchical Context**: Multi-level context inheritance and composition - **Context Caching**: Intelligent caching with configurable TTL - **Tier Prioritization**: Flexible priority chains for context resolution #### 2. Enhanced Security Profiles - **Layered Boundary Enforcement**: Multiple security enforcement layers - **Input Validation Layer**: Schema-based input validation - **Execution Boundary Layer**: Resource access restrictions - **Output Sanitization Layer**: Automatic sensitive data redaction - **Audit Layer**: Comprehensive security event logging #### 3. Improved Observability - **Comprehensive Metrics Collection**: Execution, resource, context, and security metrics - **Distributed Tracing**: Full tracing support across multiple instances - **Structured Logging**: Contextual logging with correlation IDs - **Real-time Monitoring**: Live metrics and performance tracking #### 4. Performance Optimizations - **Parallel Execution Improvements**: Better resource management - **Multi-tier Caching**: Memory and Redis backend support - **Connection Pooling**: Improved connection reuse ### API Enhancements New REST endpoints for: - Context Management: `/api/v1/contexts` - Security Profiles: `/api/v1/security-profiles` - Metrics: `/api/v1/metrics` ### Migration Notes - Old `get_context()` API deprecated in favor of `ContextManager.resolve_context()` - Security profile YAML format updated - Metrics collection API changed See [v3.6.0 Features Guide](v3.6.0-features.md) for detailed documentation. ## v3.7.0 Release Summary **Release Date**: March 2024 **Focus**: Terminal User Interface, Agent-to-Agent Communication, Enhanced Execution ### Major Features #### 1. Terminal User Interface (TUI) Redesign - **Modular Component System**: Reusable UI components - **Responsive Layout**: Adapts to terminal size - **Rich Color Support**: 256-color and true color support - **Comprehensive Navigation**: Keyboard shortcuts and menu system - **Session Management**: Built-in session browser and manager - **Real-time Monitoring**: Live status updates and progress tracking #### 2. Agent-to-Agent Communication (A2A) - **JSON-RPC 2.0 Protocol**: Standards-compliant messaging - **Multiple Transports**: HTTP, WebSocket, stdio, gRPC - **Message Routing**: Intelligent agent routing - **Error Handling**: Comprehensive error codes and recovery - **Authentication**: Bearer tokens and mTLS support - **Message Queuing**: Reliable message delivery #### 3. Enhanced Automation Execution - **Subplan System**: Hierarchical automation execution - **Parallel Execution**: Execute multiple subplans in parallel - **Conditional Logic**: Branch execution based on conditions - **Error Recovery**: Automatic error recovery and rollback - **Checkpoint System**: Create and manage execution checkpoints #### 4. Advanced Skill Management - **Skill Discovery**: Automatic skill discovery and registration - **Skill Composition**: Compose multiple skills into workflows - **Skill Versioning**: Manage multiple skill versions - **Skill Testing**: Built-in skill testing framework #### 5. Improved Developer Experience - **Enhanced CLI**: New commands and better output formatting - **Type-safe SDK**: Full type hints and documentation - **Debugging Tools**: Enhanced debugging and logging - **Better Error Messages**: More informative error messages ### TUI Features The new TUI provides: - **Automations Tab**: View, create, execute, and monitor automations - **Sessions Tab**: Browse, export, and import sessions - **Skills Tab**: Manage and test skills - **Resources Tab**: Manage resources and connections - **Settings Tab**: Configure TUI and system settings - **Real-time Dashboard**: Monitor execution progress and resource usage ### A2A Protocol Features - **Multi-Agent Orchestration**: Coordinate multiple agents - **Workflow Management**: Define and execute complex workflows - **Streaming Results**: Stream large data transfers - **Batch Requests**: Execute multiple requests in batch - **Error Handling**: Comprehensive error handling with retries ### Migration Notes - Old TUI commands replaced with new `cleveragents tui` - A2A protocol not backward compatible with v3.6.0 - Skill registration API updated See [v3.7.0 Features Guide](v3.7.0-features.md) for detailed documentation. ## Documentation Structure ### v3.6.0 Documentation - [v3.6.0 Features Guide](v3.6.0-features.md) - Comprehensive feature documentation with examples ### v3.7.0 Documentation - [v3.7.0 Features Guide](v3.7.0-features.md) - Complete feature overview - [v3.7.0 TUI Guide](v3.7.0-tui-guide.md) - Terminal User Interface comprehensive guide - [v3.7.0 A2A Protocol](v3.7.0-a2a-protocol.md) - Agent-to-Agent Communication specification ## Upgrade Path ### From v3.5.0 to v3.6.0 1. Update context usage to use new `ContextManager` API 2. Update security profile YAML format 3. Update metrics collection code 4. Test thoroughly in staging environment ### From v3.6.0 to v3.7.0 1. Update TUI commands to use new `cleveragents tui` 2. Update A2A configuration if using agent communication 3. Update skill registration code 4. Migrate to new CLI commands 5. Test thoroughly in staging environment ## Deprecation Timeline ### v3.6.0 - Old context API available with deprecation warnings - Old security profile format still supported - Old metrics API still available ### v3.7.0 - Old TUI commands deprecated - Old A2A protocol deprecated - Old skill registration API deprecated ### v3.8.0 - Old APIs removed - Breaking changes enforced ## Known Issues and Limitations ### v3.6.0 - Context caching may require manual invalidation in some scenarios - Large security profiles may impact startup time ### v3.7.0 - TUI requires minimum terminal size of 80x24 - A2A protocol requires network connectivity - Some older terminal emulators may have display issues ## Performance Improvements ### v3.6.0 - Context resolution: 40% faster with caching - Security validation: 25% faster with layered approach - Metrics collection: 50% less overhead ### v3.7.0 - TUI rendering: 60% faster with optimized components - A2A communication: 30% faster with connection pooling - Skill execution: 20% faster with improved composition ## Security Enhancements ### v3.6.0 - Layered security enforcement - Automatic sensitive data redaction - Comprehensive audit logging - Enhanced input validation ### v3.7.0 - mTLS support for A2A communication - Enhanced authentication mechanisms - Improved authorization checks - Security event tracking ## Testing and Quality Assurance All features have been thoroughly tested: - Unit tests: 95%+ coverage - Integration tests: Comprehensive end-to-end testing - Performance tests: Load and stress testing - Security tests: Vulnerability scanning and penetration testing ## Support and Resources - **Documentation**: https://docs.cleverthis.com - **GitHub Issues**: https://git.cleverthis.com/cleveragents/cleveragents-core/issues - **Community Chat**: https://chat.cleverthis.com - **Email Support**: support@cleverthis.com ## Feedback and Contributions We welcome feedback and contributions! Please: - Report issues on GitHub - Submit feature requests - Contribute improvements via pull requests - Share your use cases and experiences ## Related Documentation - [Architecture Guide](architecture.md) - [API Reference](api/v1.md) - [Module Guides](modules/) - [FAQ](faq.md) --- **Last Updated**: April 2024 **Versions**: 3.6.0, 3.7.0