api endpoints for UI migration v5

API_DOCUMENTATION.md

@@ -97,6 +97,38 @@ client = Client(
 
 ---
 
+## User Management
+
+### Base User
+- `Admin_J` is the base/default API user
+- Used when no `user_id` is provided or invalid format is provided
+
+### Dynamic User Creation
+The API supports dynamic user creation - any valid format `user_id` is automatically accepted and created in the database.
+
+**Valid Format:**
+- Alphanumeric characters + underscore only
+- Length: 1-50 characters
+- Pattern: `^[a-zA-Z0-9_]{1,50}$`
+- Examples: `User123`, `External_API`, `MyUser_2024`, `API_Client_01`
+
+**Auto-Creation:**
+- New users are automatically inserted into the `user_contexts` database table on first use
+- No manual user registration required
+- User information is maintained by the backend database
+
+**Validation:**
+- Valid formats are accepted and auto-created
+- Invalid formats default to `Admin_J`
+- Database automatically maintains user information
+
+### UI Restriction
+- The HuggingFace Spaces UI is restricted to `ADMINONLY` user only
+- Dynamic user creation is available **only via API calls**
+- UI users cannot use dynamic user IDs
+
+---
+
 ## API Endpoints
 
 ### 1. Chat Handler - `/safe_gpu_chat_handler`
@@ -115,7 +147,7 @@ Process user messages and get AI responses.
 |-----------|------|----------|---------|-------------|
 | `message` | `str` | Yes | - | User message (max 10,000 characters) |
 | `history` | `list[dict]` | No | `[]` | Chat history in Gradio format |
-| `user_id` | `Literal[str]` | No | `"Test_Any"` | User identifier: `'Admin_J'`, `'Dev_K'`, `'Dev_H'`, `'Dev_A'`, `'Test_Any'` |
+| `user_id` | `str` | No | `"Admin_J"` | User identifier. Base user is `Admin_J`. Any valid format user_id (alphanumeric + underscore, 1-50 chars) is accepted and automatically created in the database. |
 | `session_text` | `str` | No | `"Session: ... \| User: ... \| Interactions: 0"` | Session information string |
 
 #### Response Structure
@@ -195,7 +227,7 @@ Returns a tuple of **7 elements**:
 
 **5. `session_info` (str)**
 ```python
-"Session: abc12345 | User: Test_Any | Interactions: 5"
+"Session: abc12345 | User: Admin_J | Interactions: 5"
 ```
 
 **6. `skills_html` (str)**
@@ -212,12 +244,21 @@ from gradio_client import Client
 
 client = Client("JatinAutonomousLabs/Research_AI_Assistant")
 
-# Make chat request
+# Make chat request (using base Admin_J user)
 result = client.predict(
     message="Explain quantum computing in simple terms",
     history=[],
-    user_id="Test_Any",
-    session_text="Session: abc12345 | User: Test_Any | Interactions: 0",
+    user_id="Admin_J",
+    session_text="Session: abc12345 | User: Admin_J | Interactions: 0",
+    api_name="/safe_gpu_chat_handler"
+)
+
+# Make chat request (using dynamic user - auto-created)
+result = client.predict(
+    message="What is machine learning?",
+    history=[],
+    user_id="MyNewUser_123",  # New user - automatically created in DB
+    session_text="Session: abc12345 | User: MyNewUser_123 | Interactions: 0",
     api_name="/safe_gpu_chat_handler"
 )
 
@@ -236,7 +277,12 @@ print(f"Response time: {processing_time:.2f}s")
 #### Validation Rules
 
 - **Message**: Must be non-empty string, max 10,000 characters
-- **User ID**: Must be one of: `Admin_J`, `Dev_K`, `Dev_H`, `Dev_A`, `Test_Any`
+- **User ID**: 
+  - Base user: `Admin_J` (default)
+  - Dynamic users: Any alphanumeric + underscore format (1-50 characters)
+  - New users are automatically created in the database on first use
+  - Invalid formats default to `Admin_J`
+  - Format validation: `^[a-zA-Z0-9_]{1,50}$`
 - **History**: Must be list (empty list if None)
 - **Session Text**: Format: `"Session: <8-char-id> | User: <user_id> | Interactions: <count>"`
 
@@ -268,14 +314,14 @@ Create a new conversation session.
 
 | Parameter | Type | Required | Default | Description |
 |-----------|------|----------|---------|-------------|
-| `user_id` | `Literal[str]` | No | `"Test_Any"` | User identifier |
+| `user_id` | `str` | No | `"Admin_J"` | User identifier. Base user is `Admin_J`. Any valid format user_id is accepted and automatically created in the database. |
 
 #### Response
 
 Returns a single string:
 
 ```python
-"Session: abc12345 | User: Test_Any | Interactions: 0"
+"Session: abc12345 | User: Admin_J | Interactions: 0"
 ```
 
 #### Code Example
@@ -293,7 +339,8 @@ print(session_info)  # "Session: xyz67890 | User: Admin_J | Interactions: 0"
 #### Behavior
 
 - Generates new 8-character hexadecimal session ID
-- Validates and normalizes user_id
+- Validates and normalizes user_id (defaults to `Admin_J` if invalid)
+- Auto-creates new users in database on first use
 - Initializes session in database via context_manager
 - Returns formatted session info string
 - Continues execution even if database initialization fails
@@ -314,7 +361,7 @@ Update session metadata (typically called when user changes).
 
 | Parameter | Type | Required | Default | Description |
 |-----------|------|----------|---------|-------------|
-| `user_id` | `Literal[str]` | No | `"Test_Any"` | New user identifier |
+| `user_id` | `str` | No | `"Admin_J"` | New user identifier. Base user is `Admin_J`. Any valid format user_id is accepted and automatically created in the database. |
 | `session_text` | `str` | No | `"Session: ... \| User: ... \| Interactions: 0"` | Current session text |
 
 #### Response
@@ -330,7 +377,7 @@ Returns updated session info string:
 ```python
 result = client.predict(
     user_id="Admin_J",
-    session_text="Session: abc12345 | User: Test_Any | Interactions: 3",
+    session_text="Session: abc12345 | User: Admin_J | Interactions: 3",
     api_name="/update_session_info"
 )
 
@@ -438,7 +485,7 @@ Returns status message string:
 ```python
 result = client.predict(
     mode="relevant",
-    session_id_text="Session: abc12345 | User: Test_Any | Interactions: 3",
+    session_id_text="Session: abc12345 | User: Admin_J | Interactions: 3",
     api_name="/handle_mode_change"
 )
 
@@ -602,8 +649,8 @@ def safe_chat_request(message, history, max_retries=3):
             result = client.predict(
                 message=message,
                 history=history,
-                user_id="Test_Any",
-                session_text="Session: abc12345 | User: Test_Any | Interactions: 0",
+                user_id="Admin_J",
+                session_text="Session: abc12345 | User: Admin_J | Interactions: 0",
                 api_name="/safe_gpu_chat_handler"
             )
             
@@ -646,10 +693,10 @@ class ResearchAIAssistant:
             hf_token=hf_token or os.getenv("HF_TOKEN")
         )
         self.session_info = None
