feat(api): MCP, OpenAPI & Dynamic Introspection

New Features:
- API endpoints now support comprehensive input validation with detailed error responses via Pydantic models.
- OpenAPI specification endpoint (/openapi.json) and interactive Swagger UI documentation (/docs) now available for API discovery.
- Enhanced MCP session lifecycle management with create, retrieve, and delete operations.
- Network diagnostic tools: traceroute, nslookup, NMAP scanning, and network topology viewing exposed via API.
- Device search, filtering by status (including 'offline'), and bulk operations (copy, delete, update).
- Wake-on-LAN functionality for remote device management.
- Added dynamic tool disablement and status reporting.

Bug Fixes:
- Fixed get_tools_status in registry to correctly return boolean values instead of None for enabled tools.
- Improved error handling for invalid API inputs with standardized validation responses.
- Fixed OPTIONS request handling for cross-origin requests.

Refactoring:
- Significant refactoring of api_server_start.py to use decorator-based validation (@validate_request).

test/api_endpoints/test_devices_endpoints.py

@@ -1,18 +1,13 @@
-import sys
 # import pathlib
 # import sqlite3
 import base64
 import random
 # import string
 # import uuid
-import os
 import pytest
 
-INSTALL_PATH = os.getenv('NETALERTX_APP', '/app')
-sys.path.extend([f"{INSTALL_PATH}/front/plugins", f"{INSTALL_PATH}/server"])
-
-from helper import get_setting_value  # noqa: E402 [flake8 lint suppression]
-from api_server.api_server_start import app  # noqa: E402 [flake8 lint suppression]
+from helper import get_setting_value
+from api_server.api_server_start import app
 
 
 @pytest.fixture(scope="session")
@@ -182,9 +177,8 @@ def test_devices_by_status(client, api_token, test_mac):
 
     # 3. Request devices with an invalid/unknown status
     resp_invalid = client.get("/devices/by-status?status=invalid_status", headers=auth_headers(api_token))
-    assert resp_invalid.status_code == 200
-    # Should return empty list for unknown status
-    assert resp_invalid.json == []
+    # Strict validation now returns 422 for invalid status enum values
+    assert resp_invalid.status_code == 422
 
     # 4. Check favorite formatting if devFavorite = 1
     # Update dummy device to favorite