feat: Implement session management and SSE handling

- Add SessionManager class for managing user sessions with features like session creation, cleanup, and activity tracking.
- Introduce SSEHandler class to establish Server-Sent Events (SSE) connections and manage communication with clients.
- Update index.ts to register new MCP command.
- Modify config types to accommodate new MCP server configurations.
- Enhance MCP types with installation management and server configuration details.
- Create StateComparator utility for comparing expected server states with actual running processes.
- Implement ToolDiscoveryManager for discovering tools from MCP servers, including error handling and caching mechanisms.

Author: Lasim

package-lock.json

@@ -16771,20 +16771,52 @@
                                     }
                                   ]
                                 },
+                                "homepage_url": {
+                                  "anyOf": [
+                                    {
+                                      "type": "string"
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ]
+                                },
+                                "author_name": {
+                                  "anyOf": [
+                                    {
+                                      "type": "string"
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ]
+                                },
+                                "language": {
+                                  "type": "string"
+                                },
                                 "runtime": {
                                   "type": "string"
                                 },
-                                "installation_methods": {
+                                "status": {
+                                  "type": "string"
+                                },
+                                "tags": {
                                   "type": "array",
                                   "items": {}
                                 },
                                 "environment_variables": {
                                   "type": "array",
                                   "items": {}
                                 },
-                                "default_config": {
+                                "installation_methods": {
+                                  "type": "array",
+                                  "items": {}
+                                },
+                                "category_id": {
                                   "anyOf": [
-                                    {},
+                                    {
+                                      "type": "string"
+                                    },
                                     {
                                       "type": "null"
                                     }
@@ -16796,10 +16828,15 @@
                                 "name",
                                 "description",
                                 "github_url",
+                                "homepage_url",
+                                "author_name",
+                                "language",
                                 "runtime",
-                                "installation_methods",
+                                "status",
+                                "tags",
                                 "environment_variables",
-                                "default_config"
+                                "installation_methods",
+                                "category_id"
                               ],
                               "additionalProperties": false
                             }

services/backend/api-spec.json

@@ -11315,27 +11315,47 @@ paths:
                                 anyOf:
                                   - type: string
                                   - type: "null"
+                              homepage_url:
+                                anyOf:
+                                  - type: string
+                                  - type: "null"
+                              author_name:
+                                anyOf:
+                                  - type: string
+                                  - type: "null"
+                              language:
+                                type: string
                               runtime:
                                 type: string
-                              installation_methods:
+                              status:
+                                type: string
+                              tags:
                                 type: array
                                 items: {}
                               environment_variables:
                                 type: array
                                 items: {}
-                              default_config:
+                              installation_methods:
+                                type: array
+                                items: {}
+                              category_id:
                                 anyOf:
-                                  - {}
+                                  - type: string
                                   - type: "null"
                             required:
                               - id
                               - name
                               - description
                               - github_url
+                              - homepage_url
+                              - author_name
+                              - language
                               - runtime
-                              - installation_methods
+                              - status
+                              - tags
                               - environment_variables
-                              - default_config
+                              - installation_methods
+                              - category_id
                             additionalProperties: false
                         required:
                           - id

services/backend/api-spec.yaml

@@ -23,10 +23,15 @@ const installationSchema = z.object({
     name: z.string(),
     description: z.string(),
     github_url: z.string().nullable(),
+    homepage_url: z.string().nullable(),
+    author_name: z.string().nullable(),
+    language: z.string(),
     runtime: z.string(),
-    installation_methods: z.array(z.any()),
+    status: z.string(),
+    tags: z.array(z.any()),
     environment_variables: z.array(z.any()),
-    default_config: z.any().nullable()
+    installation_methods: z.array(z.any()),
+    category_id: z.string().nullable()
   }).optional()
 });
 

services/backend/src/routes/mcp/installations/list.ts

@@ -95,6 +95,7 @@ export class McpInstallationService {
         status: row.server.status,
         tags: this.parseJsonField(row.server.tags, []),
         environment_variables: this.parseJsonField(row.server.environment_variables, []),
+        installation_methods: this.parseJsonField(row.server.installation_methods, []),
         category_id: row.server.category_id
       } : undefined
     }));

services/backend/src/services/mcpInstallationService.ts

@@ -163,7 +163,7 @@ describe('Teams Route', () => {
           schema: expect.objectContaining({
             tags: ['Teams'],
             summary: 'Get current user teams',
-            security: [{ cookieAuth: [] }],
+            security: [{ cookieAuth: [] }, { bearerAuth: [] }],
           }),
         }),
         expect.any(Function)