-        self.user_id = "Test_Any"
+        self.user_id = "Admin_J"
         self.chat_history = []
     
-    def create_session(self, user_id: str = "Test_Any") -> str:
+    def create_session(self, user_id: str = "Admin_J") -> str:
         """Create new session"""
         self.user_id = user_id
         self.session_info = self.client.predict(
@@ -752,7 +799,7 @@ async def async_chat_request(message: str, history: List, session_text: str):
         lambda: client.predict(
             message=message,
             history=history,
-            user_id="Test_Any",
+            user_id="Admin_J",
             session_text=session_text,
             api_name="/safe_gpu_chat_handler"
         )
@@ -765,7 +812,7 @@ async def main():
     result = await async_chat_request(
         message="Hello",
         history=[],
-        session_text="Session: abc12345 | User: Test_Any | Interactions: 0"
+        session_text="Session: abc12345 | User: Admin_J | Interactions: 0"
     )
     print(result[0][-1]["content"])
 
@@ -794,7 +841,7 @@ client = Client("JatinAutonomousLabs/Research_AI_Assistant")
 
 ```python
 session_info = client.predict(
-    user_id="Test_Any",
+    user_id="Admin_J",
     api_name="/new_session"
 )
 ```
@@ -805,7 +852,7 @@ session_info = client.predict(
 result = client.predict(
     message="Your question here",
     history=[],
-    user_id="Test_Any",
+    user_id="Admin_J",
     session_text=session_info,
     api_name="/safe_gpu_chat_handler"
 )
@@ -855,7 +902,7 @@ class TestResearchAIAssistant(unittest.TestCase):
     def test_create_session(self):
         """Test session creation"""
         result = self.client.predict(
-            user_id="Test_Any",
+            user_id="Admin_J",
             api_name="/new_session"
         )
         self.assertIsInstance(result, str)
@@ -870,7 +917,7 @@ class TestResearchAIAssistant(unittest.TestCase):
         result = self.client.predict(
             message="Hello",
             history=[],
-            user_id="Test_Any",
+            user_id="Admin_J",
             session_text=self.session_info,
             api_name="/safe_gpu_chat_handler"
         )
@@ -904,7 +951,7 @@ def test_full_conversation_flow():
     client = Client("JatinAutonomousLabs/Research_AI_Assistant")
     
     # 1. Create session
-    session = client.predict(user_id="Test_Any", api_name="/new_session")
+    session = client.predict(user_id="Admin_J", api_name="/new_session")
     assert "Session:" in session
     
     # 2. Set context mode
@@ -916,7 +963,7 @@ def test_full_conversation_flow():
         result = client.predict(
             message=message,
             history=history,
-            user_id="Test_Any",
+            user_id="Admin_J",
             session_text=session,
             api_name="/safe_gpu_chat_handler"
         )
@@ -1036,7 +1083,7 @@ for attempt in range(max_retries):
 **Symptom**: `ValueError: Could not extract session_id`  
 **Solution**: Ensure session_text format is correct:
 ```
-"Session: abc12345 | User: Test_Any | Interactions: 0"
+"Session: abc12345 | User: Admin_J | Interactions: 0"
 ```
 
 #### 3. Empty Responses
@@ -1078,7 +1125,7 @@ context = result[4]  # Check session context
 #### Validate Session Info
 
 ```python
-session_info = "Session: abc12345 | User: Test_Any | Interactions: 0"
+session_info = "Session: abc12345 | User: Admin_J | Interactions: 0"
 
 # Validate format
 import re
@@ -1175,7 +1222,7 @@ session = None
 history = []
 
 # 2. Create session
-session = client.predict(user_id="Test_Any", api_name="/new_session")
+session = client.predict(user_id="Admin_J", api_name="/new_session")
 print(f"Created: {session}")
 
 # 3. Set context mode
@@ -1188,7 +1235,7 @@ for i in range(3):
     result = client.predict(
         message=user_message,
         history=history,
-        user_id="Test_Any",
+        user_id="Admin_J",
         session_text=session,
         api_name="/safe_gpu_chat_handler"
     )
@@ -1221,7 +1268,7 @@ def robust_chat_request(message, history, session_info, max_retries=3):
             result = client.predict(
                 message=message,
                 history=history,
-                user_id="Test_Any",
+                user_id="Admin_J",
                 session_text=session_info,
                 api_name="/safe_gpu_chat_handler"
             )

API_ENDPOINTS_IMPLEMENTATION_COMPLETE.md

@@ -28,7 +28,9 @@ All API endpoints have been enhanced with comprehensive validation, error handli
 
 **Key Features:**
 - Validates message length (max 10,000 characters)
-- Validates user_id against allowed values
+- Validates user_id format (alphanumeric + underscore, 1-50 chars)
+- Base user: Admin_J (default)
+- Dynamic users: Any valid format automatically created in database
 - Handles GPU decorator cleanup errors gracefully
 - Preserves all process flow logging functionality
 - Returns dynamic tuple matching interface components
@@ -46,7 +48,8 @@ All API endpoints have been enhanced with comprehensive validation, error handli
 - ✅ Comprehensive logging
 
 **Key Features:**
-- Validates user_id (defaults to 'Test_Any' if invalid)
+- Validates user_id format (defaults to 'Admin_J' if invalid)
+- Auto-creates new users in database on first use
 - Initializes session in database via context_manager
 - Continues even if database initialization fails
 - Returns formatted session info string
@@ -134,9 +137,12 @@ All API endpoints have been enhanced with comprehensive validation, error handli
 
 ### Core Helpers (Lines 666-823)
 
-1. **`_validate_user_id(user_id: str) -> str`**
-   - Validates user_id against allowed list
-   - Returns 'Test_Any' if invalid
+1. **`_validate_user_id(user_id: str, source: str = "api") -> str`**
+   - Validates user_id based on source (UI or API)
+   - UI source: Only allows 'ADMINONLY'
+   - API source: Accepts 'Admin_J' (base) or any valid format (auto-created)
+   - Returns 'Admin_J' if invalid format
+   - Auto-creates new users in database via `_ensure_user_exists()`
 
 2. **`_extract_session_id(session_text: str, allow_generate: bool) -> str`**
    - Robust parsing with multiple regex patterns
@@ -341,20 +347,28 @@ All endpoints:
 ### Example 1: Chat Handler with Validation
 
 ```python
-# Valid call
+# Valid call (base Admin_J user)
 result = safe_gpu_chat_handler(
     message="Hello",
     history=[],
-    user_id="Test_Any",
-    session_text="Session: abc12345 | User: Test_Any | Interactions: 0"
+    user_id="Admin_J",
+    session_text="Session: abc12345 | User: Admin_J | Interactions: 0"
+)
+
+# Valid call (dynamic user - auto-created)
+result = safe_gpu_chat_handler(
+    message="Hello",
+    history=[],
+    user_id="ExternalAPI_User123",  # New user - auto-created in DB
+    session_text="Session: abc12345 | User: ExternalAPI_User123 | Interactions: 0"
 )
 
 # Invalid call (empty message) - returns error response
 result = safe_gpu_chat_handler(
     message="",
     history=[],
-    user_id="Test_Any",
-    session_text="Session: abc12345 | User: Test_Any | Interactions: 0"
+    user_id="Admin_J",
+    session_text="Session: abc12345 | User: Admin_J | Interactions: 0"
 )
 ```
 
@@ -377,7 +391,7 @@ save_preferences(
 # Update session info - preserves session ID
 update_session_info(
     user_id="Admin_J",
-    session_text="Session: abc12345 | User: Test_Any | Interactions: 5"
+    session_text="Session: abc12345 | User: Admin_J | Interactions: 5"
 )
 # Returns: "Session: abc12345 | User: Admin_J | Interactions: 5"
 # Session ID preserved, interaction count from database

API_QUICK_REFERENCE.md

@@ -22,34 +22,61 @@ client = Client("JatinAutonomousLabs/Research_AI_Assistant")
 
 ---
 
+## User Management
+
+**Base User:** `Admin_J` (default)  
+**Dynamic Users:** Any valid format (alphanumeric + underscore, 1-50 chars) - auto-created in DB  
+**Format:** `^[a-zA-Z0-9_]{1,50}$`  
+**UI Restriction:** HuggingFace Spaces UI limited to `ADMINONLY` only
+
+---
+
 ## All Available Endpoints
 
 ### 1. Chat Handler
 ```python
+# Using base Admin_J user
 result = client.predict(
     message="Your question",
     history=[],
-    user_id="Test_Any",
-    session_text="Session: abc12345 | User: Test_Any | Interactions: 0",
+    user_id="Admin_J",
+    session_text="Session: abc12345 | User: Admin_J | Interactions: 0",
     api_name="/safe_gpu_chat_handler"
 )
 # Returns: (history, input, reasoning, performance, context, session_info, skills)
+
+# Using dynamic user (auto-created)
+result = client.predict(
+    message="Your question",
+    history=[],
+    user_id="ExternalAPI_User123",  # New user - auto-created in DB
+    session_text="Session: abc12345 | User: ExternalAPI_User123 | Interactions: 0",
+    api_name="/safe_gpu_chat_handler"
+)
 ```
 
 ### 2. New Session
 ```python
+# Base user
+session = client.predict(
+    user_id="Admin_J",
+    api_name="/new_session"
+)
+# Returns: "Session: xyz67890 | User: Admin_J | Interactions: 0"
+
+# Dynamic user (auto-created)
 session = client.predict(
-    user_id="Test_Any",
+    user_id="MyNewUser_2024",
     api_name="/new_session"
 )
-# Returns: "Session: xyz67890 | User: Test_Any | Interactions: 0"
+# Returns: "Session: xyz67890 | User: MyNewUser_2024 | Interactions: 0"
 ```
 
 ### 3. Update Session Info
 ```python
 updated = client.predict(
     user_id="Admin_J",
-    session_text="Session: abc12345 | User: Test_Any | Interactions: 3",
+    session_text="Session: abc12345 | User: Admin_J | Interactions: 3",
     api_name="/update_session_info"
 )
 # Returns: "Session: abc12345 | User: Admin_J | Interactions: 3"
@@ -69,7 +96,7 @@ client.predict(api_name="/toggle_settings_from_nav")
 ```python
 status = client.predict(
     mode="relevant",
-    session_id_text="Session: abc12345 | User: Test_Any | Interactions: 3",
+    session_id_text="Session: abc12345 | User: Admin_J | Interactions: 3",
     api_name="/handle_mode_change"
 )
 # Returns: "*Current: Relevant Context*"
@@ -137,7 +164,7 @@ result = client.predict(
 | Parameter | Validation |
 |-----------|------------|
 | `message` | Non-empty, max 10,000 chars |
-| `user_id` | One of: `Admin_J`, `Dev_K`, `Dev_H`, `Dev_A`, `Test_Any` |
+| `user_id` | Base: `Admin_J` (default). Dynamic: Any `[a-zA-Z0-9_]{1,50}` - auto-created |
 | `mode` | One of: `'fresh'`, `'relevant'` |
 | `response_speed` | One of: `'Fast'`, `'Balanced'`, `'Thorough'` |
 | `session_text` | Format: `"Session: <8-hex> | User: <user_id> | Interactions: <num>"` |
@@ -148,8 +175,8 @@ result = client.predict(
 
 ### Full Conversation Flow
 ```python
-# 1. Create session
-session = client.predict(user_id="Test_Any", api_name="/new_session")
+# 1. Create session (using base Admin_J user)
+session = client.predict(user_id="Admin_J", api_name="/new_session")
 
 # 2. Set context mode
 client.predict(mode="relevant", session_id_text=session, api_name="/handle_mode_change")
@@ -159,12 +186,17 @@ history = []
 for msg in ["Q1", "Q2", "Q3"]:
     result = client.predict(
         message=msg, history=history,
-        user_id="Test_Any", session_text=session,
+        user_id="Admin_J", session_text=session,
         api_name="/safe_gpu_chat_handler"
     )
     history = result[0]
     session = result[5]  # Update session
     print(result[0][-1]["content"])  # Print response
+
+# Example with dynamic user (auto-created on first use)
+dynamic_user = "ExternalAPI_Client01"
+session = client.predict(user_id=dynamic_user, api_name="/new_session")
+# User automatically created in database
 ```
 
 ### Error Handling
@@ -184,14 +216,14 @@ except Exception as e:
 ### `/safe_gpu_chat_handler`
 - `message` (str, required)
 - `history` (list, default: [])
-- `user_id` (str, default: "Test_Any")
+- `user_id` (str, default: "Admin_J") - Base user or any valid format (auto-created)
 - `session_text` (str, default: "Session: ... | User: ... | Interactions: 0")
 
 ### `/new_session`
-- `user_id` (str, default: "Test_Any")
+- `user_id` (str, default: "Admin_J") - Base user or any valid format (auto-created)
 
 ### `/update_session_info`
-- `user_id` (str, default: "Test_Any")
+- `user_id` (str, default: "Admin_J") - Base user or any valid format (auto-created)
 - `session_text` (str, required)
 
 ### `/handle_mode_change`

app.py

@@ -231,7 +231,8 @@ def create_mobile_optimized_interface():
                     show_label=False,
                     container=False,
                     scale=1,
-                    min_width=100
+                    min_width=100,
+                    interactive=False  # Non-interactive since only one option (ADMINONLY)
                 )
                 interface_components['user_dropdown'] = user_dropdown