imcp 0.0.14 → 0.0.16

package/dist/utils/osUtils.js

@@ -88,8 +88,6 @@ export async function installCLI(tool) {
 }
 /**
  * Refreshes the PATH environment variable for the current Node.js process
- * This is necessary because when tools are installed using package managers,
- * they update the system PATH but the current Node process doesn't see those changes.
  */
 export async function refreshPathEnv() {
     const osType = getOSType();
@@ -139,6 +137,61 @@ export async function refreshPathEnv() {
         // Continue execution even if PATH refresh fails
     }
 }
+/**
+ * Check if a command is available on the system
+ * Handles special cases for VS Code on different platforms
+ */
+export async function isCommandAvailable(command) {
+    try {
+        // For VS Code on macOS, check both command-line tool and app bundle
+        if (process.platform === 'darwin' && (command === 'code' || command === 'code-insiders')) {
+            try {
+                // Try which command first
+                await execAsync(`which ${command}`);
+                return true;
+            }
+            catch (error) {
+                // If which fails, check application bundles
+                const systemVSCodePath = command === 'code' ?
+                    '/Applications/Visual Studio Code.app' :
+                    '/Applications/Visual Studio Code - Insiders.app';
+                try {
+                    // Check system Applications first
+                    await execAsync(`test -d "${systemVSCodePath}"`);
+                    return true;
+                }
+                catch (error) {
+                    // If system Applications check fails, try user Applications
+                    const homedir = process.env.HOME;
+                    if (homedir) {
+                        const userVSCodePath = command === 'code' ?
+                            `${homedir}/Applications/Visual Studio Code.app` :
+                            `${homedir}/Applications/Visual Studio Code - Insiders.app`;
+                        try {
+                            await execAsync(`test -d "${userVSCodePath}"`);
+                            return true;
+                        }
+                        catch (error) {
+                            return false;
+                        }
+                    }
+                    return false;
+                }
+            }
+        }
+        // For Windows, use where command
+        if (process.platform === 'win32') {
+            await execAsync(`where ${command}`);
+            return true;
+        }
+        // For all other cases (Unix-like systems), use which command
+        await execAsync(`which ${command}`);
+        return true;
+    }
+    catch (error) {
+        return false;
+    }
+}
 export async function isToolInstalled(tool, retries = 3) {
     try {
         Logger.debug({
@@ -181,11 +234,6 @@ export async function isToolInstalled(tool, retries = 3) {
         return false;
     }
 }
-/**
- * Opens a URL in the default browser
- * @param url The URL to open
- * @returns A promise that resolves when the browser is launched
- */
 export async function openBrowser(url) {
     const osType = getOSType();
     Logger.debug({
@@ -234,12 +282,6 @@ export async function openBrowser(url) {
         // Don't throw the error - just log it and continue
     }
 }
-/**
- * Gets the directory containing Python packages (site-packages) based on Python executable path.
- * Handles different Python installations (system, venv, conda) across different OS platforms.
- * @param pythonExecutablePath The full path to the Python executable
- * @returns The site-packages directory path
- */
 export function getPythonPackagePath(pythonExecutablePath) {
     Logger.debug({
         action: 'get_python_package_path',
@@ -250,8 +292,29 @@ export function getPythonPackagePath(pythonExecutablePath) {
         const isWindows = process.platform === 'win32';
         // Handle common Python installation patterns
         if (isWindows) {
-            // Windows: Check for Scripts directory (venv) or python.exe location
-            if (dir.endsWith('Scripts')) {
+            // Windows: Handle different Python installations
+            if (dir.endsWith('WindowsApps')) {
+                // For Windows Store Python, find the actual Python installation directory
+                const entries = fs.readdirSync(dir);
+                const pythonDir = entries.find(e => e.startsWith('PythonSoftwareFoundation.Python'));
+                if (pythonDir && pythonDir.includes('.')) {
+                    // Extract version from format like "PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0"
+                    const parts = pythonDir.split('.');
+                    const majorVer = parts[2];
+                    const minorVer = parts[3].split('_')[0];
+                    const version = majorVer + minorVer; // Combines "3" and "13" to "313"
+                    const localAppData = process.env.LOCALAPPDATA;
+                    if (localAppData) {
+                        const sitePkgsPath = path.join(localAppData, 'Packages', pythonDir, 'LocalCache', 'local-packages', 'Python' + version, 'site-packages');
+                        Logger.debug(`Resolved Windows Store Python site-packages path: ${sitePkgsPath}`);
+                        return sitePkgsPath;
+                    }
+                }
+                Logger.debug('Could not resolve Windows Store Python site-packages path');
+                // Fallback to user's site-packages
+                return path.join(process.env.APPDATA || '', 'Python', 'Python3', 'site-packages');
+            }
+            else if (dir.endsWith('Scripts')) {
                 // Virtual environment structure on Windows: <venv>/Scripts/python.exe
                 const venvRoot = path.dirname(dir);
                 return path.join(venvRoot, 'Lib', 'site-packages');
@@ -304,10 +367,6 @@ export function getPythonPackagePath(pythonExecutablePath) {
         return path.dirname(pythonExecutablePath);
     }
 }
-/**
- * Finds the directory of the system's default Python installation.
- * @returns The directory path or null if not found.
- */
 export async function getSystemPythonPackageDirectory() {
     const command = process.platform === 'win32' ? 'where python' : 'which python';
     Logger.debug({
@@ -335,10 +394,6 @@ export async function getSystemPythonPackageDirectory() {
         return null;
     }
 }
-/**
- * Gets the path of the system's default browser.
- * @returns The path to the default browser executable.
- */
 export async function GetBrowserPath() {
     const osType = getOSType();
     Logger.debug({

package/dist/web/contract/serverContract.d.ts

@@ -2,7 +2,7 @@ import { DependencyConfig, RegistryConfig, ServerInstallOptions } from '../../co
 export interface OnboardServerConfig {
     name: string;
     description: string;
-    mode: 'stdio' | 'http';
+    mode: 'stdio' | 'sse';
     schemas?: string;
     dependencies?: DependencyConfig;
     repository?: string;
@@ -35,6 +35,8 @@ export interface OnboardRequestBody {
         mcpServers?: OnboardServerConfig[];
     };
     isUpdate: boolean;
+    forExistingCategory?: boolean;
+    serverName?: string;
 }
 export interface ListQueryParams {
     local?: string;

package/dist/web/public/css/notifications.css

@@ -2,53 +2,84 @@
 .alert-container {
     z-index: 999999; /* Extremely high to appear above modals */
     position: fixed;
-    top: 0 !important;
-    left: 0 !important;
-    right: 0 !important;
+    top: 20px; /* Adjusted for top-right positioning */
+    right: 20px; /* Adjusted for top-right positioning */
     display: flex;
     flex-direction: column;
-    align-items: center;
+    align-items: flex-end; /* Align items to the right */
     gap: 10px;
     pointer-events: none; /* Allow clicking through the container */
+    max-width: 350px; /* Max width for the container */
 }
 
 .alert {
-    min-width: 350px;
-    max-width: 500px;
-    box-shadow: 0 8px 24px rgba(0, 0, 0, 0.25);
+    min-width: 300px; /* Adjusted min-width */
+    max-width: 100%;   /* Alert can take full width of container */
+    box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15); /* Softer shadow */
     backdrop-filter: blur(8px);
-    border-width: 2px;
+    border-width: 1px; /* Thinner border */
+    border-radius: 8px; /* Rounded corners */
     pointer-events: auto; /* Re-enable pointer events for alerts */
-    padding: 0.75rem 1.5rem;
-    font-size: 1.1rem;
+    padding: 12px 20px; /* Adjusted padding */
+    font-size: 0.95rem; /* Slightly smaller font size */
     font-weight: 500;
-    margin-top: 10px;
+    display: flex; /* For icon and text alignment */
+    align-items: center; /* Vertically center icon and text */
+    opacity: 0; /* Start hidden for animation */
+    transform: translateX(100%); /* Start off-screen for slide-in */
+    transition: opacity 0.3s ease-out, transform 0.3s ease-out; /* Smooth animation */
+}
+
+.alert.show {
+    opacity: 1;
+    transform: translateX(0);
 }
 
 .alert:first-child {
     margin-top: 0;
 }
 
+.alert-icon {
+    margin-right: 10px; /* Space between icon and text */
+    font-size: 1.2rem; /* Icon size */
+}
+
 .alert.alert-success {
-    background-color: rgba(25, 135, 84, 0.98);
-    border-color: #146c43;
+    background-color: rgba(30, 136, 229, 0.9); /* Blue for success */
+    border-color: #1e88e5;
     color: white;
-    font-weight: 500;
 }
 
 .alert.alert-error {
-    background-color: rgba(220, 53, 69, 0.98);
-    border-color: #b02a37;
+    background-color: rgba(229, 57, 53, 0.9); /* Red for error */
+    border-color: #e53935;
     color: white;
-    font-weight: 500;
+}
+
+.alert.alert-info {
+    background-color: rgba(2, 136, 209, 0.9); /* Light blue for info */
+    border-color: #0288d1;
+    color: white;
+}
+
+.alert.alert-warning {
+    background-color: rgba(251, 192, 45, 0.9); /* Yellow for warning */
+    border-color: #fbc02d;
+    color: #333; /* Darker text for better contrast on yellow */
 }
 
 .alert .btn-close {
     filter: brightness(0) invert(1);
     opacity: 0.8;
     padding: 0.75rem;
+    margin-left: auto; /* Push close button to the right */
 }
 
+.alert.alert-warning .btn-close {
+    filter: none; /* No filter for warning close button for better visibility */
+}
+
+
 /* When modal is open, add backdrop to alerts */
 .modal.show ~ .alert-container .alert {
     box-shadow: 0 8px 32px rgba(0, 0, 0, 0.35);

package/dist/web/public/css/onboard.css

@@ -15,15 +15,15 @@
 .env-variables {
     background-color: #f9fafb;
     border-radius: 0.5rem;
-    padding: 1rem;
-    margin-top: 1rem;
+    padding: 0.75rem; /* Reduced padding */
+    margin-top: 0.75rem; /* Reduced margin-top */
 }
 
 .registry-github,
 .registry-artifacts {
     background-color: #ffffff;
     border-radius: 0.5rem;
-    padding: 1rem;
+    padding: 0.75rem; /* Reduced padding */
 }
 
 /* Order field styling */
@@ -41,4 +41,67 @@ input[type="number"][name$=".order"]:focus {
     border-color: #3b82f6;
     outline: none;
     box-shadow: 0 0 0 2px rgba(59, 130, 246, 0.2);
+}
+
+/* Collapsible sections */
+.collapsible-content {
+  overflow: hidden;
+  transition: max-height 0.3s ease-out, opacity 0.3s ease-out, padding 0.3s ease-out, margin 0.3s ease-out;
+  opacity: 1;
+  max-height: 1000px; /* Adjust as needed, should be larger than the content */
+}
+
+.collapsible-content.hidden {
+  max-height: 0;
+  opacity: 0;
+  padding-top: 0 !important; /* Use important to override potential inline styles or more specific selectors */
+  padding-bottom: 0 !important;
+  margin-top: 0 !important;
+  margin-bottom: 0 !important; /* Ensure bottom margin also collapses */
+  border-top-width: 0;
+  border-bottom-width: 0;
+  overflow: hidden; /* Ensure content is clipped during transition */
+}
+
+/* Styling for the clickable header of collapsible sections */
+.collapsible-header {
+  cursor: pointer;
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+}
+
+.collapsible-header i {
+  transition: transform 0.3s ease;
+}
+
+.collapsible-content.hidden + .collapsible-header i {
+  transform: rotate(-90deg);
+}
+
+/* Specific styling for scrollable server content */
+.server-content-scrollable {
+  /* This max-height is for when the section is *expanded*.
+     The .collapsible-content.hidden will still set max-height to 0 for collapse.
+     The general .collapsible-content max-height is a fallback for other sections.
+  */
+  max-height: 60vh; /* Reduced max-height for compactness */
+  overflow-y: auto; /* Add vertical scrollbar when content exceeds max-height */
+  padding-right: 0.5rem; /* Add a little padding so scrollbar doesn't overlap content too much */
+  /* Ensure it inherits or has its own transitions for smooth animation */
+  transition: max-height 0.3s ease-out, opacity 0.3s ease-out, padding 0.3s ease-out, margin 0.3s ease-out;
+  opacity: 1; /* Explicitly set opacity for visible state */
+}
+
+/* Ensure that when server-content-scrollable is hidden, its specific max-height is overridden */
+.server-content-scrollable.hidden {
+    max-height: 0 !important; /* Override the 60vh for hidden state */
+    opacity: 0 !important; /* Ensure opacity transition for hidden state */
+    overflow-y: hidden; /* Hide scrollbar when collapsed */
+    padding-top: 0 !important;
+    padding-bottom: 0 !important;
+    padding-left: 0 !important; /* Ensure all paddings are zeroed */
+    padding-right: 0 !important;
+    margin-top: 0 !important;
+    margin-bottom: 0 !important;
 }

package/dist/web/public/index.html

@@ -23,18 +23,42 @@
 
 <body class="bg-gray-50 min-h-screen">
     <div class="container mx-auto px-4 py-6">
-        <header class="mb-8">
-            <h1 class="text-3xl font-bold text-gray-900 flex items-center justify-center">
+        <div class="flex items-center justify-between mb-8">
+            <h1 class="text-3xl font-bold text-gray-900 flex items-center">
                 <i class='bx bx-server mr-3 text-blue-600'></i>
                 IMCP Server Manager
             </h1>
-        </header>
-
-        <div class="search-controls mb-6">
-            <div class="relative max-w-2xl mx-auto">
-                <input type="text" id="searchBox" placeholder="Search servers or tools..." class="search-input">
-                <i class='bx bx-search absolute left-3 top-1/2 transform -translate-y-1/2 text-gray-400'></i>
+            <div class="lg:w-2/3 flex justify-end items-center gap-4">
+                <div class="relative w-48 focus-within:w-96 transition-all duration-300 ease-in-out">
+                    <input type="text" id="searchBox"
+                        placeholder="Search..."
+                        data-expanded-placeholder="Search servers or tools..."
+                        class="w-full px-10 py-2.5 bg-gray-50 border border-gray-200 rounded-lg
+                                text-gray-700 placeholder-gray-400
+                                focus:border-blue-400 focus:ring-2 focus:ring-blue-100
+                                transition-all duration-300 ease-in-out">
+                    <i class='bx bx-search absolute left-3.5 top-1/2 transform -translate-y-1/2 text-gray-400'></i>
+                </div>
+                <button id="onboardButton" style="display: none;"
+                     class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 transition-colors flex items-center">
+                    <i class='bx bx-plus-circle mr-2'></i>
+                    Onboard
+                </button>
             </div>
+            <script>
+                document.addEventListener('DOMContentLoaded', () => {
+                    const searchBox = document.getElementById('searchBox');
+                    const expandedPlaceholder = searchBox.dataset.expandedPlaceholder;
+                    searchBox.addEventListener('focus', () => {
+                        setTimeout(() => searchBox.placeholder = expandedPlaceholder, 150);
+                    });
+                    searchBox.addEventListener('blur', () => {
+                        if (!searchBox.value) {
+                            searchBox.placeholder = 'Search...';
+                        }
+                    });
+                });
+            </script>
         </div>
 
         <div class="flex flex-col lg:flex-row gap-6">
@@ -147,10 +171,15 @@
         import { setupSearch } from './js/serverCategoryList.js';
         import { showServerDetails } from './js/serverCategoryDetails.js';
         import { showInstallModal, closeModal, setupModalOutsideClick } from './js/modal.js';
+        // import { showOnboardModal as navigateToOnboard } from './js/onboard/index.js'; // We are directly navigating
+        import flights, { getFlightQueryParameters, buildUrlWithFlights } from './js/flights/flights.js';
 
         // Make necessary functions available globally
         window.showServerDetails = showServerDetails;
         window.showInstallModal = showInstallModal;
+        // window.showOnboardModal = showOnboardModal; // This might conflict if showOnboardModal is also in onboard/index.js
+                                                    // We'll rely on the event listener above for the main page's onboard button.
+                                                    // If other parts of the app call window.showOnboardModal, they'll need updating too.
         window.closeModal = closeModal;
         window.handleInstallServer = handleInstallServer;
         window.installRequirement = installRequirement;
@@ -162,23 +191,62 @@
             setupSearch();
             setupModalOutsideClick();
 
+            const onboardButton = document.getElementById('onboardButton');
+            if (flights.enableOnboard) {
+                onboardButton.style.display = 'flex'; // Make it visible
+                onboardButton.addEventListener('click', () => {
+                    // The original showOnboardModal in onboard/index.js likely does window.location.href = 'onboard.html';
+                    // We need to preserve existing flight parameters.
+                    const flightQueryString = getFlightQueryParameters();
+                    // Assuming navigateToOnboard from onboard/index.js handles the actual navigation
+                    // If it directly sets window.location.href, we might need to adjust how it's called or modify it.
+                    // For now, let's assume we can adapt its usage or it's a simple navigation.
+                    // The simplest way if showOnboardModal in onboard/index.js is just `window.location.href = 'onboard.html'`
+                    // would be to directly navigate here.
+                    window.location.href = buildUrlWithFlights('onboard.html');
+                });
+            }
+            // No 'else' block needed as it's hidden by default via inline style
+
             try {
                 // First fetch categories and wait for completion
-                await fetchServerCategories();
+                // fetchServerCategories will call renderServerCategoryList, which might call loadLastSelectedCategory.
+                // loadLastSelectedCategory calls showServerDetails.
+                // The logic for setting initial category URL is now more centralized.
+
+                await fetchServerCategories(); // This populates allServerCategoriesData
 
-                // Check URL parameters for category
                 const urlParams = new URLSearchParams(window.location.search);
                 const categoryParam = urlParams.get('category');
+                const lastSelectedCategoryFromStorage = localStorage.getItem('lastSelectedCategory');
 
-                // If we have a category parameter or last selected category
-                const lastSelected = categoryParam || localStorage.getItem('lastSelectedCategory');
-
-                // Only show details after data is loaded
-                if (lastSelected) {
-                    await showServerDetails(lastSelected);
+                if (categoryParam) {
+                    // Category is in URL, load it
+                    await window.showServerDetails(categoryParam);
+                } else if (lastSelectedCategoryFromStorage) {
+                    // Category not in URL, but in localStorage. Redirect to URL with this category and flights.
+                    window.location.href = buildUrlWithFlights('index.html', { category: lastSelectedCategoryFromStorage });
+                    return; // Stop further execution, page will reload
+                } else if (allServerCategoriesData && allServerCategoriesData.length > 0) {
+                    // No category in URL or localStorage, pick first from list and redirect.
+                    window.location.href = buildUrlWithFlights('index.html', { category: allServerCategoriesData[0].name });
+                    return; // Stop further execution, page will reload
+                } else {
+                    // No categories at all, or data still loading. Default placeholder will be shown.
+                    // Or, if allServerCategoriesData is empty after fetch, the placeholder from HTML remains.
                 }
+
             } catch (error) {
                 console.error('Error during initialization:', error);
+                // Potentially show a user-friendly error message in the UI
+                const serverCategoryDetailsDiv = document.getElementById('serverCategoryDetails');
+                if (serverCategoryDetailsDiv) {
+                    serverCategoryDetailsDiv.innerHTML = `<p class="text-red-500">Error initializing page: ${error.message}</p>`;
+                }
+                const serverCategoryListDiv = document.getElementById('serverCategoryList');
+                if (serverCategoryListDiv) {
+                    serverCategoryListDiv.innerHTML = `<p class="text-red-500">Could not load categories.</p>`;
+                }
             }
         });
     </script>

package/dist/web/public/js/api.js

@@ -3,6 +3,8 @@ import { showToast } from './notifications.js';
 
 // Global store for server data
 let allServerCategoriesData = [];
+// Make it available globally for legacy code
+window.allServerCategoriesData = allServerCategoriesData;
 
 // Fetch and display servers
 async function fetchServerCategories() {
@@ -14,16 +16,11 @@ async function fetchServerCategories() {
         if (!responseData.success || !responseData.data) {
             throw new Error(`API Error fetching servers: ${responseData.error || 'Invalid data format'}`);
         }
-        allServerCategoriesData = responseData.data; // Store globally
+        allServerCategoriesData = window.allServerCategoriesData = responseData.data; // Update both local and global references
 
         // Use the renderServerCategoryList function to display servers
         renderServerCategoryList(allServerCategoriesData);
 
-        // Show the first category by default if there are categories
-        if (allServerCategoriesData.length > 0) {
-            window.showServerDetails(allServerCategoriesData[0].name);
-        }
-
         // Check if search is active
         const searchTerm = document.getElementById('searchBox').value.toLowerCase();
         if (searchTerm) {

package/dist/web/public/js/flights/flights.js

@@ -0,0 +1,127 @@
+// Centralized flight control configuration
+
+const FLIGHT_STORAGE_KEY = 'activeFlightSettings';
+
+// Default flight settings
+const defaultFlights = {
+    enableOnboard: false, // Default: Onboarding is enabled. Set to false to disable.
+    // Add other default flights here, e.g., newFeatureX: false,
+};
+
+let effectiveFlightSettings = {};
+
+// Initialize flight settings
+function initializeFlightSettings() {
+    const urlParams = new URLSearchParams(window.location.search);
+    let settingsToStore = {};
+    let sourcedFromUrl = false;
+
+    // Check URL parameters first
+    for (const key in defaultFlights) {
+        if (urlParams.has(key)) {
+            const paramValue = urlParams.get(key);
+            settingsToStore[key] = (paramValue === 'true') ? true : (paramValue === 'false' ? false : paramValue);
+            sourcedFromUrl = true;
+        }
+    }
+
+    if (sourcedFromUrl) {
+        // If any flight was set via URL, these override sessionStorage for this load
+        // and then update sessionStorage.
+        // Fill any missing flights with defaults before storing.
+        for (const key in defaultFlights) {
+            if (!Object.hasOwnProperty.call(settingsToStore, key)) {
+                settingsToStore[key] = defaultFlights[key];
+            }
+        }
+        try {
+            sessionStorage.setItem(FLIGHT_STORAGE_KEY, JSON.stringify(settingsToStore));
+            effectiveFlightSettings = settingsToStore;
+        } catch (e) {
+            console.error("Failed to write to sessionStorage:", e);
+            effectiveFlightSettings = settingsToStore; // Use them anyway for this page load
+        }
+    } else {
+        // No flight params in URL, try sessionStorage
+        try {
+            const storedSettings = sessionStorage.getItem(FLIGHT_STORAGE_KEY);
+            if (storedSettings) {
+                effectiveFlightSettings = JSON.parse(storedSettings);
+                // Ensure all default keys are present, add if missing (e.g., new flight added)
+                for (const key in defaultFlights) {
+                    if (!Object.hasOwnProperty.call(effectiveFlightSettings, key)) {
+                        effectiveFlightSettings[key] = defaultFlights[key];
+                    }
+                }
+            } else {
+                // Not in sessionStorage, use defaults and store them
+                effectiveFlightSettings = { ...defaultFlights };
+                sessionStorage.setItem(FLIGHT_STORAGE_KEY, JSON.stringify(effectiveFlightSettings));
+            }
+        } catch (e) {
+            console.error("Failed to read/write sessionStorage:", e);
+            effectiveFlightSettings = { ...defaultFlights }; // Fallback to defaults
+        }
+    }
+}
+
+initializeFlightSettings();
+
+// The `flights` object provides these effective values.
+const flights = {};
+for (const key in defaultFlights) { // Iterate defaultFlights to define getters for all known flights
+    if (Object.hasOwnProperty.call(defaultFlights, key)) {
+        Object.defineProperty(flights, key, {
+            get: () => effectiveFlightSettings[key] !== undefined ? effectiveFlightSettings[key] : defaultFlights[key],
+            enumerable: true,
+            configurable: false
+        });
+    }
+}
+
+/**
+ * Helper to build a URLSearchParams object with the effective flight values.
+ * @returns {URLSearchParams}
+ */
+function _buildFlightParams() {
+    const flightParams = new URLSearchParams();
+    for (const flightName in effectiveFlightSettings) {
+        if (Object.hasOwnProperty.call(effectiveFlightSettings, flightName)) {
+            // Only add if it's a recognized flight from defaultFlights to avoid polluting URL
+            // with unrelated sessionStorage items if FLIGHT_STORAGE_KEY was somehow corrupted.
+            if (Object.hasOwnProperty.call(defaultFlights, flightName)) {
+                flightParams.set(flightName, String(effectiveFlightSettings[flightName]));
+            }
+        }
+    }
+    return flightParams;
+}
+
+/**
+ * Constructs a URL with the effective flight parameters and any additional parameters.
+ * @param {string} baseUrl The base URL (e.g., "index.html").
+ * @param {object} [additionalParams={}] - An object of additional key-value pairs to include.
+ * @returns {string} A full URL with query string.
+ */
+export function buildUrlWithFlights(baseUrl, additionalParams = {}) {
+    const params = _buildFlightParams(); // Start with all effective flight values
+
+    for (const key in additionalParams) {
+        if (Object.hasOwnProperty.call(additionalParams, key) && additionalParams[key] !== undefined) {
+            params.set(key, additionalParams[key]);
+        }
+    }
+    const queryString = params.toString();
+    return `${baseUrl}${queryString ? `?${queryString}` : ''}`;
+}
+
+/**
+ * Gets a query string containing only the effective flight parameters.
+ * @returns {string} A query string like "?enableOnboard=true" or empty.
+ */
+export function getFlightQueryParameters() {
+    const queryString = _buildFlightParams().toString();
+    return queryString ? `?${queryString}` : '';
+}
+
+export default flights;

package/dist/web/public/js/modal/installation.js

@@ -129,11 +129,11 @@ async function pollInstallStatus(categoryName, serverName, targets, interval = 2
                 for (const req of requirements) {
                     const reqStatus = requirementsStatus[req.name] || {};
                     if (reqStatus.installed === true && !reqStatus.operationStatus) {
-                        const msg = `Requirement [${req.name}] already installed.`;
-                        if (msg && lastRequirementMessages[req.name] !== msg) {
-                            delayedAppendInstallLoadingMessage(msg);
-                            lastRequirementMessages[req.name] = msg;
-                        }
+                        // const msg = `Requirement [${req.name}] already installed.`;
+                        // if (msg && lastRequirementMessages[req.name] !== msg) {
+                        //     delayedAppendInstallLoadingMessage(msg);
+                        //     lastRequirementMessages[req.name] = msg;
+                        // }
                         continue;
                     }
                     const opStatus = reqStatus.operationStatus || {};