mcp-mesh 0.7.20__py3-none-any.whl → 0.8.0__py3-none-any.whl

_mcp_mesh/pipeline/api_heartbeat/api_dependency_resolution.py

@@ -1,418 +0,0 @@
-"""
-API dependency resolution step for API heartbeat pipeline.
-
-Handles processing dependency resolution from registry response and
-updating the dependency injection system for FastAPI route handlers.
-"""
-
-import json
-import logging
-from typing import Any
-
-from ...engine.dependency_injector import get_global_injector
-from ..shared import PipelineResult, PipelineStatus, PipelineStep
-
-logger = logging.getLogger(__name__)
-
-# Global state for dependency hash tracking across heartbeat cycles
-_last_api_dependency_hash = None
-
-
-class APIDependencyResolutionStep(PipelineStep):
-    """
-    Processes dependency resolution from registry response for API services.
-
-    Takes the dependencies_resolved data from the heartbeat response
-    and updates dependency injection for FastAPI route handlers.
-
-    Similar to MCP dependency resolution but adapted for:
-    - FastAPI route handlers instead of MCP tools
-    - Single "api_endpoint_handler" function instead of multiple tools
-    - Route-level dependency mapping instead of tool-level mapping
-    """
-
-    def __init__(self):
-        super().__init__(
-            name="api-dependency-resolution",
-            required=False,  # Optional - can work without dependencies
-            description="Process dependency resolution for API route handlers",
-        )
-
-    async def execute(self, context: dict[str, Any]) -> PipelineResult:
-        """Process dependency resolution with hash-based change detection."""
-        self.logger.debug("Processing API dependency resolution...")
-
-        result = PipelineResult(message="API dependency resolution processed")
-
-        try:
-            # Get heartbeat response and registry wrapper
-            heartbeat_response = context.get("heartbeat_response", {})
-            registry_wrapper = context.get("registry_wrapper")
-
-            if not heartbeat_response or not registry_wrapper:
-                result.status = PipelineStatus.SUCCESS
-                result.message = (
-                    "No heartbeat response or registry wrapper - completed successfully"
-                )
-                self.logger.debug(
-                    "No heartbeat response to process - this is normal for API services"
-                )
-                return result
-
-            # Use the same hash-based change detection pattern as MCP
-            await self.process_heartbeat_response_for_api_rewiring(heartbeat_response)
-
-            # For context consistency, extract dependency count
-            dependencies_resolved = registry_wrapper.parse_tool_dependencies(
-                heartbeat_response
-            )
-            dependency_count = sum(
-                len(deps) if isinstance(deps, list) else 0
-                for deps in dependencies_resolved.values()
-            )
-
-            # Store processed dependencies info for context
-            result.add_context("dependency_count", dependency_count)
-            result.add_context("dependencies_resolved", dependencies_resolved)
-
-            result.message = (
-                "API dependency resolution completed (efficient hash-based)"
-            )
-
-            if dependency_count > 0:
-                self.logger.info(f"🔗 Dependencies resolved: {dependency_count} items")
-
-            # Log function registry status for debugging
-            injector = get_global_injector()
-            function_count = len(injector._function_registry)
-            self.logger.debug(f"Function registry contains {function_count} functions")
-
-        except Exception as e:
-            result.status = PipelineStatus.FAILED
-            result.message = f"API dependency resolution failed: {e}"
-            result.add_error(str(e))
-            self.logger.error(f"❌ API dependency resolution failed: {e}")
-
-        return result
-
-    def _extract_dependency_state(
-        self, heartbeat_response: dict[str, Any]
-    ) -> dict[str, list[dict[str, Any]]]:
-        """Extract dependency state structure from heartbeat response.
-
-        Preserves array structure and order from registry to support multiple
-        dependencies with the same capability name (e.g., different versions/tags).
-
-        For API services, dependencies are typically under a single function
-        (usually "api_endpoint_handler") but we still follow the same pattern.
-
-        Returns:
-            {function_name: [{capability, endpoint, function_name, status, agent_id, kwargs}, ...]}
-        """
-        state = {}
-        dependencies_resolved = heartbeat_response.get("dependencies_resolved", {})
-
-        for function_name, dependency_list in dependencies_resolved.items():
-            if not isinstance(dependency_list, list):
-                continue
-
-            state[function_name] = []
-            for dep_resolution in dependency_list:
-                if (
-                    not isinstance(dep_resolution, dict)
-                    or "capability" not in dep_resolution
-                ):
-                    continue
-
-                # Preserve array structure to maintain order and support duplicate capabilities
-                state[function_name].append(
-                    {
-                        "capability": dep_resolution["capability"],
-                        "endpoint": dep_resolution.get("endpoint", ""),
-                        "function_name": dep_resolution.get("function_name", ""),
-                        "status": dep_resolution.get("status", ""),
-                        "agent_id": dep_resolution.get("agent_id", ""),
-                        "kwargs": dep_resolution.get("kwargs", {}),
-                    }
-                )
-
-        return state
-
-    def _hash_dependency_state(self, state: dict) -> str:
-        """Create hash of dependency state structure."""
-        import hashlib
-
-        # Convert to sorted JSON string for consistent hashing
-        state_json = json.dumps(state, sort_keys=True)
-        return hashlib.sha256(state_json.encode()).hexdigest()[
-            :16
-        ]  # First 16 chars for readability
-
-    async def process_heartbeat_response_for_api_rewiring(
-        self, heartbeat_response: dict[str, Any]
-    ) -> None:
-        """Process heartbeat response to update API route dependency injection.
-
-        Uses hash-based comparison to efficiently detect when ANY dependency changes
-        and then updates ALL affected route handlers in one operation.
-
-        Resilience logic (same as MCP):
-        - No response (connection error, 5xx) → Skip entirely (keep existing wiring)
-        - 2xx response with empty dependencies → Unwire all dependencies
-        - 2xx response with partial dependencies → Update to match registry exactly
-        """
-        try:
-            if not heartbeat_response:
-                # No response from registry (connection error, timeout, 5xx)
-                # → Skip entirely for resilience (keep existing dependencies)
-                self.logger.debug(
-                    "No heartbeat response - skipping API rewiring for resilience"
-                )
-                return
-
-            # Extract current dependency state structure
-            current_state = self._extract_dependency_state(heartbeat_response)
-
-            # IMPORTANT: Empty state from successful response means "unwire everything"
-            # This is different from "no response" which means "keep existing for resilience"
-
-            # Hash the current state (including empty state)
-            current_hash = self._hash_dependency_state(current_state)
-
-            # Compare with previous state (use global variable with API-specific name)
-            global _last_api_dependency_hash
-            if current_hash == _last_api_dependency_hash:
-                self.logger.debug(
-                    f"🔄 API dependency state unchanged (hash: {current_hash}), skipping rewiring"
-                )
-                return
-
-            # State changed - determine what changed
-            function_count = len(current_state)
-            total_deps = sum(len(deps) for deps in current_state.values())
-
-            if _last_api_dependency_hash is None:
-                if function_count > 0:
-                    self.logger.debug(
-                        f"Initial API dependency state detected: {function_count} functions, {total_deps} dependencies"
-                    )
-                else:
-                    self.logger.debug(
-                        "Initial API dependency state detected: no dependencies"
-                    )
-            else:
-                self.logger.debug(
-                    f"API dependency state changed (hash: {_last_api_dependency_hash} → {current_hash})"
-                )
-                if function_count > 0:
-                    self.logger.debug(
-                        f"Updating API dependencies for {function_count} functions ({total_deps} total dependencies)"
-                    )
-                else:
-                    self.logger.debug(
-                        "Registry reports no API dependencies - unwiring all existing dependencies"
-                    )
-
-            # Import here to avoid circular imports
-            from ...engine.dependency_injector import get_global_injector
-
-            injector = get_global_injector()
-
-            # Step 1: Collect all dependency keys (func_id:dep_index) that should exist
-            # Map tool names to func_ids first
-            from ...engine.decorator_registry import DecoratorRegistry
-
-            tool_name_to_func_id = {}
-            mesh_tools = DecoratorRegistry.get_mesh_tools()
-            for tool_name, decorated_func in mesh_tools.items():
-                func = decorated_func.function
-                func_id = f"{func.__module__}.{func.__qualname__}"
-                tool_name_to_func_id[tool_name] = func_id
-
-            target_dependency_keys = set()
-            for function_name, dependency_list in current_state.items():
-                # Map tool name to func_id
-                func_id = tool_name_to_func_id.get(function_name, function_name)
-                for dep_index in range(len(dependency_list)):
-                    dep_key = f"{func_id}:dep_{dep_index}"
-                    target_dependency_keys.add(dep_key)
-
-            # Step 2: Find existing dependency keys that need to be removed (unwired)
-            # This handles the case where registry stops reporting some dependencies
-            existing_dependency_keys = (
-                set(injector._dependencies.keys())
-                if hasattr(injector, "_dependencies")
-                else set()
-            )
-            keys_to_remove = existing_dependency_keys - target_dependency_keys
-
-            unwired_count = 0
-            for dep_key in keys_to_remove:
-                await injector.unregister_dependency(dep_key)
-                unwired_count += 1
-                self.logger.debug(
-                    f"Unwired API dependency '{dep_key}' (no longer reported by registry)"
-                )
-
-            # Step 3: Apply all dependency updates using positional indexing
-            updated_count = 0
-            for function_name, dependency_list in current_state.items():
-                # Check if function_name is a route path (METHOD:path format)
-                # Route paths contain "/" and look like "GET:/api/v1/benchmark-services"
-                is_route_path = "/" in function_name
-
-                # Map tool name to func_id (using mapping from Step 1)
-                # For route paths, use the route_id directly as it won't be in tool_name_to_func_id
-                func_id = tool_name_to_func_id.get(function_name, function_name)
-
-                # Get route wrapper if this is a route path
-                route_wrapper_info = None
-                if is_route_path:
-                    route_wrapper_info = DecoratorRegistry.get_route_wrapper(
-                        function_name
-                    )
-                    if not route_wrapper_info:
-                        self.logger.warning(
-                            f"No route wrapper found for '{function_name}' - dependency injection may fail"
-                        )
-
-                for dep_index, dep_info in enumerate(dependency_list):
-                    status = dep_info["status"]
-                    endpoint = dep_info["endpoint"]
-                    dep_function_name = dep_info["function_name"]
-                    capability = dep_info["capability"]
-                    kwargs_config = dep_info.get("kwargs", {})
-
-                    if status == "available" and endpoint and dep_function_name:
-                        # Import here to avoid circular imports
-                        import os
-
-                        from ...engine.self_dependency_proxy import SelfDependencyProxy
-                        from ...engine.unified_mcp_proxy import EnhancedUnifiedMCPProxy
-
-                        # Get current agent ID for self-dependency detection
-                        current_agent_id = None
-                        try:
-                            from ...engine.decorator_registry import DecoratorRegistry
-
-                            config = DecoratorRegistry.get_resolved_agent_config()
-                            current_agent_id = config["agent_id"]
-                        except Exception:
-                            # For API services, try environment variable fallback
-                            current_agent_id = os.getenv("MCP_MESH_AGENT_ID")
-
-                        target_agent_id = dep_info.get("agent_id")
-
-                        # Determine if this is a self-dependency (less common for API services)
-                        is_self_dependency = (
-                            current_agent_id
-                            and target_agent_id
-                            and current_agent_id == target_agent_id
-                        )
-
-                        if is_self_dependency:
-                            # Create self-dependency proxy with WRAPPER function (not original)
-                            # The wrapper has dependency injection logic, so calling it ensures
-                            # the target function's dependencies are also injected properly.
-                            wrapper_func = None
-                            if dep_function_name in mesh_tools:
-                                wrapper_func = mesh_tools[dep_function_name].function
-
-                            if wrapper_func:
-                                new_proxy = SelfDependencyProxy(
-                                    wrapper_func, dep_function_name
-                                )
-                                self.logger.debug(
-                                    f"API SELF-DEPENDENCY: Using wrapper for '{capability}' "
-                                    f"(local call with full DI support)"
-                                )
-                            else:
-                                # Fallback to original function if wrapper not found
-                                original_func = injector.find_original_function(
-                                    dep_function_name
-                                )
-                                if original_func:
-                                    new_proxy = SelfDependencyProxy(
-                                        original_func, dep_function_name
-                                    )
-                                    self.logger.warning(
-                                        f"⚠️ API SELF-DEPENDENCY: Using original function for '{capability}' "
-                                        f"(wrapper not found, DI may not work for nested deps)"
-                                    )
-                                else:
-                                    self.logger.warning(
-                                        f"⚠️ API SELF-DEPENDENCY: Cannot create SelfDependencyProxy for '{capability}', "
-                                        f"falling back to HTTP (may cause issues)"
-                                    )
-                                    # Fall back to unified proxy (same as cross-service)
-                                    new_proxy = EnhancedUnifiedMCPProxy(
-                                        endpoint,
-                                        dep_function_name,
-                                        kwargs_config=kwargs_config,
-                                    )
-                        else:
-                            # Create cross-service proxy using unified proxy (same as MCP pipeline)
-                            new_proxy = EnhancedUnifiedMCPProxy(
-                                endpoint,
-                                dep_function_name,
-                                kwargs_config=kwargs_config,
-                            )
-
-                        # For route paths, directly update the wrapper's dependencies
-                        # This bypasses the injector key-based lookup which doesn't work for routes
-                        if route_wrapper_info:
-                            wrapper = route_wrapper_info.get("wrapper")
-                            if wrapper and hasattr(wrapper, "_mesh_update_dependency"):
-                                wrapper._mesh_update_dependency(dep_index, new_proxy)
-                                updated_count += 1
-                                self.logger.debug(
-                                    f"Updated route dependency '{capability}' at position {dep_index} "
-                                    f"→ {endpoint}/{dep_function_name} for route '{function_name}'"
-                                )
-                            else:
-                                self.logger.warning(
-                                    f"Route wrapper for '{function_name}' doesn't have _mesh_update_dependency method"
-                                )
-                        else:
-                            # Fallback: Register with composite key using func_id for MCP tools
-                            dep_key = f"{func_id}:dep_{dep_index}"
-                            await injector.register_dependency(dep_key, new_proxy)
-                            updated_count += 1
-
-                            # Log which functions will be affected
-                            affected_functions = injector._dependency_mapping.get(
-                                dep_key, set()
-                            )
-                            self.logger.debug(
-                                f"Functions affected by '{capability}' at position {dep_index}: {list(affected_functions)}"
-                            )
-
-                            self.logger.debug(
-                                f"Updated API dependency '{capability}' at position {dep_index} → {endpoint}/{dep_function_name}"
-                            )
-                            self.logger.debug(
-                                f"Registered dependency '{capability}' at position {dep_index} with key '{dep_key}' (func_id: {func_id})"
-                            )
-                    else:
-                        if status != "available":
-                            self.logger.debug(
-                                f"API dependency '{capability}' at position {dep_index} not available: {status}"
-                            )
-                        else:
-                            self.logger.warning(
-                                f"Cannot update API dependency '{capability}' at position {dep_index}: missing endpoint or function_name"
-                            )
-
-            # Store new hash for next comparison (use global variable)
-            _last_api_dependency_hash = current_hash
-
-            if unwired_count > 0 or updated_count > 0:
-                self.logger.debug(
-                    f"API dependency sync: unwired={unwired_count}, updated={updated_count} (hash: {current_hash})"
-                )
-
-        except Exception as e:
-            self.logger.error(
-                f"❌ Failed to process API heartbeat response for rewiring: {e}"
-            )
-            # Don't raise - this should not break the heartbeat loop

