a
    ”˜ëj�e  ã                   @  s  d Z ddlmZ ddlZddlZddlmZmZ ddlm	Z	m
Z
mZ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	rÜdd
lmZ ddlmZ ddlmZ ddlmZ ddlmZ ddl m!Z!m"Z"m#Z# ddl$m%Z% e &e'¡Z(G dd„ deeeƒZ)G dd„ deeeƒZ*dS )z!Base interfaces for tracing runs.é    )ÚannotationsN)ÚABCÚabstractmethod)ÚTYPE_CHECKINGÚAnyÚOptionalÚUnion)Úoverride)ÚAsyncCallbackHandlerÚBaseCallbackHandler)ÚTracerException)Ú_TracerCore)ÚSequence)ÚUUID)ÚRetryCallState)ÚDocument)ÚBaseMessage)ÚChatGenerationChunkÚGenerationChunkÚ	LLMResult)ÚRunc                      sP  e Zd ZdZedddœdd„ƒZdddœ‡ fdd„Zdddœd	d
„Zdddddœddddddddddœ	dd„Zdddddœddddddddddœ	dd„Z	e
dddœdddddddœd d!„ƒZe
d"dddd#œd$d%„ƒZe
d&dddd'œd(d)„ƒZd*dddd+œd,d-„Ze
dddddd.œddddddddddd/œ
d0d1„ƒZe
dd2œdddddd3œd4d5„ƒZe
dd2œd*ddddd6œd7d8„ƒZdddddd9œddddddddddd:œ
d;d<„Ze
ddddd=œd>d?„ƒZe
d*dddd+œd@dA„ƒZdddddBœddddddddddCœ	dDdE„Ze
d*dddd+œdFdG„ƒZe
dHddddIœdJdK„ƒZdLd dMœdNdO„Zd dPœdQdR„Z‡  ZS )SÚ
BaseTracerzBase interface for tracers.r   ÚNone©ÚrunÚreturnc                 C  s   dS ©zPersist a run.N© ©Úselfr   r   r   úZ/mnt/bigstor/www/usecases/.venv/lib/python3.9/site-packages/langchain_core/tracers/base.pyÚ_persist_run&   s    zBaseTracer._persist_runc                   s   t ƒ  |¡ |  |¡ dS )zStart a trace for a run.N©ÚsuperÚ_start_traceÚ_on_run_creater   ©Ú	__class__r   r    r$   *   s    zBaseTracer._start_tracec                 C  s0   |j s|  |¡ | j t|jƒ¡ |  |¡ dS )zEnd a trace for a run.N©Úparent_run_idr!   Zrun_mapÚpopÚstrÚidÚ_on_run_updater   r   r   r    Ú
_end_trace/   s    
zBaseTracer._end_traceN)Útagsr)   ÚmetadataÚnameúdict[str, Any]úlist[list[BaseMessage]]r   úOptional[list[str]]úOptional[UUID]úOptional[dict[str, Any]]úOptional[str]r   )	Ú
serializedÚmessagesÚrun_idr/   r)   r0   r1   Úkwargsr   c          
   
   K  s8   | j f |||||||dœ|¤Ž}	|  |	¡ |  |	¡ |	S )aò  Start a trace for an LLM run.

        Args:
            serialized: The serialized model.
            messages: The messages to start the chat with.
            run_id: The run ID.
            tags: The tags for the run. Defaults to None.
            parent_run_id: The parent run ID. Defaults to None.
            metadata: The metadata for the run. Defaults to None.
            name: The name of the run.
            kwargs: Additional arguments.

        Returns:
            The run.
        ©r8   r9   r:   r)   r/   r0   r1   )Ú_create_chat_model_runr$   Ú_on_chat_model_start)
r   r8   r9   r:   r/   r)   r0   r1   r;   Úchat_model_runr   r   r    Úon_chat_model_start6   s    ùø


