CRUX (Context Reactive User Experience) Interface

[deepsaia]

Description

This PR introduces CRUX (Context Reactive User Experience) - a next-generation conversational interface for nsflow that provides dynamic, context-aware interactions with AI agents through an adaptive themed environment.

Key Features

1. Widget + Message Integration

• Task-specific widget generation via cruse_widget_agent
• Users can now submit widget form data alongside typed messages in a single action
• Combined messages automatically format widget fields with user text
• Empty fields are automatically excluded
• Preserves standalone widget Submit button functionality

2. Intelligent Theme System

• Agent-specific background generation via cruse_theme_agent
• Dynamic patterns (css-doodle) and static css based gradients with customized user-prompt
• Fallback schemas ensure graceful degradation when theme generation fails
• Theme persistence per agent

3. Enhanced UI Controls

• Compact settings panel with theme toggle (Cruse/MUI), background type selector (Static/Dynamic)
• Refresh button with optional user prompt for theme customization
• Fine-grained opacity control (1% steps, 0-100%)
• Blur adjustment (0.1px steps, 0-10px) for glass-morphism effect
• Thread management with collapsible sidebar

Side Notes:

• Entire Cruse interface is gated behind NSFLOW_PLUGIN_CRUSE flag for controlled rollout
• Backend
  • New cruse_endpoints.py with threads and theme persistence APIs
  • Relies on cruse_widget_agent and cruse_theme_agent with css-doodle and gradient template providers
• Frontend
  • New pages: Cruse.tsx with chat interface
  • New components: CruseChatPanel, ThreadList, AgentSelector, DynamicWidgetCard, BackgroundEngine

Fixes #104 #109

Screenshots / Logs / Examples (optional)

Type of Change

• Bug fix
• New feature
• Dependency upgrade
• Refactoring / Improvement
• Documentation
• New agent / tool

Checklist

• Tested locally
• Added/updated tests
• Updated relevant documentation
• Added dependencies to appropriate requirements.txt (tool-specific preferred; main only for core functionality)

---

[ofrancon]

Shouldn't NSFLOW_PLUGIN_CRUSE be False by default?

[ofrancon]

Keep it being the feature flag for now. Thanks!