Release adk-agui-middleware #3023
Description
Discussed in #3010
Originally posted by DennySORA September 23, 2025
Hello,
On behalf of my company, I have open-sourced adk-agui-middleware. I would like to ask if it could be listed in your README as part of third-party support. I will continue to actively develop and maintain it.
The functionality is already stable, although some usage tips have not yet been fully documented. I will be adding those later, and the project already includes support for History.
If you have any suggestions for improvements, I would be glad to hear them and make enhancements. Thank you for your consideration.
🚀 ADK AGUI Middleware v1.0.0 - Major Release
Release Date: January 2025Python Version: 3.13+
First major release of ADK AGUI Middleware - a professional Python library that bridges Agent Development Kit (ADK) with
AGUI protocol for real-time agent interactions via Server-Sent Events.
✨ Key Features
Real-Time Agent Streaming
- Server-Sent Events (SSE) support for live agent responses
- Seamless ADK to AGUI event translation
- Complete streaming message lifecycle management
Human-in-the-Loop (HITL) Workflows
- Advanced HITL pattern implementation
- Intelligent tool call management with human approval
- Pending action tracking and state persistence
Session Management
- Multi-tenant architecture support
- Session locking with configurable timeouts
- JSON Patch support for incremental state updates
- Complete conversation history management
Professional Architecture
- Extensible event processing pipeline
- Comprehensive error handling and logging
- Graceful shutdown and resource cleanup
- Structured audit trails
🏗️ Core Components
- SSEService: Primary agent execution and streaming service
- SessionManager: Session lifecycle and state management
- EventTranslator: ADK to AGUI event conversion engine
- HistoryService: Conversation history and retrieval
- HITL Handlers: Human intervention workflow management
🛠️ Technical Highlights
- Python 3.13 compatibility with modern async/await
- Pydantic v2 for robust data validation
- FastAPI integration ready
- Structured JSON logging with configurable levels
- Type hints throughout for excellent IDE support
- 100% docstring coverage for all APIs
📋 API Endpoints
- POST / - Agent execution with SSE streaming
- GET /thread/list - List user conversations
- DELETE /thread/{thread_id} - Delete conversation
- GET /state_snapshot/{thread_id} - Get session state
- PATCH /state/{thread_id} - Update session state
- GET /message_snapshot/{thread_id} - Get conversation history
🔧 Configuration
Session Locking
- Configurable timeout and retry logic
- Concurrent access protection
- Automatic cleanup of expired locks
Logging
- Structured JSON output
- Configurable log levels
- Optional raw event debugging
Multi-Tenant Support
- Flexible app/user/session context extraction
- Pluggable service configuration
- Customizable endpoint paths
📚 Documentation
- Complete API documentation with examples
- HITL workflow implementation guide
- Configuration reference
- Professional docstrings for all functions and classes
🔄 Getting Started
pip install adk-agui-middleware
Ready for production use with comprehensive documentation and professional-grade architecture.
Welcome to ADK AGUI Middleware v1.0.0! 🎉