zBaseTracer.on_chat_model_startú	list[str])	r8   Úpromptsr:   r/   r)   r0   r1   r;   r   c          
   
   K  s8   | j f |||||||dœ|¤Ž}	|  |	¡ |  |	¡ |	S )aï  Start a trace for an LLM run.

        Args:
            serialized: The serialized model.
            prompts: The prompts to start the LLM with.
            run_id: The run ID.
            tags: The tags for the run. Defaults to None.
            parent_run_id: The parent run ID. Defaults to None.
            metadata: The metadata for the run. Defaults to None.
            name: The name of the run.
            kwargs: Additional arguments.

        Returns:
            The run.
        )r8   rB   r:   r)   r/   r0   r1   )Ú_create_llm_runr$   Ú_on_llm_start)
r   r8   rB   r:   r/   r)   r0   r1   r;   Úllm_runr   r   r    Úon_llm_start_   s    ùø


zBaseTracer.on_llm_start©Úchunkr)   r+   ú5Optional[Union[GenerationChunk, ChatGenerationChunk]]©ÚtokenrH   r:   r)   r;   r   c                K  s$   | j ||||d�}|  |||¡ |S )aV  Run on new LLM token. Only available when streaming is enabled.

        Args:
            token: The token.
            chunk: The chunk. Defaults to None.
            run_id: The run ID.
            parent_run_id: The parent run ID. Defaults to None.
            kwargs: Additional arguments.

        Returns:
            The run.
        ©rK   r:   rH   r)   ©Z_llm_run_with_token_eventÚ_on_llm_new_token©r   rK   rH   r:   r)   r;   rE   r   r   r    Úon_llm_new_tokenˆ   s    üzBaseTracer.on_llm_new_tokenr   ©Úretry_stater:   r;   r   c                K  s   | j ||d�S )zÀRun on retry.

        Args:
            retry_state: The retry state.
            run_id: The run ID.
            kwargs: Additional arguments.

        Returns:
            The run.
        ©rR   r:   ©Z_llm_run_with_retry_event©r   rR   r:   r;   r   r   r    Úon_retry©   s    þzBaseTracer.on_retryr   )Úresponser:   r;   r   c                K  s&   | j ||d�}|  |¡ |  |¡ |S )zÈEnd a trace for an LLM run.

        Args:
            response: The response.
            run_id: The run ID.
            kwargs: Additional arguments.

        Returns:
            The run.
        ©rW   r:   )Ú_complete_llm_runr.   Ú_on_llm_end)r   rW   r:   r;   rE   r   r   r    Ú
on_llm_endÀ   s    þ

zBaseTracer.on_llm_endÚBaseException)Úerrorr:   r;   r   c                K  s0   | j ||| dd¡d�}|  |¡ |  |¡ |S )zÆHandle an error for an LLM run.

        Args:
            error: The error.
            run_id: The run ID.
            kwargs: Additional arguments.

        Returns:
            The run.
        rW   N)r]   r:   rW   )Ú_errored_llm_runr*   r.   Ú_on_llm_error)r   r]   r:   r;   rE   r   r   r    Úon_llm_errorÖ   s    ÿ

zBaseTracer.on_llm_error©r/   r)   r0   Úrun_typer1   ©
r8   Úinputsr:   r/   r)   r0   rb   r1   r;   r   c                K  s:   | j f ||||||||dœ|	¤Ž}
|  |
¡ |  |
¡ |
S )a#  Start a trace for a chain run.

        Args:
            serialized: The serialized chain.
            inputs: The inputs for the chain.
            run_id: The run ID.
            tags: The tags for the run. Defaults to None.
            parent_run_id: The parent run ID. Defaults to None.
            metadata: The metadata for the run. Defaults to None.
            run_type: The type of the run. Defaults to None.
            name: The name of the run.
            kwargs: Additional arguments.

        Returns:
            The run.
        ©r8   rd   r:   r/   r)   r0   rb   r1   )Ú_create_chain_runr$   Ú_on_chain_start)r   r8   rd   r:   r/   r)   r0   rb   r1   r;   Ú	chain_runr   r   r    Úon_chain_startð   s    ø	÷