_mcp_mesh/pipeline/api_heartbeat/api_fast_heartbeat_check.py

@@ -1,117 +0,0 @@
-"""
-Fast Heartbeat Check Step for API heartbeat pipeline.
-
-Performs lightweight HEAD requests to registry for fast topology change detection
-before expensive full POST heartbeat operations for FastAPI services.
-"""
-
-import logging
-from typing import Any
-
-from ...shared.fast_heartbeat_status import FastHeartbeatStatus, FastHeartbeatStatusUtil
-from ..shared.base_step import PipelineStep
-from ..shared.pipeline_types import PipelineResult
-
-logger = logging.getLogger(__name__)
-
-
-class APIFastHeartbeatStep(PipelineStep):
-    """
-    Fast heartbeat check step for API services optimization and resilience.
-
-    Performs lightweight HEAD request to registry to check for topology changes
-    before deciding whether to execute expensive full POST heartbeat for API services.
-
-    Stores semantic status in context for pipeline conditional execution.
-    """
-
-    def __init__(self):
-        super().__init__(
-            name="api-fast-heartbeat-check",
-            required=True,
-            description="Lightweight HEAD request for fast topology change detection (API services)",
-        )
-
-    async def execute(self, context: dict[str, Any]) -> PipelineResult:
-        """
-        Execute fast heartbeat check for API service and store semantic status.
-
-        Args:
-            context: Pipeline context containing service_id/agent_id and registry_wrapper
-
-        Returns:
-            PipelineResult with fast_heartbeat_status in context
-        """
-        self.logger.trace("Starting API fast heartbeat check...")
-
-        result = PipelineResult(message="API fast heartbeat check completed")
-
-        try:
-            # Validate required context - API services use service_id or agent_id
-            service_id = context.get("service_id") or context.get("agent_id")
-            registry_wrapper = context.get("registry_wrapper")
-
-            if not service_id:
-                raise ValueError("service_id or agent_id is required in context")
-
-            if not registry_wrapper:
-                raise ValueError("registry_wrapper is required in context")
-
-            self.logger.trace(
-                f"🚀 Performing API fast heartbeat check for service '{service_id}'"
-            )
-
-            # Perform fast heartbeat check using same method as MCP agents
-            status = await registry_wrapper.check_fast_heartbeat(service_id)
-
-            # Store semantic status in context
-            result.add_context("fast_heartbeat_status", status)
-
-            # Set appropriate message based on status
-            action_description = FastHeartbeatStatusUtil.get_action_description(status)
-            result.message = f"API fast heartbeat check: {action_description}"
-
-            # Log status and action with API-specific messaging
-            if status == FastHeartbeatStatus.NO_CHANGES:
-                self.logger.info(
-                    f"✅ API fast heartbeat: No changes detected for service '{service_id}'"
-                )
-            elif status == FastHeartbeatStatus.TOPOLOGY_CHANGED:
-                self.logger.info(
-                    f"🔄 API fast heartbeat: Topology changed for service '{service_id}' - full refresh needed"
-                )
-            elif status == FastHeartbeatStatus.AGENT_UNKNOWN:
-                self.logger.info(
-                    f"❓ API fast heartbeat: Service '{service_id}' unknown - re-registration needed"
-                )
-            elif status == FastHeartbeatStatus.REGISTRY_ERROR:
-                self.logger.warning(
-                    f"⚠️ API fast heartbeat: Registry error for service '{service_id}' - skipping for resilience"
-                )
-            elif status == FastHeartbeatStatus.NETWORK_ERROR:
-                self.logger.warning(
-                    f"⚠️ API fast heartbeat: Network error for service '{service_id}' - skipping for resilience"
-                )
-
-        except Exception as e:
-            # Convert any exception to NETWORK_ERROR for resilient handling
-            status = FastHeartbeatStatusUtil.from_exception(e)
-            result.add_context("fast_heartbeat_status", status)
-
-            action_description = FastHeartbeatStatusUtil.get_action_description(status)
-            result.message = f"API fast heartbeat check: {action_description}"
-
-            self.logger.warning(
-                f"⚠️ API fast heartbeat check failed for service '{service_id}': {e}"
-            )
-            self.logger.debug(f"Exception details: {e}", exc_info=True)
-
-            # Step succeeds but sets error status for pipeline decision
-            # This ensures pipeline can handle errors gracefully
-
-        # Always preserve existing context
-        for key, value in context.items():
-            if key not in result.context:
-                result.add_context(key, value)
-
-        return result

