a
    ”˜ëjBH  ã                   @   sŠ  d Z ddlZddlZddlZddlmZmZmZmZm	Z	 ddl
mZ ddlmZmZmZmZ ddlmZmZmZ ddlmZmZmZmZmZ ddlmZ dd	lmZ dd
lmZ  ddl!m"Z"m#Z# ddl$m%Z% ddl&m'Z' e (e)¡Z*dZ+G dd„ dedd�Z,G dd„ dedd�Z-G dd„ deƒZ.G dd„ deƒZ/G dd„ de/eƒZ0e0e0e0dœdd„Z1ee. ee. e.dœdd „Z2ee. ee. e.dœd!d"„Z3dS )#zAI message.é    N)ÚAnyÚLiteralÚOptionalÚUnionÚcast)Úmodel_validator)ÚNotRequiredÚSelfÚ	TypedDictÚoverride)ÚBaseMessageÚBaseMessageChunkÚmerge_content)ÚInvalidToolCallÚToolCallÚToolCallChunkÚdefault_tool_chunk_parserÚdefault_tool_parser)Úinvalid_tool_call)Ú	tool_call)Útool_call_chunk)Úmerge_dictsÚmerge_lists)Úparse_partial_json)Ú_dict_int_opzrun-c                   @   s*   e Zd ZU dZeed< eed< eed< dS )ÚInputTokenDetailsa~  Breakdown of input token counts.

    Does *not* need to sum to full input token count. Does *not* need to have all keys.

    Example:
        .. code-block:: python

            {
                "audio": 10,
                "cache_creation": 200,
                "cache_read": 100,
            }

    .. versionadded:: 0.3.9

    May also hold extra provider-specific keys.

    ÚaudioZcache_creationZ
cache_readN©Ú__name__Ú
__module__Ú__qualname__Ú__doc__ÚintÚ__annotations__© r$   r$   úY/mnt/bigstor/www/usecases/.venv/lib/python3.9/site-packages/langchain_core/messages/ai.pyr   *   s
   
r   F)Útotalc                   @   s"   e Zd ZU dZeed< eed< dS )ÚOutputTokenDetailsa'  Breakdown of output token counts.

    Does *not* need to sum to full output token count. Does *not* need to have all keys.

    Example:
        .. code-block:: python

            {
                "audio": 10,
                "reasoning": 200,
            }

    .. versionadded:: 0.3.9

    r   Z	reasoningNr   r$   r$   r$   r%   r'   N   s   
r'   c                   @   sB   e Zd ZU dZeed< eed< eed< ee ed< ee ed< dS )ÚUsageMetadataaâ  Usage metadata for a message, such as token counts.

    This is a standard representation of token usage that is consistent across models.

    Example:
        .. code-block:: python

            {
                "input_tokens": 350,
                "output_tokens": 240,
                "total_tokens": 590,
                "input_token_details": {
                    "audio": 10,
                    "cache_creation": 200,
                    "cache_read": 100,
                },
                "output_token_details": {
                    "audio": 10,
                    "reasoning": 200,
                },
            }

    .. versionchanged:: 0.3.9

        Added ``input_token_details`` and ``output_token_details``.

    Úinput_tokensÚoutput_tokensÚtotal_tokensZinput_token_detailsZoutput_token_detailsN)	r   r   r    r!   r"   r#   r   r   r'   r$   r$   r$   r%   r(   j   s   
r(   c                       sÖ   e Zd ZU dZdZeed< g Zee	 ed< g Z
ee ed< dZee ed< dZed ed	< eeeeeef  f edd
œ‡ fdd„Zeedœdd„ƒZedd�eeedœdd„ƒƒZedeedœ‡ fdd„ƒZ‡  ZS )Ú	AIMessagea=  Message from an AI.

    AIMessage is returned from a chat model as a response to a prompt.

    This message represents the output of the model and consists of both
    the raw output as returned by the model together standardized fields
    (e.g., tool calls, usage metadata) added by the LangChain framework.

    FÚexampleÚ
tool_callsÚinvalid_tool_callsNÚusage_metadataZaiÚtype)ÚcontentÚkwargsÚreturnc                    s   t ƒ jf d|i|¤Ž dS )z¨Initialize ``AIMessage``.

        Args:
            content: The content of the message.
            kwargs: Additional arguments to pass to the parent class.
        r2   N)ÚsuperÚ__init__)Úselfr2   r3   ©Ú	__class__r$   r%   r6   º   s    zAIMessage.__init__©r4   c                 C   s   | j | jdœS ©zEAttrs to be serialized even if they are derived from other init args.©r.   r/   r<   ©r7   r$   r$   r%   Úlc_attributesÇ   s    þzAIMessage.lc_attributesÚbefore©Úmode)Úvaluesr4   c           	         sð   t ‡ fdd„dD ƒƒ }|rŒˆ  di ¡ d¡ }rŒz8t| tƒrLt|ƒˆ d< nt|ƒ\}}|ˆ d< |ˆ d< W n  tyŠ   tjdd	d