zBaseTracer.on_chain_start©rd   ©Úoutputsr:   rd   r;   r   c                K  s(   | j |||d�}|  |¡ |  |¡ |S )a  End a trace for a chain run.

        Args:
            outputs: The outputs for the chain.
            run_id: The run ID.
            inputs: The inputs for the chain. Defaults to None.
            kwargs: Additional arguments.

        Returns:
            The run.
        ©rl   r:   rd   )Ú_complete_chain_runr.   Ú_on_chain_end)r   rl   r:   rd   r;   rh   r   r   r    Úon_chain_end  s    ý

zBaseTracer.on_chain_end©r]   rd   r:   r;   r   c                K  s(   | j |||d�}|  |¡ |  |¡ |S )a  Handle an error for a chain run.

        Args:
            error: The error.
            inputs: The inputs for the chain. Defaults to None.
            run_id: The run ID.
            kwargs: Additional arguments.

        Returns:
            The run.
        )r]   r:   rd   )Ú_errored_chain_runr.   Ú_on_chain_error)r   r]   rd   r:   r;   rh   r   r   r    Úon_chain_error:  s    ý

zBaseTracer.on_chain_error©r/   r)   r0   r1   rd   ©
r8   Ú	input_strr:   r/   r)   r0   r1   rd   r;   r   c                K  s:   | j f ||||||||dœ|	¤Ž}
|  |
¡ |  |
¡ |
S )a  Start a trace for a tool run.

        Args:
            serialized: The serialized tool.
            input_str: The input string.
            run_id: The run ID.
            tags: The tags for the run. Defaults to None.
            parent_run_id: The parent run ID. Defaults to None.
            metadata: The metadata for the run. Defaults to None.
            name: The name of the run.
            inputs: The inputs for the tool.
            kwargs: Additional arguments.

        Returns:
            The run.
        )r8   rw   r:   r/   r)   r0   r1   rd   )Ú_create_tool_runr$   Ú_on_tool_start)r   r8   rw   r:   r/   r)   r0   r1   rd   r;   Útool_runr   r   r    Úon_tool_startW  s    ø	÷

zBaseTracer.on_tool_start©Úoutputr:   r;   r   c                K  s&   | j ||d�}|  |¡ |  |¡ |S )zÑEnd a trace for a tool run.

        Args:
            output: The output for the tool.
            run_id: The run ID.
            kwargs: Additional arguments.

        Returns:
            The run.
        ©r}   r:   )Ú_complete_tool_runr.   Ú_on_tool_end)r   r}   r:   r;   rz   r   r   r    Úon_tool_endƒ  s    þ

zBaseTracer.on_tool_endc                K  s&   | j ||d�}|  |¡ |  |¡ |S )zÆHandle an error for a tool run.

        Args:
            error: The error.
            run_id: The run ID.
            kwargs: Additional arguments.

        Returns:
            The run.
        ©r]   r:   )Ú_errored_tool_runr.   Ú_on_tool_error)r   r]   r:   r;   rz   r   r   r    Úon_tool_error—  s    þ

zBaseTracer.on_tool_error©r)   r/   r0   r1   ©	r8   Úqueryr:   r)   r/   r0   r1   r;   r   c          
   
   K  s8   | j f |||||||dœ|¤Ž}	|  |	¡ |  |	¡ |	S )aâ  Run when the Retriever starts running.

        Args:
            serialized: The serialized retriever.
            query: The query.
            run_id: The run ID.
            parent_run_id: The parent run ID. Defaults to None.
            tags: The tags for the run. Defaults to None.
            metadata: The metadata for the run. Defaults to None.
            name: The name of the run.
            kwargs: Additional arguments.

        Returns:
            The run.
        ©r8   rˆ   r:   r)   r/   r0   r1   )Ú_create_retrieval_runr$   Ú_on_retriever_start)
r   r8   rˆ   r:   r)   r/   r0   r1   r;   Úretrieval_runr   r   r    Úon_retriever_start±  s    ùø


zBaseTracer.on_retriever_startc                K  s&   | j ||d�}|  |¡ |  |¡ |S )zÁRun when Retriever errors.

        Args:
            error: The error.
            run_id: The run ID.
            kwargs: Additional arguments.

        Returns:
            The run.
        r‚   )Ú_errored_retrieval_runr.   Ú_on_retriever_error)r   r]   r:   r;   rŒ   r   r   r    Úon_retriever_errorÚ  s    þ