_mcp_mesh/pipeline/api_heartbeat/api_health_check.py

@@ -1,140 +0,0 @@
-"""
-API health check step for API heartbeat pipeline.
-
-Validates FastAPI application health status and endpoint availability
-for heartbeat reporting to the registry.
-"""
-
-import logging
-from typing import Any
-
-from ..shared.base_step import PipelineStep
-from ..shared.pipeline_types import PipelineResult
-
-logger = logging.getLogger(__name__)
-
-
-class APIHealthCheckStep(PipelineStep):
-    """
-    Check FastAPI application health status.
-    
-    Validates that the FastAPI application is running properly
-    and endpoints are accessible for dependency injection.
-    """
-
-    def __init__(self, required: bool = True):
-        super().__init__(
-            name="api-health-check",
-            required=required,
-        )
-
-    async def execute(self, context: dict[str, Any]) -> PipelineResult:
-        """
-        Check FastAPI application health status.
-
-        Args:
-            context: Pipeline context containing fastapi_app and service info
-
-        Returns:
-            PipelineResult with health_status in context
-        """
-        self.logger.info("🏥 [DEBUG] Checking FastAPI application health status")
-
-        try:
-            # Get FastAPI app from context
-            fastapi_app = context.get("fastapi_app")
-            service_id = context.get("service_id") or context.get("agent_id", "unknown")
-            
-            if not fastapi_app:
-                error_msg = "No FastAPI application found in context for health check"
-                self.logger.error(f"❌ {error_msg}")
-                
-                from ..shared.pipeline_types import PipelineStatus
-                result = PipelineResult(
-                    status=PipelineStatus.FAILED,
-                    message=error_msg,
-                    context=context
-                )
-                result.add_error(error_msg)
-                return result
-
-            # Check FastAPI app basic properties
-            app_title = getattr(fastapi_app, "title", "Unknown API")
-            app_version = getattr(fastapi_app, "version", "1.0.0")
-            
-            # Count available routes with dependency injection
-            routes_with_mesh = self._count_mesh_routes(fastapi_app)
-            total_routes = len(getattr(fastapi_app, "routes", []))
-
-            self.logger.debug(
-                f"🔍 FastAPI app health: {app_title} v{app_version}, "
-                f"{routes_with_mesh}/{total_routes} routes with mesh injection"
-            )
-
-            # Build health status for API service
-            # For API services, we create a simplified health status dict instead of using
-            # the strict HealthStatus model which requires capabilities (designed for MCP agents)
-            from datetime import UTC, datetime
-            
-            health_status_dict = {
-                "agent_name": service_id,
-                "status": "healthy",
-                "timestamp": datetime.now(UTC).isoformat(),
-                "version": app_version,
-                "metadata": {
-                    "service_type": "api",
-                    "app_title": app_title,
-                    "app_version": app_version,
-                    "routes_total": total_routes,
-                    "routes_with_mesh": routes_with_mesh,
-                    "health_check_timestamp": datetime.now(UTC).isoformat(),
-                }
-            }
-
-            self.logger.info(
-                f"🏥 API health check passed: {app_title} v{app_version} "
-                f"({routes_with_mesh} mesh routes)"
-            )
-
-            return PipelineResult(
-                message=f"API health check passed for {app_title}",
-                context={
-                    "health_status": health_status_dict,
-                    "app_title": app_title,
-                    "app_version": app_version,
-                    "routes_total": total_routes,
-                    "routes_with_mesh": routes_with_mesh,
-                }
-            )
-
-        except Exception as e:
-            error_msg = f"API health check failed: {e}"
-            self.logger.error(f"❌ {error_msg}")
-
-            from ..shared.pipeline_types import PipelineStatus
-            result = PipelineResult(
-                status=PipelineStatus.FAILED,
-                message=error_msg,
-                context=context
-            )
-            result.add_error(str(e))
-            return result
-
-    def _count_mesh_routes(self, fastapi_app: Any) -> int:
-        """Count routes that have mesh dependency injection applied."""
-        try:
-            mesh_routes = 0
-            routes = getattr(fastapi_app, "routes", [])
-            
-            for route in routes:
-                # Check if route has dependency injection wrapper
-                endpoint = getattr(route, "endpoint", None)
-                if endpoint and hasattr(endpoint, "__wrapped__"):
-                    # This indicates our dependency injection wrapper
-                    mesh_routes += 1
-                    
-            return mesh_routes
-            
-        except Exception as e:
-            self.logger.warning(f"⚠️ Could not count mesh routes: {e}")
-            return 0