Skip to content

v0.2.6 - UI Manager Debugging Release

Choose a tag to compare

@jwesleye jwesleye released this 19 Sep 15:12
· 12 commits to main since this release

🔍 Enhanced Debugging for UI File Detection Issues

This debugging release adds comprehensive logging to identify why the UI manager fails to detect React SPA files in PyPI installations, causing fallback to static HTML instead of the proper chat interface.

🔬 Enhanced Debugging Features

UIManager Initialization Logging:

  • UIManager: Using development/installed UI source at [path]
  • UIManager: dist_dir=[path], package_json=[path]
  • UIManager: dist_dir exists=[true/false]
  • UIManager: dist_dir contents=[file list]

Copy Operation Debugging:

  • Detailed error messages showing actual file paths
  • Directory existence and contents logging
  • Clear identification of PyPI vs development installations

🎯 Root Cause Investigation

This release helps diagnose the specific issue where:

  1. React assets ARE included in PyPI packages (index-95a3109d.js, etc.)
  2. UI manager fails to detect these files during Docker build
  3. 🔄 Fallback HTML created instead of copying React SPA
  4. 📄 Static description page shown instead of chat interface

🔍 What to Look For

After installing this version, the logs will show exactly:

  • Where the UI manager is looking for files
  • What files it finds (or doesn't find)
  • Why the is_ui_built() check fails
  • The specific error in copy_dist_to_context()

⚠️ This is a Diagnostic Release

  • Purpose: Identify exact file path and detection issues
  • Not a Fix: Adds debugging, doesn't resolve the core issue yet
  • Next Step: Use debug output to implement proper fix

🧪 Testing Instructions

  1. Install: pip install --upgrade any-agent-wrapper==0.2.6
  2. Deploy with logging: python -m any_agent . --rebuild-ui --remove
  3. Check logs: Look for UIManager: debug messages
  4. Report findings: Debug output will reveal the exact root cause

This detailed logging will finally show us why the UI file detection is failing in PyPI Docker deployments.

Full Changelog: v0.2.5...v0.2.6