zBaseTracer.on_retriever_errorúSequence[Document])Ú	documentsr:   r;   r   c                K  s&   | j ||d�}|  |¡ |  |¡ |S )zÓRun when the Retriever ends running.

        Args:
            documents: The documents.
            run_id: The run ID.
            kwargs: Additional arguments.

        Returns:
            The run.
        ©r’   r:   )Ú_complete_retrieval_runr.   Ú_on_retriever_end)r   r’   r:   r;   rŒ   r   r   r    Úon_retriever_endô  s    þ

zBaseTracer.on_retriever_endÚdict)Úmemor   c                 C  s   | S ©zReturn self.r   )r   r˜   r   r   r    Ú__deepcopy__
  s    zBaseTracer.__deepcopy__)r   c                 C  s   | S r™   r   )r   r   r   r    Ú__copy__  s    zBaseTracer.__copy__)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   r!   r$   r.   r@   rF   r	   rP   rV   r[   r`   ri   rp   rt   r{   r�   r…   r�   r�   r–   rš   r›   Ú__classcell__r   r   r&   r    r   #   st   ÷"/÷")ú ö&,ûü"ö$,÷")r   c                      sŽ  e Zd ZdZeedddœdd„ƒƒZedddœ‡ fdd„ƒZedddœd	d
„ƒZedddddœddddddddddœ	dd„ƒZ	eddddœdddddddddœdd„ƒZ
edddœddddddd œd!d"„ƒZed#dddd$œd%d&„ƒZeddd'œd(dddddd)œd*d+„ƒZeddd'œd,dddddd-œd.d/„ƒZedddddd0œddddddddddd1œ
d2d3„ƒZedd4œdddddd5œd6d7„ƒZedd4œd,ddddd8œd9d:„ƒZedddddd;œddddddddddd<œ
d=d>„ƒZeddddd?œd@dA„ƒZeddd'œd,dddddd-œdBdC„ƒZedddddœddddddddddDœ	dEdF„ƒZeddd'œd,dddddd-œdGdH„ƒZeddd'œdIddddddJœdKdL„ƒZdddœdMdN„ZdddœdOdP„ZdddœdQdR„ZdddœdSdT„ZdddœdUdV„ZdddddWœdXdY„ZdddœdZd[„Zdddœd\d]„Zdddœd^d_„Z dddœd`da„Z!dddœdbdc„Z"dddœddde„Z#dddœdfdg„Z$dddœdhdi„Z%dddœdjdk„Z&dddœdldm„Z'‡  Z(S )nÚAsyncBaseTracerz!Async Base interface for tracers.r   r   r   c                 Ã  s   dS r   r   r   r   r   r    r!     s    zAsyncBaseTracer._persist_runc                 ƒ  s    t ƒ  |¡ |  |¡I dH  dS )zÎStart a trace for a run.

        Starting a trace will run concurrently with each _on_[run_type]_start method.
        No _on_[run_type]_start callback should depend on operations in _start_trace.
        Nr"   r   r&   r   r    r$     s    zAsyncBaseTracer._start_tracec                 Ã  s<   |j s|  |¡I dH  | j t|jƒ¡ |  |¡I dH  dS )zÄEnd a trace for a run.

        Ending a trace will run concurrently with each _on_[run_type]_end method.
        No _on_[run_type]_end callback should depend on operations in _end_trace.
        Nr(   r   r   r   r    r.   %  s    zAsyncBaseTracer._end_traceNr†   r2   r3   r   r5   r4   r6   r7   r   )	r8   r9   r:   r)   r/   r0   r1   r;   r   c             
   Ë  sH   | j f |||||||dœ|¤Ž}	|  |	¡|  |	¡g}
tj|
Ž I d H  |	S )Nr<   )r=   r$   r>   ÚasyncioÚgather)r   r8   r9   r:   r)   r/   r0   r1   r;   r?   Útasksr   r   r    r@   1  s     ùøþz#AsyncBaseTracer.on_chat_model_start)r)   r/   r0   rA   )r8   rB   r:   r)   r/   r0   r;   r   c          
   	   Ë  sF   | j f ||||||dœ|¤Ž}|  |¡|  |¡g}	tj|	Ž I d H  d S )N)r8   rB   r:   r)   r/   r0   )rC   r$   rD   r¢   r£   )