� Y n0 ˆ  d¡ }r¬dd„ |D ƒˆ d< ˆ  d¡ }rÌdd„ |D ƒˆ d< ˆ  d¡ }rìdd„ |D ƒˆ d< ˆ S )Nc                 3   s   | ]}ˆ   |¡V  qd S ©N)Úget)Ú.0Úk©rB   r$   r%   Ú	<genexpr>Ó   s   ÿz9AIMessage._backwards_compat_tool_calls.<locals>.<genexpr>)r.   r/   Útool_call_chunksÚadditional_kwargsr.   rI   r/   zFailed to parse tool callsT)Úexc_infoc                 S   s(   g | ] }t f i d d„ | ¡ D ƒ¤Ž‘qS )c                 S   s   i | ]\}}|d kr||“qS ©r1   r$   ©rE   rF   Úvr$   r$   r%   Ú
<dictcomp>ë   ó    úEAIMessage._backwards_compat_tool_calls.<locals>.<listcomp>.<dictcomp>)Úcreate_tool_callÚitems©rE   Útcr$   r$   r%   Ú
<listcomp>ê   s   ÿz:AIMessage._backwards_compat_tool_calls.<locals>.<listcomp>c                 S   s(   g | ] }t f i d d„ | ¡ D ƒ¤Ž‘qS )c                 S   s   i | ]\}}|d kr||“qS rL   r$   rM   r$   r$   r%   rO   ð   rP   rQ   )Úcreate_invalid_tool_callrS   rT   r$   r$   r%   rV   ï   s   ÿc                 S   s(   g | ] }t f i d d„ | ¡ D ƒ¤Ž‘qS )c                 S   s   i | ]\}}|d kr||“qS rL   r$   rM   r$   r$   r%   rO   ö   rP   rQ   )Úcreate_tool_call_chunkrS   rT   r$   r$   r%   rV   õ   s   ÿ)	ÚanyrD   Ú
issubclassÚAIMessageChunkr   r   Ú	ExceptionÚloggerÚdebug)	ÚclsrB   Zcheck_additional_kwargsÚraw_tool_callsZparsed_tool_callsZparsed_invalid_tool_callsr.   r/   rI   r$   rG   r%   Ú_backwards_compat_tool_callsÐ   s>    þ
ÿ
ÿ
ÿþ
þ
þ
z&AIMessage._backwards_compat_tool_calls)Úhtmlr4   c                    sœ   t ƒ j|d�}g }tttf tt dœdd„}| jrX| d¡ | jD ]}| 	||ƒ¡ qD| j
r‚| d¡ | j
D ]}| 	||ƒ¡ qn| ¡ d d |¡  ¡ S )zïReturn a pretty representation of the message.

        Args:
            html: Whether to return an HTML-formatted string.
                 Defaults to False.

        Returns:
            A pretty representation of the message.

        )rb   )rU   r4   c                 S   s¶   d|   dd¡› d|   d¡› d�d|   d¡› �g}|   d¡rP| d	|   d¡› �¡ | d
¡ |   d¡}t|tƒr€| d|› �¡ n2t|tƒr²| ¡ D ]\}}| d|› d|› �¡ q’|S )Nz  ÚnameZToolz (Úidú)z
 Call ID: Úerrorz	  Error: z  Args:Úargsz    z: )rD   ÚappendÚ
isinstanceÚstrÚdictrS   )rU   Úlinesrg   ÚargÚvaluer$   r$   r%   Ú_format_tool_args  s    þ




z0AIMessage.pretty_repr.<locals>._format_tool_argszTool Calls:zInvalid Tool Calls:Ú
)r5   Úpretty_reprr   r   r   Úlistrj   r.   rh   Úextendr/   ÚstripÚjoin)r7   rb   Úbaserl   ro   rU   Zitcr8   r$   r%   rq   ü   s    



zAIMessage.pretty_repr)F)r   r   r    r!   r-   Úboolr#   r.   rr   r   r/   r   r0   r   r(   r1   r   r   rj   rk   r   r6   Úpropertyr>   r   Úclassmethodra   r   rq   Ú__classcell__r$   r$   r8   r%   r,   š   s"   

