🎉 Initial Beta Release #

This is the first public beta release of Flutter UI Agent.

✨ Core Features #

• LLM-Agnostic Architecture: Works with any LLM provider (Gemini, HuggingFace, OpenAI, etc.)
• Dynamic Action Registration: Wrap any widget to make it AI-controllable with AiActionWidget
• Smart Navigation Tracking: Automatic page tracking with AgentNavigatorObserver
• Async Operation Support: Handle navigation and async operations seamlessly
• Multi-Step Commands: Execute complex sequences like "Navigate to settings and enable dark mode"
• Type-Safe Parameters: Full Dart type safety with parameterized actions
• Cancellation Support: Cancel in-progress AI requests with immediate UI feedback

🎛️ Configuration #

• 6 Log Levels: none, error, warning, info, verbose, debug
• Configurable Retry Logic: Exponential, linear, or fixed backoff strategies
• Analytics Support: Track action usage and performance
• Mock Mode: Test without API keys using keyword-based matching
• Debug Mode: Detailed logging with emoji support for development

✅ Tested AI Models #

• Gemini: gemini-2.0-flash-exp
• HuggingFace: Qwen/Qwen3-235B-A22B-Instruct-2507

📱 Example App Features #

• Counter page with increment/decrement actions
• Profile page with bio/status updates
• Data browsing with search and filtering
• Shopping page with cart management
• Settings page with theme and AI configuration
• Floating chat overlay for natural language commands

🛠️ Technical Details #

• Event-driven architecture using StreamController
• Frame-based action pacing for smooth UI updates
• Navigation detection with 25+ action keywords
• Modern Flutter 3.27+ APIs (no deprecated code)
• Comprehensive error handling and logging

📚 Documentation #

• Complete README with quick start guide

• Example app with multiple use cases

• Configuration templates for easy setup

• Detailed API documentation

• Enhanced action descriptions are now used for better AI matching

• Improved error handling and user feedback

Technical #

• Added google_generative_ai package dependency
• Implemented function calling with Gemini's tool use API
• Created conversational response flow with AI