
    ci                     >    d Z ddlmZmZ ddlmZmZ  G d de      Zy)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                   B    e Zd ZdZdedeeef   defdZ	dede
defdZy)	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                      y)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
   s      A/tmp/pip-target-z3e9_cxr/lib/python/mcp/shared/response_router.pyroute_responsezResponseRouter.route_response'        	    errorc                      y)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   s      r   route_errorzResponseRouter.route_error4   r   r   N)__name__
__module____qualname____doc__r   dictstrr   boolr   r   r   r   r   r   r   r      sD      d38n QU i 	 d r   r   N)r   typingr   r   	mcp.typesr   r   r   r   r   r   <module>r      s     ! *)X )r   