Skip to content

v0.2.7 - Stable UI Routing Fix

Choose a tag to compare

View all tags
@jwesleye jwesleye released this 19 Sep 15:27
· 11 commits to main since this release
v0.2.7
45e3441

🎉 Stable Release - UI Routing Issue Resolved

This stable release confirms the successful resolution of the critical UI routing issue where PyPI Docker deployments were showing static description pages instead of the React chat interface.

✅ Issue Resolution Confirmed

Problem Solved:

  • ✅ React SPA Loading: Chat interface now loads correctly in Docker deployments
  • ✅ Proper Routing: ChatPage renders as default instead of DescriptionPage
  • ✅ API Connectivity: Chat initialization and session management working
  • ✅ Asset Serving: React bundles and Material UI components load properly

Root Cause Fixed:

  • Enhanced UIBuildManager file detection logic for PyPI installations
  • Improved error handling in copy_dist_to_context() method
  • Better debugging output for troubleshooting future issues

🔍 Technical Resolution

The issue was caused by the UI manager failing to detect built React assets in PyPI installations, causing it to fall back to static HTML instead of copying the React SPA files. The fix included:

  1. Enhanced File Detection: Improved is_ui_built() method for PyPI environments
  2. Better Error Reporting: Detailed logging shows actual file paths and detection results
  3. Robust Fallback: Maintains functionality even when debugging is enabled

🚀 Verified Functionality

Console Output Confirms Success:

Any Agent React SPA - Starting initialization ✅
Rendering ChatPage as default (not DescriptionPage) ✅
Starting chat initialization... ✅
Session creation result: Object ✅

Asset Loading Verified:

  • React bundle: /assets/index-95a3109d.js ✅
  • Material UI: /assets/mui-8c8f0834.js ✅
  • CSS and fonts: Loading correctly ✅

🔧 Enhanced Debugging (Preserved)

The debugging improvements from v0.2.6 are maintained to help with future troubleshooting:

  • UIManager initialization logging
  • File detection and existence checks
  • Copy operation detailed error messages
  • PyPI vs development installation detection

📦 Production Ready

This release is stable and ready for production use:

  • ✅ All existing functionality preserved
  • ✅ Chat interface works in Docker deployments
  • ✅ MCP integration continues to function
  • ✅ No breaking changes to existing APIs

🔄 Upgrade Instructions

For existing deployments experiencing the UI routing issue:

  1. Update: pip install --upgrade any-agent-wrapper==0.2.7
  2. Redeploy: python -m any_agent . --rebuild-ui --remove
  3. Verify: Check that chat interface loads at root URL

Full Changelog: v0.2.6...v0.2.7

Assets 4
Loading