o
    *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   W/home/ubuntu/veenaModal/venv/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    