a
    ”˜ëj  ã                	   @  s¶  U d 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
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 dd
lmZ erÎddlmZ ddlmZ ddlmZmZ ddl m!Z!m"Z" ddl#m$Z$ dZ%de&d< eddd�Z'de&d< eddd�Z(de&d< edBdddœdd„ƒZ)edCdddd œd!d"d#d$d%d&œd'd(„ƒZ*ed)d*œd+d,„ƒZ+dDd!d"d-d.d/œd0d1„Z,d2d*œd3d4„Z-dd*œd5d6„Z.g Z/d7e&d8< dEd9d:d;d!d<d=œd>d?„Z0e0e(d@dA� dS )FzContext management for tracers.é    )Úannotations)Úcontextmanager)Ú
ContextVar)ÚTYPE_CHECKINGÚAnyÚLiteralÚOptionalÚUnionÚcast)ÚUUID)Úrun_helpers)Úutils)ÚLangChainTracer)ÚRunCollectorCallbackHandler)Ú	Generator)ÚClient)ÚBaseCallbackHandlerÚ	Callbacks)ÚAsyncCallbackManagerÚCallbackManager)ÚTracerSessionV1Nr   Útracing_callback_varZtracing_callback_v2)Údefaultz%ContextVar[Optional[LangChainTracer]]Útracing_v2_callback_varZrun_collectorz1ContextVar[Optional[RunCollectorCallbackHandler]]Úrun_collector_varr   Ústrz&Generator[TracerSessionV1, None, None])Úsession_nameÚreturnc                 C  s   d}t |ƒ‚dS )z�Throw an error because this has been replaced by ``tracing_v2_enabled``.

    Raises:
        RuntimeError: Always, because this function is deprecated.
    zNtracing_enabled is no longer supported. Please use tracing_enabled_v2 instead.N)ÚRuntimeError)r   Úmsg© r    ú]/mnt/bigstor/www/usecases/.venv/lib/python3.9/site-packages/langchain_core/tracers/context.pyÚtracing_enabled*   s    
ÿr"   )Ú
example_idÚtagsÚclientzOptional[str]zOptional[Union[str, UUID]]zOptional[list[str]]zOptional[LangSmithClient]z&Generator[LangChainTracer, None, None])Úproject_namer#   r$   r%   r   c             	   c  sR   t |tƒrt|ƒ}t|| ||d�}t |¡}z|V  W t |¡ nt |¡ 0 dS )a=  Instruct LangChain to log all runs in context to LangSmith.

    Args:
        project_name (str, optional): The name of the project.
            Defaults to ``'default'``.
        example_id (str or UUID, optional): The ID of the example.
            Defaults to None.
        tags (list[str], optional): The tags to add to the run.
            Defaults to None.
        client (LangSmithClient, optional): The client of the langsmith.
            Defaults to None.

    Yields:
        LangChainTracer: The LangChain tracer.

    Example:
        >>> with tracing_v2_enabled():
        ...     # LangChain code will automatically be traced

        You can use this to fetch the LangSmith run URL:

        >>> with tracing_v2_enabled() as cb:
        ...     chain.invoke("foo")
        ...     run_url = cb.get_run_url()
    )r#   r&   r$   r%   N)Ú
isinstancer   r   r   r   ÚsetÚreset)r&   r#   r$   r%   ÚcbÚtokenr    r    r!   Útracing_v2_enabled9   s    !
ü
r,   z2Generator[RunCollectorCallbackHandler, None, None])r   c               	   c  s6   t ƒ } t | ¡}z| V  W t |¡ nt |¡ 0 dS )a  Collect all run traces in context.

    Yields:
        run_collector.RunCollectorCallbackHandler: The run collector callback handler.

    Example:
        >>> with collect_runs() as runs_cb:
                chain.invoke("foo")
                run_id = runs_cb.traced_runs[0].id
    N)r   r   r(   r)   )r*   r+   r    r    r!   Úcollect_runsi   s
    
r-   z6Optional[Union[CallbackManager, AsyncCallbackManager]]r   )r&   r#   Úcallback_managerr   c                 C  sf   t ƒ r^| ptƒ }t ¡ p"t||d�}|d u r:td|gƒ}qbtdd„ |jD ƒƒsX| |¡ |}nd }|S )N)r&   r#   r   c                 s  s   | ]}t |tƒV  qd S )N)r'   r   )Ú.0Úhandlerr    r    r!   Ú	<genexpr>‹   s   ÿz'_get_trace_callbacks.<locals>.<genexpr>)	Ú_tracing_v2_is_enabledÚ_get_tracer_projectr   Úgetr   r
   ÚanyÚhandlersÚadd_handler)r&   r#   r.   Zproject_name_Ztracerr*   r    r    r!   Ú_get_trace_callbacks}   s    

þþ
r8   zUnion[bool, Literal['local']]c                   C  s   t  ¡ d urdS t ¡ S )NT)r   r4   Úls_utilsZtracing_is_enabledr    r    r    r!   r2   ˜   s    r2   c               	   C  sL   t  ¡ } | d }|d u r,| d d ur,| d S t|dtt ¡ dtt ¡ ƒƒƒS )NÚparentr&   r   Úproject)Úls_rhZget_tracing_contextÚgetattrr   r4   r   r9   Zget_tracer_project)Ztracing_contextZrun_treer    r    r!   r3   ž   s    
öýr3   zplist[tuple[ContextVar[Optional[BaseCallbackHandler]], bool, Optional[type[BaseCallbackHandler]], Optional[str]]]Ú_configure_hookszContextVar[Optional[Any]]Úboolz#Optional[type[BaseCallbackHandler]]ÚNone)Úcontext_varÚinheritableÚhandle_classÚenv_varr   c                 C  s8   |dur|du rd}t |ƒ‚t td| ƒ|||f¡ dS )a   Register a configure hook.

    Args:
        context_var (ContextVar[Optional[Any]]): The context variable.
        inheritable (bool): Whether the context variable is inheritable.
        handle_class (Optional[Type[BaseCallbackHandler]], optional):
          The callback handler class. Defaults to None.
        env_var (Optional[str], optional): The environment variable. Defaults to None.

    Raises:
        ValueError: If env_var is set, handle_class must also be set
          to a non-None value.
    NzEIf env_var is set, handle_class must also be set to a non-None value.z)ContextVar[Optional[BaseCallbackHandler]])Ú
ValueErrorr>   Úappendr
   )rA   rB   rC   rD   r   r    r    r!   Úregister_configure_hook¿   s    úÿrG   F)rB   )r   )N)NNN)NN)1Ú__doc__Ú
__future__r   Ú
contextlibr   Zcontextvarsr   Útypingr   r   r   r   r	   r
   Úuuidr   Z	langsmithr   r<   r   r9   Z langchain_core.tracers.langchainr   Z$langchain_core.tracers.run_collectorr   Úcollections.abcr   r   ZLangSmithClientZlangchain_core.callbacks.baser   r   Z langchain_core.callbacks.managerr   r   Zlangchain_core.tracers.schemasr   r   Ú__annotations__r   r   r"   r,   r-   r8   r2   r3   r>   rG   r    r    r    r!   Ú<module>   s\    ÿÿ ÿ ÿû/   ýù
  ü#