ü*r,   c                       sx   e Zd ZU dZd Zed  ed< g Zee	 ed< e
edœdd„ƒZedd�edœd	d
„ƒZeeedœ‡ fdd„ƒZ‡  ZS )r[   zMessage chunk from an AI.r1   rI   r:   c                 C   s   | j | jdœS r;   r<   r=   r$   r$   r%   r>   6  s    þzAIMessageChunk.lc_attributesÚafterr@   c              	      sî   | j sJ| jrdd„ | jD ƒ| _ | jrF| j }| dd„ | jD ƒ¡ || _ | S g }g ‰ tddœ‡ fdd„}| j D ]p}zP|d r†t|d ƒni }t|tƒr¶| t	|d	 p¤d
||d d�¡ n||ƒ W ql t
yÚ   ||ƒ Y ql0 ql|| _ˆ | _| S )zËInitialize tool calls from tool call chunks.

        Returns:
            The values with tool calls initialized.

        Raises:
            ValueError: If the tool call chunks are malformed.
        c                 S   s.   g | ]&}t |d  t |d ¡|d dd�‘qS ©rc   rg   rd   N)rc   rg   rd   Úindex)rX   ÚjsonÚdumpsrT   r$   r$   r%   rV   J  s   úüz2AIMessageChunk.init_tool_calls.<locals>.<listcomp>c                 S   s(   g | ] }t |d  |d |d dd�‘qS r|   )rX   rT   r$   r$   r%   rV   V  s   ýÿN)Úchunkr4   c                    s&   ˆ   t| d | d | d d d�¡ d S )Nrc   rg   rd   )rc   rg   rd   rf   )rh   rW   )r€   ©r/   r$   r%   Úadd_chunk_to_invalid_tool_callsc  s    üÿzGAIMessageChunk.init_tool_calls.<locals>.add_chunk_to_invalid_tool_callsrg   rc   Ú rd   )rc   rg   rd   )rI   r.   r/   rs   r   r   ri   rk   rh   rR   r\   )r7   rI   r.   r‚   r€   Zargs_r$   r�   r%   Úinit_tool_calls>  sD    
ù	üÿ



ýÿzAIMessageChunk.init_tool_calls)Úotherr4   c                    sP   t |tƒrt| |ƒS t |ttfƒrDtdd„ |D ƒƒrDt| g|¢R Ž S tƒ  |¡S )Nc                 s   s   | ]}t |tƒV  qd S rC   )ri   r[   ©rE   Úor$   r$   r%   rH   „  s   z)AIMessageChunk.__add__.<locals>.<genexpr>)ri   r[   Úadd_ai_message_chunksrr   ÚtupleÚallr5   Ú__add__)r7   r…   r8   r$   r%   r‹   €  s    

ÿzAIMessageChunk.__add__)r   r   r    r!   r1   r   r#   rI   rr   r   rx   rk   r>   r   r	   r„   r   r   r   r‹   rz   r$   r$   r8   r%   r[   &  s   
Ar[   )ÚleftÚothersr4   c              	      s\  t ‡ fdd„|D ƒƒr"d}t|ƒ‚tˆ jgdd„ |D ƒ¢R Ž }tˆ jgdd„ |D ƒ¢R Ž }tˆ jgdd„ |D ƒ¢R Ž }tˆ jgdd„ |D ƒ¢R Ž  }r¦dd	„ |D ƒ}ng }ˆ j	sÂt d
d„ |D ƒƒràˆ j	}|D ]}	t
||	j	ƒ}qÌnd}d}
ˆ jgdd	„ |D ƒ }|D ]"}|�r| t¡�s|}
 �qB�q|D ]}|�r*|}
 �qB�q*ˆ jˆ j||||||
