local-deep-research 0.5.9__py3-none-any.whl → 0.6.1__py3-none-any.whl

local_deep_research/web/static/js/research_form.js

@@ -1,10 +1,12 @@
 /**
- * Research form handling with settings management
+ * Research form handling with settings management and warnings
  */
 
+// Global settings cache for warning logic
+let globalSettings = {};
+
 document.addEventListener('DOMContentLoaded', function() {
     // Initialize the research form
-    console.log('DOM loaded, initializing research form');
     initResearchForm();
 });
 
@@ -12,13 +14,12 @@ document.addEventListener('DOMContentLoaded', function() {
  * Initialize the research form with values from settings
  */
 function initResearchForm() {
-    console.log('Initializing research form...');
     // Get form elements
     const iterationsInput = document.getElementById('iterations');
     const questionsInput = document.getElementById('questions_per_iteration');
 
     // Fetch all settings at once (more efficient)
-    fetch('/research/settings/api')
+    fetch(URLS.SETTINGS_API.BASE)
         .then(response => {
             if (!response.ok) {
                 throw new Error('Failed to fetch settings');
@@ -26,28 +27,30 @@ function initResearchForm() {
             return response.json();
         })
         .then(data => {
-            console.log('Loaded settings:', data);
             if (data && data.status === 'success' && data.settings) {
                 // Find our specific settings
                 const settings = data.settings;
 
+                // Cache settings globally for warning logic
+                globalSettings = settings;
+
                 // Look for the iterations setting
                 for (const key in settings) {
                     const setting = settings[key];
                     if (key === 'search.iterations') {
-                        console.log('Found iterations setting:', setting.value);
                         iterationsInput.value = setting.value;
                     }
 
                     if (key === 'search.questions_per_iteration') {
-                        console.log('Found questions setting:', setting.value);
                         questionsInput.value = setting.value;
                     }
                 }
+
+                // Initialize warnings after settings are loaded
+                initializeWarnings();
             }
         })
         .catch(error => {
-            console.warn('Error loading research settings:', error);
             // Form will use default values if settings can't be loaded
         });
 
@@ -79,13 +82,12 @@ function saveResearchSettings() {
     const iterations = document.getElementById('iterations').value;
     const questions = document.getElementById('questions_per_iteration').value;
 
-    console.log('Saving research settings:', { iterations, questions });
 
     // Get CSRF token
     const csrfToken = document.querySelector('meta[name="csrf-token"]').getAttribute('content');
 
     // Save settings
-    fetch('/research/settings/save_all_settings', {
+    fetch(URLS.SETTINGS_API.SAVE_ALL_SETTINGS, {
         method: 'POST',
         headers: {
             'Content-Type': 'application/json',
@@ -98,9 +100,262 @@ function saveResearchSettings() {
     })
     .then(response => response.json())
     .then(data => {
-        console.log('Settings saved:', data);
     })
     .catch(error => {
-        console.warn('Error saving research settings:', error);
     });
 }
+
+/**
+ * Initialize warning system
+ */
+function initializeWarnings() {
+
+    // Check warnings on form load
+    checkAndDisplayWarnings();
+
+    // Monitor form changes for dynamic warnings
+    setupWarningListeners();
+
+    // Clear any stale warnings immediately when initializing
+    setTimeout(() => {
+        checkAndDisplayWarnings();
+    }, 100);
+}
+
+/**
+ * Setup event listeners for settings changes
+ */
+function setupWarningListeners() {
+    // Monitor provider changes directly and refetch settings
+    const providerSelect = document.getElementById('model_provider');
+    if (providerSelect) {
+        providerSelect.addEventListener('change', function() {
+            // Wait a bit longer for the saveProviderSetting API call to complete
+            setTimeout(refetchSettingsAndUpdateWarnings, 500);
+        });
+    }
+
+    // Hook into the existing saveProviderSetting function if it exists
+    // This will trigger when the research.js calls saveProviderSetting
+    if (typeof window.saveProviderSetting === 'function') {
+        const originalSaveProviderSetting = window.saveProviderSetting;
+        window.saveProviderSetting = function(providerValue) {
+            // Call the original function
+            const result = originalSaveProviderSetting.apply(this, arguments);
+            // After it completes, refetch settings and update warnings
+            setTimeout(refetchSettingsAndUpdateWarnings, 200);
+            return result;
+        };
+    }
+
+    // Monitor search engine changes
+    const searchEngineInput = document.getElementById('search_engine');
+    if (searchEngineInput) {
+        searchEngineInput.addEventListener('change', function() {
+            // Refresh warnings immediately when search engine changes
+            setTimeout(checkAndDisplayWarnings, 100);
+        });
+    }
+
+    const strategySelect = document.getElementById('strategy');
+    if (strategySelect) {
+        strategySelect.addEventListener('change', function() {
+
+            // Save strategy to localStorage
+            // Strategy saved to database via API
+
+            // Save strategy to database
+            const csrfToken = document.querySelector('meta[name="csrf-token"]')?.content;
+            fetch('/research/settings/api/search.search_strategy', {
+                method: 'PUT',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfToken
+                },
+                body: JSON.stringify({ value: strategySelect.value })
+            })
+            .then(response => response.json())
+            .then(data => {
+            })
+            .catch(error => {
+            });
+
+            setTimeout(checkAndDisplayWarnings, 100);
+        });
+    }
+
+    // Use Socket.IO to listen for settings changes if available (backup)
+    if (typeof io !== 'undefined') {
+        const socket = io();
+        socket.on('settings_changed', function(data) {
+            // Update global settings cache
+            if (data.settings) {
+                Object.assign(globalSettings, data.settings);
+            }
+            // Recheck warnings with new settings
+            setTimeout(checkAndDisplayWarnings, 100);
+        });
+
+        socket.on('connect', function() {
+        });
+    }
+}
+
+/**
+ * Refetch settings from the server and update warnings
+ */
+function refetchSettingsAndUpdateWarnings() {
+
+    fetch(URLS.SETTINGS_API.BASE)
+        .then(response => {
+            if (!response.ok) {
+                throw new Error('Failed to fetch settings');
+            }
+            return response.json();
+        })
+        .then(data => {
+            if (data && data.status === 'success' && data.settings) {
+                // Update global settings cache
+                globalSettings = data.settings;
+            }
+            // Recheck warnings from backend (not from cached settings)
+            setTimeout(checkAndDisplayWarnings, 100);
+        })
+        .catch(error => {
+            // Still try to check warnings from backend
+            setTimeout(checkAndDisplayWarnings, 100);
+        });
+}
+
+/**
+ * Manually clear all warnings (useful for debugging stale warnings)
+ */
+function clearAllWarnings() {
+    displayWarnings([]);
+}
+
+// Make functions globally available for other scripts
+window.refetchSettingsAndUpdateWarnings = refetchSettingsAndUpdateWarnings;
+window.displayWarnings = displayWarnings;
+window.clearAllWarnings = clearAllWarnings;
+window.checkAndDisplayWarnings = checkAndDisplayWarnings;
+
+/**
+ * Check warning conditions by fetching from backend
+ */
+function checkAndDisplayWarnings() {
+
+    // Get warnings from backend API instead of calculating locally
+    fetch(URLS.SETTINGS_API.WARNINGS)
+        .then(response => {
+            if (!response.ok) {
+                throw new Error('Failed to fetch warnings');
+            }
+            return response.json();
+        })
+        .then(data => {
+            if (data && data.warnings) {
+                displayWarnings(data.warnings);
+            } else {
+                displayWarnings([]);
+            }
+        })
+        .catch(error => {
+            // Clear warnings on error
+            displayWarnings([]);
+        });
+}
+
+/**
+ * Display warnings in the alert container
+ */
+function displayWarnings(warnings) {
+    const alertContainer = document.getElementById('research-alert');
+    if (!alertContainer) return;
+
+    if (warnings.length === 0) {
+        alertContainer.style.display = 'none';
+        alertContainer.innerHTML = '';
+        return;
+    }
+
+    const warningsHtml = warnings.map(warning => {
+        // Use green styling for recommendations/tips
+        const isRecommendation = warning.type === 'searxng_recommendation';
+        const bgColor = isRecommendation ? '#d4edda' : '#fff3cd';
+        const borderColor = isRecommendation ? '#c3e6cb' : '#ffeaa7';
+        const textColor = isRecommendation ? '#155724' : '#856404';
+
+        return `
+        <div class="warning-banner warning-${warning.type}" style="
+            background: ${bgColor};
+            border: 1px solid ${borderColor};
+            border-radius: 6px;
+            padding: 12px 16px;
+            margin-bottom: 8px;
+            display: flex;
+            align-items: flex-start;
+            gap: 12px;
+        ">
+            <span style="font-size: 16px; flex-shrink: 0;">${warning.icon}</span>
+            <div style="flex: 1;">
+                <div style="font-weight: 600; color: ${textColor}; margin-bottom: 4px;">
+                    ${warning.title}
+                </div>
+                <div style="color: ${textColor}; font-size: 14px; line-height: 1.4;">
+                    ${warning.message}
+                </div>
+            </div>
+            <button onclick="dismissWarning('${warning.dismissKey}')" style="
+                background: none;
+                border: none;
+                color: ${textColor};
+                cursor: pointer;
+                padding: 4px;
+                font-size: 16px;
+                flex-shrink: 0;
+            ">&times;</button>
+        </div>
+        `;
+    }).join('');
+
+    alertContainer.innerHTML = warningsHtml;
+    alertContainer.style.display = 'block';
+}
+
+/**
+ * Dismiss a warning by updating the setting
+ */
+function dismissWarning(dismissKey) {
+
+    // Get CSRF token
+    const csrfToken = document.querySelector('meta[name="csrf-token"]').getAttribute('content');
+
+    // Update dismissal setting
+    fetch(URLS.SETTINGS_API.SAVE_ALL_SETTINGS, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'X-CSRFToken': csrfToken
+        },
+        body: JSON.stringify({
+            [dismissKey]: true
+        })
+    })
+    .then(response => response.json())
+    .then(data => {
+        // Update global settings cache
+        globalSettings[dismissKey] = { value: true };
+        // Recheck warnings
+        checkAndDisplayWarnings();
+    })
+    .catch(error => {
+    });
+}
+
+/**
+ * Helper function to get settings
+ */
+function getSetting(key, defaultValue) {
+    return globalSettings[key] ? globalSettings[key].value : defaultValue;
+}

local_deep_research/web/static/js/services/api.js

@@ -5,7 +5,7 @@
 
 // Base URL for API - use existing one if already declared
 if (typeof API_BASE_URL === 'undefined') {
-    const API_BASE_URL = '/research/api';
+    const API_BASE_URL = '/api';
 }
 
 /**
@@ -78,7 +78,7 @@ async function postJSON(path, data) {
  * @returns {Promise<Object>} The research response with ID
  */
 async function startResearch(query, mode) {
-    return postJSON('/research/api/start_research', { query, mode });
+    return postJSON(URLS.API.START_RESEARCH, { query, mode });
 }
 
 /**
@@ -87,7 +87,7 @@ async function startResearch(query, mode) {
  * @returns {Promise<Object>} The research status
  */
 async function getResearchStatus(researchId) {
-    return fetchWithErrorHandling(`/research/api/status/${researchId}`);
+    return fetchWithErrorHandling(URLBuilder.researchStatus(researchId));
 }
 
 /**
@@ -96,7 +96,7 @@ async function getResearchStatus(researchId) {
  * @returns {Promise<Object>} The research details
  */
 async function getResearchDetails(researchId) {
-    return fetchWithErrorHandling(`/research/api/details/${researchId}`);
+    return fetchWithErrorHandling(URLBuilder.researchDetails(researchId));
 }
 
 /**
@@ -105,7 +105,7 @@ async function getResearchDetails(researchId) {
  * @returns {Promise<Object>} The research logs
  */
 async function getResearchLogs(researchId) {
-    return fetchWithErrorHandling(`/research/api/logs/${researchId}`);
+    return fetchWithErrorHandling(URLBuilder.researchLogs(researchId));
 }
 
 /**
@@ -113,7 +113,7 @@ async function getResearchLogs(researchId) {
  * @returns {Promise<Array>} The research history
  */
 async function getResearchHistory() {
-    return fetchWithErrorHandling('/research/api/history');
+    return fetchWithErrorHandling(URLS.API.HISTORY);
 }
 
 /**
@@ -122,7 +122,7 @@ async function getResearchHistory() {
  * @returns {Promise<Object>} The research report
  */
 async function getReport(researchId) {
-    return fetchWithErrorHandling(`/research/api/report/${researchId}`);
+    return fetchWithErrorHandling(URLBuilder.researchReport(researchId));
 }
 
 /**
@@ -131,7 +131,7 @@ async function getReport(researchId) {
  * @returns {Promise<Object>} The termination response
  */
 async function terminateResearch(researchId) {
-    return postJSON(`/research/api/terminate/${researchId}`, {});
+    return postJSON(URLBuilder.terminateResearch(researchId), {});
 }
 
 /**
@@ -141,7 +141,7 @@ async function terminateResearch(researchId) {
  */
 async function deleteResearch(researchId) {
     const csrfToken = getCsrfToken();
-    return fetchWithErrorHandling(`/research/api/delete/${researchId}`, {
+    return fetchWithErrorHandling(URLBuilder.deleteResearch(researchId), {
         method: 'DELETE',
         headers: {
             'X-CSRFToken': csrfToken
@@ -154,7 +154,7 @@ async function deleteResearch(researchId) {
  * @returns {Promise<Object>} The response
  */
 async function clearResearchHistory() {
-    return postJSON('/research/api/clear_history', {});
+    return postJSON(URLS.API.CLEAR_HISTORY, {});
 }
 
 /**
@@ -163,7 +163,7 @@ async function clearResearchHistory() {
  * @returns {Promise<Object>} The response
  */
 async function openFileLocation(path) {
-    return postJSON('/research/open_file_location', { path });
+    return postJSON('/api/open_file_location', { path });
 }
 
 /**
@@ -172,7 +172,7 @@ async function openFileLocation(path) {
  * @returns {Promise<Object>} The response
  */
 async function saveRawConfig(rawConfig) {
-    return postJSON('/research/api/save_raw_config', { raw_config: rawConfig });
+    return postJSON(URLS.API.SAVE_RAW_CONFIG, { raw_config: rawConfig });
 }
 
 /**
@@ -181,7 +181,7 @@ async function saveRawConfig(rawConfig) {
  * @returns {Promise<Object>} The response
  */
 async function saveMainConfig(config) {
-    return postJSON('/research/api/save_main_config', config);
+    return postJSON(URLS.API.SAVE_MAIN_CONFIG, config);
 }
 
 /**
@@ -190,7 +190,7 @@ async function saveMainConfig(config) {
  * @returns {Promise<Object>} The response
  */
 async function saveSearchEnginesConfig(config) {
-    return postJSON('/research/api/save_search_engines_config', config);
+    return postJSON(URLS.API.SAVE_SEARCH_ENGINES_CONFIG, config);
 }
 
 /**
@@ -199,7 +199,7 @@ async function saveSearchEnginesConfig(config) {
  * @returns {Promise<Object>} The response
  */
 async function saveCollectionsConfig(config) {
-    return postJSON('/research/api/save_collections_config', config);
+    return postJSON(URLS.API.SAVE_COLLECTIONS_CONFIG, config);
 }
 
 /**
@@ -208,7 +208,7 @@ async function saveCollectionsConfig(config) {
  * @returns {Promise<Object>} The response
  */
 async function saveApiKeysConfig(config) {
-    return postJSON('/research/api/save_api_keys_config', config);
+    return postJSON(URLS.API.SAVE_API_KEYS_CONFIG, config);
 }
 
 /**
@@ -217,7 +217,7 @@ async function saveApiKeysConfig(config) {
  * @returns {Promise<Object>} The response
  */
 async function saveLlmConfig(config) {
-    return postJSON('/research/api/save_llm_config', config);
+    return postJSON(URLS.API.SAVE_LLM_CONFIG, config);
 }
 
 /**
@@ -226,7 +226,7 @@ async function saveLlmConfig(config) {
  * @returns {Promise<Object>} The markdown content
  */
 async function getMarkdownExport(researchId) {
-    return fetchWithErrorHandling(`/research/api/markdown/${researchId}`);
+    return fetchWithErrorHandling(URLBuilder.markdownExport(researchId));
 }
 
 // Export the API functions

local_deep_research/web/static/js/services/keyboard.js

@@ -12,35 +12,35 @@
             description: 'Return to main search',
             handler: () => {
                 // Always navigate to main research page
-                window.location.href = '/';
+                window.location.href = URLS.PAGES.HOME;
             }
         },
         'navNewResearch': {
             keys: ['ctrl+shift+1'],
             description: 'Go to New Research',
             handler: () => {
-                window.location.href = '/';
+                window.location.href = URLS.PAGES.HOME;
             }
         },
         'navHistory': {
             keys: ['ctrl+shift+2'],
             description: 'Go to History',
             handler: () => {
-                window.location.href = '/research/history';
+                window.location.href = URLS.PAGES.HISTORY;
             }
         },
         'navMetrics': {
             keys: ['ctrl+shift+3'],
             description: 'Go to Metrics',
             handler: () => {
-                window.location.href = '/metrics';
+                window.location.href = URLS.PAGES.METRICS;
             }
         },
         'navSettings': {
             keys: ['ctrl+shift+4'],
             description: 'Go to Settings',
             handler: () => {
-                window.location.href = '/research/settings';
+                window.location.href = URLS.PAGES.SETTINGS;
             }
         }
     };
@@ -153,7 +153,7 @@
         const allShortcuts = { ...shortcuts };
 
         // Add page-specific shortcuts
-        if (currentPath.includes('/research/progress/')) {
+        if (currentPath.includes('/progress/')) {
             allShortcuts.viewResults = {
                 keys: ['enter'],
                 description: 'View results (when complete)',
@@ -166,11 +166,11 @@
             };
         }
 
-        if (currentPath.includes('/research/results/')) {
+        if (currentPath.includes('/results/')) {
             allShortcuts.escape = {
                 keys: ['escape'],
                 description: 'Back to new search',
-                handler: () => window.location.href = '/'
+                handler: () => window.location.href = URLS.PAGES.HOME
             };
         }