@@ -1100,7 +1100,7 @@ describe('Teams Route', () => {
       expect(options.schema).toBeDefined();
       expect(options.schema.tags).toEqual(['Teams']);
       expect(options.schema.summary).toBe('Get current user teams');
-      expect(options.schema.security).toEqual([{ cookieAuth: [] }]);
+      expect(options.schema.security).toEqual([{ cookieAuth: [] }, { bearerAuth: [] }]);
       expect(options.schema.response).toBeDefined();
       expect(options.schema.response[200]).toBeDefined();
       expect(options.schema.response[401]).toBeDefined();

services/backend/tests/unit/routes/teams.test.ts

@@ -1,5 +1,22 @@
 # Changelog
 
+## <small>0.21.1 (2025-07-27)</small>
+
+* remove scoped commit implementation documentation ([8311fc8](https://github.com/deploystackio/deploystack/commit/8311fc89c5c7c6ca4944c0f7040275e00d5170b9))
+* release v0.21.0 ([0a01e3c](https://github.com/deploystackio/deploystack/commit/0a01e3c2e90ba7cc415211bb0f76ba4e0bd11087))
+* update README links for better formatting ([ba15434](https://github.com/deploystackio/deploystack/commit/ba15434bd65f371d9ad39576a56a923a9040f74e))
+* implement scoped commit message guidelines and templates ([a6839b8](https://github.com/deploystackio/deploystack/commit/a6839b880248a35a213cfb44f19ec29c0b9553cc))
+* update README with new links and SVG assets ([704799c](https://github.com/deploystackio/deploystack/commit/704799c34ef1d67824b5a1911d14ae148b0f4b15))
+* implement OAuth consent page and service integration ([1df0813](https://github.com/deploystackio/deploystack/commit/1df0813afb893d33690a02cf395f100edbe839cb))
+
+## 0.21.0 (2025-07-27)
+
+* update README links for better formatting ([ba15434](https://github.com/deploystackio/deploystack/commit/ba15434bd65f371d9ad39576a56a923a9040f74e))
+* implement scoped commit message guidelines and templates ([a6839b8](https://github.com/deploystackio/deploystack/commit/a6839b880248a35a213cfb44f19ec29c0b9553cc))
+* update README with new links and SVG assets ([704799c](https://github.com/deploystackio/deploystack/commit/704799c34ef1d67824b5a1911d14ae148b0f4b15))
+* implement OAuth consent page and service integration ([1df0813](https://github.com/deploystackio/deploystack/commit/1df0813afb893d33690a02cf395f100edbe839cb))
+* remove scoped commit implementation documentation ([8311fc8](https://github.com/deploystackio/deploystack/commit/8311fc89c5c7c6ca4944c0f7040275e00d5170b9))
+
 ## <small>0.20.1 (2025-07-26)</small>
 
 * bump @libsql/client from 0.15.9 to 0.15.10 ([908efef](https://github.com/deploystackio/deploystack/commit/908efefe920ad03cd859e17c9df9a2e52493e99b))

services/frontend/CHANGELOG.md

@@ -1,6 +1,6 @@
 {
   "name": "@deploystack/frontend",
-  "version": "0.20.1",
+  "version": "0.21.1",
   "private": true,
   "type": "module",
   "scripts": {

services/frontend/package.json

@@ -2,6 +2,7 @@
 import { ref } from 'vue'
 import { useI18n } from 'vue-i18n'
 import { useRouter } from 'vue-router'
+import { toast } from 'vue-sonner'
 import { Button } from '@/components/ui/button'
 import {
   AlertDialog,
@@ -80,21 +81,25 @@ async function handleUninstall() {
     // Close modal
     showUninstallModal.value = false
 
-    // Store success notification for persistence across navigation
-    const message = t('mcpInstallations.notifications.uninstallSuccess')
-
-    // Use event bus storage to persist notification across navigation
-    eventBus.setState('pending_notification', {
-      message,
-      type: 'success',
-      timestamp: Date.now()
+    // Show success toast
+    toast.success(t('mcpInstallations.notifications.uninstallSuccess'), {
+      description: t('mcpInstallations.removal.notifications.success')
     })
 
+    // Emit event for other components to update
+    eventBus.emit('mcp-installations-updated')
+
     // Navigate back to MCP servers list
     router.push('/mcp-server')
 
   } catch (err) {
-    error.value = err instanceof Error ? err.message : 'Unknown error occurred'
+    const errorMessage = err instanceof Error ? err.message : 'Unknown error occurred'
+    error.value = errorMessage
+    
+    // Show error toast
+    toast.error(t('mcpInstallations.removal.notifications.genericError', { error: errorMessage }), {
+      description: t('mcpInstallations.details.dangerZone.uninstall.modal.warning')
+    })
   } finally {
     isUninstalling.value = false
   }

services/frontend/src/components/mcp-server/installation/DangerZone.vue

@@ -5,7 +5,7 @@ import { useI18n } from 'vue-i18n'
 import { useRoute } from 'vue-router'
 import { Button } from '@/components/ui/button'
 import { ProgressBars } from '@/components/ui/progress-bars'
-import { Alert, AlertDescription } from '@/components/ui/alert'
+import { toast } from 'vue-sonner'
 import { Server, Settings, Cloud, Loader2 } from 'lucide-vue-next'
 import { McpInstallationService } from '@/services/mcpInstallationService'
 import { TeamService } from '@/services/teamService'
@@ -108,7 +108,7 @@ const handleStepClick = (step: any, index: number) => {
 // State
 const currentStep = ref(0)
 const isSubmitting = ref(false)
-const submitError = ref<string | null>(null)
+
 const environmentValidation = ref({
   isValid: true,
   missingFields: [] as string[]
@@ -166,6 +166,17 @@ const nextStep = () => {
   // Mark environment step as touched when user tries to proceed from it
   if (currentStep.value === 1) {
     environmentStepTouched.value = true
+    
+    // Check validation before proceeding
+    if (!environmentValidation.value.isValid) {
+      // Show error toast for missing required fields
+      if (environmentValidation.value.missingFields.length > 0) {
+        toast.error(t('mcpInstallations.wizard.environment.missingRequiredFields'), {
+          description: environmentValidation.value.missingFields.join(', ')
+        })
+      }
+      return
+    }
   }
 
   if (canGoNext.value) {
@@ -223,15 +234,16 @@ const initializeTeamContext = async () => {
     }
   } catch (error) {
     console.error('Error initializing team context:', error)
-    submitError.value = 'Failed to initialize team context. Please refresh the page.'
+    toast.error('Failed to initialize team context', {
+      description: 'Please refresh the page and try again.'
+    })
   }
 }
 
 // Form submission
 const submitInstallation = async () => {
   try {
     isSubmitting.value = true
-    submitError.value = null
 
     // Ensure we have a team ID
     if (!currentTeamId.value) {
@@ -259,7 +271,10 @@ const submitInstallation = async () => {
     }
 
   } catch (error) {
-    submitError.value = error instanceof Error ? error.message : 'Failed to submit installation'
+    const errorMessage = error instanceof Error ? error.message : 'Failed to submit installation'
+    toast.error(t('mcpInstallations.notifications.installError', { error: errorMessage }), {
+      description: t('mcpInstallations.wizard.environment.helpText')
+    })
   } finally {
     isSubmitting.value = false
   }
@@ -326,7 +341,9 @@ const handleQueryParameters = async () => {
       }
     } catch (error) {
       console.error('Error loading server from query parameters:', error)
-      submitError.value = 'Failed to load the selected server. Please try again.'
+      toast.error(t('mcpInstallations.wizard.server.errorTitle'), {
+        description: 'Failed to load the specified server. Please try again.'
+      })
     }
   }
 }
@@ -346,7 +363,7 @@ onMounted(async () => {
       environment: { user_environment_variables: {} },
       platform: { installation_type: 'local' }
     }
-    submitError.value = null
+
   })
 })
 </script>
@@ -363,19 +380,7 @@ onMounted(async () => {
       @step-click="handleStepClick"
     />
 
-    <!-- Error Message -->
-    <Alert v-if="submitError" variant="destructive">
-      <AlertDescription>
-        {{ submitError }}
-      </AlertDescription>
-    </Alert>
-
-    <!-- Validation Error for Environment Variables (only show after user tries to proceed) -->
-    <Alert v-if="currentStep === 1 && environmentStepTouched && !environmentValidation.isValid && environmentValidation.missingFields.length > 0" variant="destructive">
-      <AlertDescription>
-        {{ t('mcpInstallations.wizard.environment.missingRequiredFields') }}: {{ environmentValidation.missingFields.join(', ') }}
-      </AlertDescription>
-    </Alert>
+
 
     <!-- Step Content -->
     <div>