o
    cÛ·iû  ã                   @   s8   d Z ddlmZmZ ddlmZmZ G dd„ deƒZdS )a:  
ResponseRouter - Protocol for pluggable response routing.

This module defines a protocol for routing JSON-RPC responses to alternative
handlers before falling back to the default response stream mechanism.

The primary use case is task-augmented requests: when a TaskSession enqueues
a request (like elicitation), the response needs to be routed back to the
waiting resolver instead of the normal response stream.

Design:
- Protocol-based for testability and flexibility
- Returns bool to indicate if response was handled
- Supports both success responses and errors
é    )ÚAnyÚProtocol)Ú	ErrorDataÚ	RequestIdc                   @   sD   e Zd ZdZdedeeef defdd„Z	dede
defdd	„Zd
S )ÚResponseRoutera  
    Protocol for routing responses to alternative handlers.

    Implementations check if they have a pending request for the given ID
    and deliver the response/error to the appropriate handler.

    Example:
        class TaskResultHandler(ResponseRouter):
            def route_response(self, request_id, response):
                resolver = self._pending_requests.pop(request_id, None)
                if resolver:
                    resolver.set_result(response)
                    return True
                return False
    Ú
request_idÚresponseÚreturnc                 C   ó   dS )a  
        Try to route a response to a pending request handler.

        Args:
            request_id: The JSON-RPC request ID from the response
            response: The response result data

        Returns:
            True if the response was handled, False otherwise
        N© )Úselfr   r   r   r   úP/home/ubuntu/vllm_env/lib/python3.10/site-packages/mcp/shared/response_router.pyÚroute_response'   ó   zResponseRouter.route_responseÚerrorc                 C   r
   )a  
        Try to route an error to a pending request handler.

        Args:
            request_id: The JSON-RPC request ID from the error response
            error: The error data

        Returns:
            True if the error was handled, False otherwise
        Nr   )r   r   r   r   r   r   Úroute_error4   r   zResponseRouter.route_errorN)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   ÚdictÚstrr   Úboolr   r   r   r   r   r   r   r      s    r   N)r   Útypingr   r   Ú	mcp.typesr   r   r   r   r   r   r   Ú<module>   s    