r   r8   rB   r:   r)   r/   r0   r;   rE   r¤   r   r   r    rF   O  s    úù	zAsyncBaseTracer.on_llm_startrG   r+   rI   rJ   c                Ë  s*   | j ||||d�}|  |||¡I d H  d S )NrL   rM   rO   r   r   r    rP   g  s    
üz AsyncBaseTracer.on_llm_new_tokenr   rQ   c                Ë  s   | j ||d� d S )NrS   rT   rU   r   r   r    rV   y  s    þzAsyncBaseTracer.on_retry)r)   r/   r   )rW   r:   r)   r/   r;   r   c                Ë  s6   | j ||d�}|  |¡|  |¡g}tj|Ž I d H  d S )NrX   )rY   rZ   r.   r¢   r£   )r   rW   r:   r)   r/   r;   rE   r¤   r   r   r    r[   †  s    
þzAsyncBaseTracer.on_llm_endr\   )r]   r:   r)   r/   r;   r   c                Ë  s6   | j ||d�}|  |¡|  |¡g}tj|Ž I d H  d S ©Nr‚   )r^   r_   r.   r¢   r£   )r   r]   r:   r)   r/   r;   rE   r¤   r   r   r    r`   —  s    
þzAsyncBaseTracer.on_llm_errorra   rc   c                Ë  sJ   | j f ||||||||dœ|	¤Ž}
|  |
¡|  |
¡g}tj|Ž I d H  d S )Nre   )rf   r$   rg   r¢   r£   )r   r8   rd   r:   r/   r)   r0   rb   r1   r;   rh   r¤   r   r   r    ri   ¨  s    ø	÷zAsyncBaseTracer.on_chain_startrj   rk   c                Ë  s8   | j |||d�}|  |¡|  |¡g}tj|Ž I d H  d S )Nrm   )rn   r.   ro   r¢   r£   )r   rl   r:   rd   r;   rh   r¤   r   r   r    rp   Ä  s    	ýzAsyncBaseTracer.on_chain_endrq   c                Ë  s8   | j |||d�}|  |¡|  |¡g}tj|Ž I d H  d S )N)r]   rd   r:   )rr   r.   rs   r¢   r£   )r   r]   rd   r:   r;   rh   r¤   r   r   r    rt   Õ  s    	ýzAsyncBaseTracer.on_chain_errorru   rv   c             
   Ë  sH   | j f |||||||dœ|	¤Ž}
|  |
¡|  |
¡g}tj|Ž I d H  d S )N)r8   rw   r:   r/   r)   r0   rd   )rx   r$   ry   r¢   r£   )r   r8   rw   r:   r/   r)   r0   r1   rd   r;   rz   r¤   r   r   r    r{   æ  s    ùø
zAsyncBaseTracer.on_tool_startr|   c                Ë  s6   | j ||d�}|  |¡|  |¡g}tj|Ž I d H  d S )Nr~   )r   r.   r€   r¢   r£   )r   r}   r:   r;   rz   r¤   r   r   r    r�     s    þzAsyncBaseTracer.on_tool_endc                Ë  s6   | j ||d�}|  |¡|  |¡g}tj|Ž I d H  d S r¥   )rƒ   r.   r„   r¢   r£   )r   r]   r:   r)   r/   r;   rz   r¤   r   r   r    r…     s    
þzAsyncBaseTracer.on_tool_errorr‡   c             	   Ë  s@   | j |||||||d�}	|  |	¡|  |	¡g}
tj|
Ž I d H  d S )Nr‰   )rŠ   r$   r‹   r¢   r£   )r   r8   rˆ   r:   r)   r/   r0   r1   r;   Zretriever_runr¤   r   r   r    r�   !  s    ù
þz"AsyncBaseTracer.on_retriever_startc                Ë  s6   | j ||d�}|  |¡|  |¡g}tj|Ž I d H  d S r¥   )rŽ   r.   r�   r¢   r£   )r   r]   r:   r)   r/   r;   rŒ   r¤   r   r   r    r�   =  s    
þþz"AsyncBaseTracer.on_retriever_errorr‘   )r’   r:   r)   r/   r;   r   c                Ë  s6   | j ||d�}|  |¡|  |¡g}tj|Ž I d H  d S )Nr“   )r”   r.   r•   r¢   r£   )r   r’   r:   r)   r/   r;   rŒ   r¤   r   r   r    r–   Q  s    
þz AsyncBaseTracer.on_retriever_endc                 Ã  s   dS )zProcess a run upon creation.Nr   r   r   r   r    r%   b  s    zAsyncBaseTracer._on_run_createc                 Ã  s   dS )zProcess a run upon update.Nr   r   r   r   r    r-   e  s    zAsyncBaseTracer._on_run_updatec                 Ã  s   dS )zProcess the LLM Run upon start.Nr   r   r   r   r    rD   h  s    zAsyncBaseTracer._on_llm_startc                 Ã  s   dS )zProcess the LLM Run.Nr   r   r   r   r    rZ   k  s    zAsyncBaseTracer._on_llm_endc                 Ã  s   dS )zProcess the LLM Run upon error.Nr   r   r   r   r    r_   n  s    zAsyncBaseTracer._on_llm_error)r   rK   rH   r   c                 Ã  s   dS )zProcess new LLM token.Nr   )r   r   rK   rH   r   r   r    rN   q  s    z!AsyncBaseTracer._on_llm_new_tokenc                 Ã  s   dS )z!Process the Chain Run upon start.Nr   r   r   r   r    rg   y  s    zAsyncBaseTracer._on_chain_startc                 Ã  s   dS )zProcess the Chain Run.Nr   r   r   r   r    ro   |  s    zAsyncBaseTracer._on_chain_endc                 Ã  s   dS )z!Process the Chain Run upon error.Nr   r   r   r   r    rs     s    zAsyncBaseTracer._on_chain_errorc                 Ã  s   dS )z Process the Tool Run upon start.Nr   r   r   r   r    ry   ‚  s    zAsyncBaseTracer._on_tool_startc                 Ã  s   dS )zProcess the Tool Run.Nr   r   r   r   r    r€   …  s    zAsyncBaseTracer._on_tool_endc                 Ã  s   dS )z Process the Tool Run upon error.Nr   r   r   r   r    r„   ˆ  s    zAsyncBaseTracer._on_tool_errorc                 Ã  s   dS )z&Process the Chat Model Run upon start.Nr   r   r   r   r    r>   ‹  s    z$AsyncBaseTracer._on_chat_model_startc                 Ã  s   dS )z%Process the Retriever Run upon start.Nr   r   r   r   r    r‹   Ž  s    z#AsyncBaseTracer._on_retriever_startc                 Ã  s   dS )zProcess the Retriever Run.Nr   r   r   r   r    r•   ‘  s    z!AsyncBaseTracer._on_retriever_endc                 Ã  s   dS )z%Process the Retriever Run upon error.Nr   r   r   r   r    r�   ”  s    z#AsyncBaseTracer._on_retriever_error))rœ   r�   rž   rŸ   r   r	   r!   r$   r.   r@   rF   rP   rV   r[   r`   ri   rp   rt   r{   r�   r…   r�   r�   r–   r%   r-   rD   rZ   r_   rN   rg   ro   rs   ry   r€   r„   r>   r‹   r•   r�   r    r   r   r&   r    r¡     s²   	÷$ø"úúúö&ûüö&ú÷$úúr¡   )+rŸ   Ú
__future__r   r¢   ÚloggingÚabcr   r   Útypingr   r   r   r   Ztyping_extensionsr	   Zlangchain_core.callbacks.baser
   r   Zlangchain_core.exceptionsr   Zlangchain_core.tracers.corer   Úcollections.abcr   Úuuidr   Ztenacityr   Zlangchain_core.documentsr   Zlangchain_core.messagesr   Zlangchain_core.outputsr   r   r   Zlangchain_core.tracers.schemasr   Ú	getLoggerrœ   Úloggerr   r¡   r   r   r   r    Ú<module>   s.   
   s