d�S )a)  Add multiple ``AIMessageChunk``s together.

    Args:
        left: The first ``AIMessageChunk``.
        *others: Other ``AIMessageChunk``s to add.

    Raises:
        ValueError: If the example values of the chunks are not the same.

    Returns:
        The resulting ``AIMessageChunk``.

    c                 3   s   | ]}ˆ j |j kV  qd S rC   )r-   r†   ©rŒ   r$   r%   rH   ›  rP   z(add_ai_message_chunks.<locals>.<genexpr>zACannot concatenate AIMessageChunks with different example values.c                 s   s   | ]}|j V  qd S rC   )r2   r†   r$   r$   r%   rH   Ÿ  rP   c                 s   s   | ]}|j V  qd S rC   )rJ   r†   r$   r$   r%   rH   ¡  rP   c                 s   s   | ]}|j V  qd S rC   )Úresponse_metadatar†   r$   r$   r%   rH   ¤  rP   c                 s   s   | ]}|j V  qd S rC   )rI   r†   r$   r$   r%   rH   ©  rP   c              	   S   s4   g | ],}t | d ¡| d¡| d¡| d¡d�‘qS )rc   rg   r}   rd   )rc   rg   r}   rd   )rX   rD   )rE   Zrtcr$   r$   r%   rV   «  s   úüz)add_ai_message_chunks.<locals>.<listcomp>c                 s   s   | ]}|j d uV  qd S rC   )r0   r†   r$   r$   r%   rH   ¸  rP   Nc                 S   s   g | ]
}|j ‘qS r$   )rd   r†   r$   r$   r%   rV   À  rP   )r-   r2   rJ   rI   r�   r0   rd   )rY   Ú
ValueErrorr   r2   r   rJ   r�   r   rI   r0   Ú	add_usagerd   Ú
startswithÚ_LC_ID_PREFIXr9   r-   )rŒ   r�   Úmsgr2   rJ   r�   r`   rI   r0   r…   Zchunk_idÚ
candidatesZid_r$   rŽ   r%   rˆ   ‹  s^    ÿÿÿÿÿÿù


ùrˆ   )rŒ   Úrightr4   c              
   C   sV   | s|st dddd�S | r|s,td| p(|ƒS t f i tdttd| ƒtd|ƒtjƒƒ¤ŽS )aq  Recursively add two UsageMetadata objects.

    Example:
        .. code-block:: python

            from langchain_core.messages.ai import add_usage

            left = UsageMetadata(
                input_tokens=5,
                output_tokens=0,
                total_tokens=5,
                input_token_details=InputTokenDetails(cache_read=3),
            )
            right = UsageMetadata(
                input_tokens=0,
                output_tokens=10,
                total_tokens=10,
                output_token_details=OutputTokenDetails(reasoning=4),
            )

            add_usage(left, right)

        results in

        .. code-block:: python

            UsageMetadata(
                input_tokens=5,
                output_tokens=10,
                total_tokens=15,
                input_token_details=InputTokenDetails(cache_read=3),
                output_token_details=OutputTokenDetails(reasoning=4),
            )

    Args:
        left: The first ``UsageMetadata`` object.
        right: The second ``UsageMetadata`` object.

    Returns:
        The sum of the two ``UsageMetadata`` objects.

    r   ©r)   r*   r+   r(   rk   )r(   r   r   ÚoperatorÚadd©rŒ   r–   r$   r$   r%   r‘   Ø  s    -ýþÿr‘   c              
   C   sX   | s|st dddd�S | r|s,td| p(|ƒS t f i tdttd| ƒtd|ƒdd„ ƒƒ¤ŽS )aâ  Recursively subtract two ``UsageMetadata`` objects.

    Token counts cannot be negative so the actual operation is ``max(left - right, 0)``.

    Example:
        .. code-block:: python

            from langchain_core.messages.ai import subtract_usage

            left = UsageMetadata(
                input_tokens=5,
                output_tokens=10,
                total_tokens=15,
                input_token_details=InputTokenDetails(cache_read=4),
            )
            right = UsageMetadata(
                input_tokens=3,
                output_tokens=8,
                total_tokens=11,
                output_token_details=OutputTokenDetails(reasoning=4),
            )

            subtract_usage(left, right)

        results in

        .. code-block:: python

            UsageMetadata(
                input_tokens=2,
                output_tokens=2,
                total_tokens=4,
                input_token_details=InputTokenDetails(cache_read=4),
                output_token_details=OutputTokenDetails(reasoning=0),
            )

    Args:
        left: The first ``UsageMetadata`` object.
        right: The second ``UsageMetadata`` object.

    Returns:
        The resulting ``UsageMetadata`` after subtraction.

    r   r—   r(   rk   c                 S   s   t | | dƒS )Nr   )Úmax)ÚleÚrir$   r$   r%   Ú<lambda>P  rP   z subtract_usage.<locals>.<lambda>)r(   r   r   rš   r$   r$   r%   Úsubtract_usage  s    /ýþÿrŸ   )4r!   r~   Úloggingr˜   Útypingr   r   r   r   r   Zpydanticr   Ztyping_extensionsr   r	   r
   r   Zlangchain_core.messages.baser   r   r   Zlangchain_core.messages.toolr   r   r   r   r   r   rW   r   rR   r   rX   Zlangchain_core.utils._merger   r   Zlangchain_core.utils.jsonr   Zlangchain_core.utils.usager   Ú	getLoggerr   r]   r“   r   r'   r(   r,   r[   rˆ   r‘   rŸ   r$   r$   r$   r%   Ú<module>   s>   
$0 fþNþ?þ