Ë
    ñÏjêj ã                  óè  — U d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl	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mZmZ ddlmZ ddlmZmZmZmZmZmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z% ddl&m'Z'm(Z(m)Z)m*Z* ddl+m,c m-Z- ddl.m/Z0 dd	l.m1Z1m2Z2m3Z3 dd
l4m5Z5 ddl4m6Z7 ddl8m9Z: ddl;m<Z< ddl=m>Z> ddl?m@Z@ erddlAmBZB ddlCmDZD  e	jŠ                  eF«      ZGdZHdZIdgd„ZJdhd„ZKe-j˜                  e-jš                  e-jœ                  e-jž                  e-j                   e-j¢                  e-j¤                  e1j¦                  e1j¨                  dœ	ZUdeVd<   dZWdaXdeVd<   did„ZYej´                  	 	 	 	 djd„«       Z[dkd„Z\	 dl	 	 	 dmd„Z]ej´                  dddddddddd œ		 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 dnd!„«       Z^eYZ_dod"„Z`ddddddddddd#œ
	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 dpd$„Zadqd%„Zb G d&„ d'ed(¬)«      Zc e d*d+¬,«      Zd e'd-«      Zee% G d.„ d/eeeeedf   «      «       Zfdd0œ	 	 	 	 	 	 	 drd1„Zge$	 	 	 	 dsd2„«       Zhe$	 dtdddddddddddd(ddd3œ	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 dud4„«       Zh	 	 	 	 	 	 dvd5„Zh G d6„ d7«      Zidwd8„Zj	 	 dx	 	 	 	 	 	 	 dyd9„Zkdzd:„Zl	 dx	 	 	 	 	 d{d;„Zmd|d<„Znh d=£Zo G d>„ d?ed(¬)«      Zp G d@„ dAed(¬)«      Zq	 	 	 	 	 	 d}dB„Zr	 	 dx	 	 	 	 	 	 	 d~dC„ZsddD„Zt	 dl	 	 	 	 	 d€dE„Zu	 	 	 	 	 	 	 	 d�dF„Zv	 	 	 d‚	 	 	 	 	 	 	 	 	 	 	 dƒdG„Zw	 	 	 d‚	 	 	 	 	 	 	 	 	 d„dH„Zxd…dI„Zy	 	 	 	 	 	 	 	 d†dJ„Zz	 	 	 	 	 	 	 	 d†dK„Z{dld‡dL„Z|	 dl	 	 	 	 	 dˆdM„Z} ejü                  dN¬O«      d‰dP„«       Z e�j                   «       Z�dQeVdR<    e
�j                  «       Zƒ	 dl	 	 	 	 	 dˆdS„Z„dŠdT„Z…e…e„_†        	 dl	 	 	 	 	 dˆdU„Z‡ddVœ	 	 	 	 	 	 	 	 	 d‹dW„ZˆdldŒdX„Z‰	 dl	 	 	 	 	 	 	 	 	 	 	 	 	 d�dY„ZŠddZœ	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 dŽd[„Z‹ e d\«      ZŒ G d]„ d^eeŒ   «      Z� G d_„ d`e�eeŒ   «      ZŽ G da„ dbe�eeŒ   «      Z�d�dc„Z�d�dd„Z‘dhde„Z’d‘df„Z“e-jš                  ZMe-jž                  ZOe-j                   ZPe-j¢                  ZQe-j¤                  ZRe-j˜                  ZLy)’z1Decorator for creating a run tree from functions.é    )ÚannotationsN)ÚAsyncGeneratorÚAsyncIteratorÚ	AwaitableÚ	GeneratorÚIteratorÚMappingÚSequence)Úcopy_context)ÚTYPE_CHECKINGÚ	AnnotatedÚAnyÚCallableÚGenericÚLiteralÚOptionalÚProtocolÚ	TypedDictÚTypeVarÚUnionÚcastÚget_type_hintsÚoverloadÚruntime_checkable)Ú	ParamSpecÚ	TypeGuardÚget_argsÚ
get_origin©Úclient)Ú	run_treesÚschemasÚutils)Ú_addressing)Ú_aiter)Ú_aio_to_thread_override_active)ÚAgentAddress)Ú_runtime_env)ÚWriteReplica)ÚTracebackType)ÚRunnableÚls_errorzProcessing failed; c                ó|   — t        |«      j                  }|j                  «       r|dd nd}t        › | › d| › d|› d�S )aF  Build the marker that replaces a payload whose redactor raised.

    Carries the exception type, never its message: an exception routinely echoes
    the payload it was reading (``KeyError: 'secret'``), so the full text is
    logged locally and never uploaded. ``__name__`` is assignable, hence the
    identifier check.
    Né@   Úunknownz dropped (process_ú: Ú))ÚtypeÚ__name__ÚisidentifierÚ_PROCESSING_FAILED_PREFIX)ÚpayloadÚeÚkinds      úR/var/www/html/gaurav-v2/venv/lib/python3.12/site-packages/langsmith/run_helpers.pyÚ_processing_failedr:   C   sK   € ô �‹7×Ñ€DØ×)Ñ)Ô+ˆ4��‰9°€DÜ'Ð(¨¨	Ð1CÀGÀ9ÈBÈtÈfÐTUÐVÐVó    c                 óR   — t        j                  t        j                  d«      «      S )a?  Whether a failed redactor should fall back to tracing the raw payload.

    Set ``LANGSMITH_ALLOW_UNPROCESSED_PAYLOADS`` to restore the pre-fail-closed
    behavior in an emergency. It uploads data no redactor processed, so it is off
    by default and the caller logs a warning naming it whenever it takes effect.
    ÚALLOW_UNPROCESSED_PAYLOADS)r#   Ú	is_truishÚget_env_var© r;   r9   Ú_allow_unprocessed_payloadsrA   P   s   € ô �?‰?œ5×,Ñ,Ð-IÓJÓKÐKr;   )	Ú
parent_refÚproject_nameÚaddressÚtagsÚmetadataÚenabledr    ÚreplicasÚdistributed_parent_idz!dict[str, contextvars.ContextVar]Ú_CONTEXT_KEYSzlangsmith/run_helpers.pyúOptional[bool]Ú_OTEL_AVAILABLEc                 ó*   — t        j                  «       S )z¯Get the current run tree.

    Uses a weakref-based lookup to avoid memory leaks from captured contexts.
    The RunTree may return None if it has been garbage collected.
    )Ú_contextÚget_current_run_treer@   r;   r9   rO   rO   k   s   € ô ×(Ñ(Ó*Ð*r;   c              #  ó   K  — t         j                  j                  t        j                  | «      «      }	 d–— t         j                  j                  |«       y# t         j                  j                  |«       w xY w­w)aŽ  Set a RunTree as the active tracing parent within this block.

    Unlike `tracing_context`, this only sets the parent run tree and nothing
    else, making it safe to use in isolated threads where you want precise
    control over which run acts as the parent without inheriting or overwriting
    other context variables.

    Args:
        run_tree: The RunTree to use as the active parent.
    N)rN   Ú_PARENT_RUN_TREE_REFÚsetÚweakrefÚrefÚreset)Úrun_treeÚtokens     r9   Úset_tracing_parentrX   t   sW   è ø€ ô ×)Ñ)×-Ñ-¬g¯k©k¸(Ó.CÓD€Eð3Ûä×%Ñ%×+Ñ+¨EÕ2øŒ×%Ñ%×+Ñ+¨EÕ2üs   ‚3A>¶A º A>Á!A;Á;A>c                 ó~   — t        «       }|€t        j                  d«       y|j                  j	                  | «       y)z(Update metadata on the current run tree.NzFNo active run tree found. Call `set_run_metadata` inside a traced run.)rO   ÚLOGGERÚwarningrF   Úupdate)rF   rV   s     r9   Úset_run_metadatar]   ‰   s=   € ä#Ó%€HØÐÜ�‰ØTô	
ð
 ð 	×Ñ× Ñ  Ô*Ø
r;   c           
     óÄ  — | �€ t        j                  «       }|t         j                  j                  «       t         j                  j                  «       t         j
                  j                  «       t         j                  j                  «       t         j                  j                  «       t         j                  j                  «       t        j                  j                  «       t        j                  j                  «       dœ	S t        j                  «       D ��ci c]  \  }}|| j                  |«      “Œ }}}|j                  dd«      }|� |«       nd|d<   |S c c}}w )z Get the current tracing context.N©	ÚparentrC   rD   rE   rF   rG   r    rH   rI   rB   r`   )rN   rO   Ú_PROJECT_NAMEÚgetÚ_ADDRESSÚ_TAGSÚ	_METADATAÚ_TRACING_ENABLEDÚ_CLIENTr!   Ú	_REPLICASÚ_DISTRIBUTED_PARENT_IDrJ   ÚitemsÚpop)Úcontextr`   ÚkÚvÚresultrB   s         r9   Úget_tracing_contextrp   •   s  € ð �Ü×.Ñ.Ó0ˆàÜ$×2Ñ2×6Ñ6Ó8Ü×(Ñ(×,Ñ,Ó.Ü—N‘N×&Ñ&Ó(Ü ×*Ñ*×.Ñ.Ó0Ü×0Ñ0×4Ñ4Ó6Ü×&Ñ&×*Ñ*Ó,Ü!×+Ñ+×/Ñ/Ó1Ü%.×%EÑ%E×%IÑ%IÓ%Kñ

ð 
	
ô -:×,?Ñ,?Ô,AÔBÑ,A¡D A qˆa�—‘˜Q“ÑÐ,A€FÑBØ—‘˜L¨$Ó/€JØ'1Ð'=‘z”|À4€Fˆ8ÑØ€Mùó Cs   ÄE)	rC   rD   rE   rF   r`   rG   r    rH   rI   c        	      +  ó¤  K  — |	rt        j                  d|	› d�t        «       t        j                  |«      }t        j
                  |«      }t        «       }
| �||
j                  d«      k(  rd}t        j                  | |¬«       |dur!t        |xs |	j                  d«      |dœ«      nd}|}|€T|�Rt        t        |xs g «      t        |j                  xs g «      z  «      }i |j                  ¥|xs i ¥}|j                  }|�|n|
j                  d	«      }t        || |||||||d
œ	«       	 d–— t        |
«       y# t        |
«       w xY w­w)aí  Set the tracing context for a block of code.

    !!! warning "Experimental"
        `address` is in beta. It is enabled per workspace; a
        workspace without it rejects the runs, so tracing is lost rather than
        falling back to a project. It may change without notice.

    Args:
        project_name: The name of the project to log the run to.
        address: (beta) An `AgentAddress`, such as `ls.AgentAddress(id, environment)`, to log the
            run to instead of a project. Cannot be combined with a project in
            the same call. Defaults to the `LANGSMITH_AGENT_*` env vars.
        tags: The tags to add to the run.
        metadata: The metadata to add to the run.
        parent: The parent run to use for the context.

            Can be a Run/`RunTree` object, request headers (for distributed tracing),
            or the dotted order string.
        client: The client to use for logging the run to LangSmith.
        enabled: Whether tracing is enabled.

            Defaults to `None`, meaning it will use the current context value or environment variables.
        replicas: A sequence of `WriteReplica` dictionaries or addresses
            to send runs to.

            Example: `[{"api_url": "https://api.example.com", "auth": {"api_key": "key"}, "project_name": "proj"}]`
            or `[{"project_name": "my_experiment", "updates": {"reference_example_id": None}}]`
        distributed_parent_id: The distributed parent ID for distributed tracing. Defaults to None.
    z Unrecognized keyword arguments: Ú.NrD   ©ÚprojectrD   FÚ
parent_run)r`   rH   rG   r_   )ÚwarningsÚwarnÚDeprecationWarningr$   Úcheck_addressÚnormalize_replicasrp   rb   Úreject_conflictingÚ_get_parent_runÚsortedrR   rE   rF   ÚidÚ_set_tracing_context)rC   rD   rE   rF   r`   rG   r    rH   rI   ÚkwargsÚcurrent_contextru   Údistributed_parent_id_to_uses                r9   Útracing_contextrƒ   ­   sg  è ø€ ñV ä�‰Ø.¨v¨h°aÐ8Üô	
ô ×'Ñ'¨Ó0€GÜ×-Ñ-¨hÓ7€HÜ)Ó+€OØÐ G¨×/BÑ/BÀ9Ó/MÒ$Mð ˆÜ×"Ñ"¨<ÀÕIð
 ˜Ñô 	ØÒ9 §¡¨LÓ!9ÀxÑPô	
ð ð ð $9Ð Ø#Ð+°
Ð0Fä”c˜$š* "“o¬¨J¯O©OÒ,A¸rÓ(BÑBÓCˆØ>�j×)Ñ)Ð>¨hªn¸"Ð>ˆØ'1§}¡}Ð$Ø Ð,‰g°/×2EÑ2EÀiÓ2P€GÜà Ø(ØØØ ØØØ Ø%Añ
	
ôð.Ûä˜_Õ-øÔ˜_Õ-üs   ‚D-EÄ0E  Ä4EÅ EÅEc                óÈ   — t        | «      xsV t        | t        j                  «      xr t        | j                  «      xs# t        | d«      xr t        | j                  «      S )z.Check if a function is `@traceable` decorated.Ú__call__)Ú_is_traceable_functionÚ
isinstanceÚ	functoolsÚpartialÚfuncÚhasattrr…   ©rŠ   s    r9   Úis_traceable_functionr�     sU   € ô 	˜tÓ$ò 	QÜ�tœY×.Ñ.Ó/ÒUÔ4JÈ4Ï9É9Ó4Uò	Qä�D˜*Ó%ÒOÔ*@ÀÇÁÓ*Oðr;   ©
ÚnamerF   rE   r    Ú	reduce_fnrC   rD   Úprocess_inputsÚprocess_outputsÚprocess_chunkc       
        óR   — t        | «      r| S  t        |||||||||	|
¬«
      | «      S )z$Ensure that a function is traceable.rŽ   )r�   Ú	traceable)rŠ   r�   rF   rE   r    r�   rC   rD   r‘   r’   r“   s              r9   Úensure_traceabler–     sJ   € ô ˜TÔ"ØˆðŒ9ØØØØØØ!ØØ%Ø'Ø#ôð óð r;   c                óŠ   — t        j                  | «      xs- t        | d«      xr t        j                  | j                  «      S )z;Inspect function or wrapped function to see if it is async.Ú__wrapped__)ÚinspectÚiscoroutinefunctionr‹   r˜   rŒ   s    r9   Úis_asyncr›   6  s:   € ä×&Ñ& tÓ,ò Ü��mÓ$ÒV¬×)DÑ)DÀT×EUÑEUÓ)Vðr;   c                  ó¶   — e Zd ZU dZded<   	 ded<   	 ded<   	 ded	<   	 d
ed<   	 ded<   	 ded<   	 ded<   	 ded<   	 ded<   	 ded<   	 ded<   	 ded<   ded<   y)ÚLangSmithExtraz<Any additional info to be injected into the run dynamically.úOptional[str]r�   úOptional[ls_client.ID_TYPE]Úreference_example_idúOptional[dict]Ú	run_extraz0Optional[Union[run_trees.RunTree, str, Mapping]]r`   úOptional[run_trees.RunTree]rV   rC   úOptional[AgentAddress]rD   úOptional[dict[str, Any]]rF   úOptional[list[str]]rE   Úrun_idúOptional[ls_client.Client]r    ú,Optional[Sequence[Union[WriteReplica, str]]]rH   z-Optional[Callable[[run_trees.RunTree], None]]Ú_on_successú,Optional[Callable[[run_trees.RunTree], Any]]Úon_endN©r3   Ú
__module__Ú__qualname__Ú__doc__Ú__annotations__r@   r;   r9   r�   r�   =  s€   … ÙFà
ÓØ$Ø5Ó5Ø-ØÓØ.Ø<Ó<ØDØ)Ó)Ø)ØÓØ'Ø#Ó#ØKØ&Ó&Ø(Ø
ÓØ,Ø'Ó'Ø"Ø&Ó&Ø$Ø:Ó:ØQà>Ó>Ø8Ó8ØQr;   r�   F)ÚtotalÚRT)Ú	covariantÚPc                  ó,   — e Zd ZdZddœ	 	 	 	 	 	 	 dd„Zy)ÚSupportsLangsmithExtrazNImplementations of this Protocol accept an optional langsmith_extra parameter.N©Úlangsmith_extrac                ó   — y)aj  Call the instance when it is called as a function.

        Args:
            *args: Variable length argument list.
            langsmith_extra: Optional dictionary containing additional
                parameters specific to Langsmith.
            **kwargs: Arbitrary keyword arguments.

        Returns:
            R: The return value of the method.

        Nr@   )Úselfr¹   Úargsr€   s       r9   r…   zSupportsLangsmithExtra.__call__f  s   € ð$ 	r;   )r¼   zP.argsr¹   úOptional[LangSmithExtra]r€   zP.kwargsÚreturnr³   )r3   r®   r¯   r°   r…   r@   r;   r9   r·   r·   b  s5   „ áXð
 59ñàðð 2ðð ð	ð
 
ôr;   r·   ©Úoutputsc                ór   — | j                   xs i j                  d«      }|xs i j                  d«      xs |S )NÚusage_metadata)rF   rb   )rV   rÀ   r€   Úfrom_metadatas       r9   Ú_extract_usagerÄ   {  s;   € ð ×&Ñ&Ò,¨"×1Ñ1Ð2BÓC€MØŠM�r×ÑÐ/Ó0ÒA°MÐAr;   c                 ó   — y ©Nr@   rŒ   s    r9   r•   r•   …  s   € ð $'r;   )r�   rF   rE   r    r�   rC   rD   r‘   r’   r“   Ú_invocation_params_fnÚdangerously_allow_filesystemrG   Úexceptions_to_handlec                ó   — y rÆ   r@   )Úrun_typer�   rF   rE   r    r�   rC   rD   r‘   r’   r“   rÇ   rÈ   rG   rÉ   s                  r9   r•   r•   ‹  s	   € ð$ @Cr;   c                 ó  ‡‡‡‡‡‡— t        t        j                  | rt        | d   t        «      r| d   n|j                  dd«      xs d«      Š‰t        vr#t        j                  d‰› dt        › d‰› d�«       t        | «      d	kD  rt        j                  d
«       d|v rt        j                  dt        «       |j                  dd«      Š|j                  dd«      Št        |j                  dd«      |j                  dd«      |j                  dd«      |j                  dd«      |j                  dd«      |j                  dd«      t        j                  |j                  dd«      «      ‰|j                  dd«      |j                  dd«      |j                  dd«      |j                  dd«      ‰|j                  dd«      ¬«      Št        j                  ‰d   ‰d   ¬«       |j                  dd«      Št        j                   t"        ‰¬«      Š|r5t        j                  dt%        |j'                  «       «      › d �t        «       d"ˆˆˆˆˆˆfd!„}t        | «      d	k(  rt)        | d   «      r|s || d   «      S |S )#að  Trace a function with langsmith.

    !!! warning "Experimental"
        `address` is in beta. It is enabled per workspace; a
        workspace without it rejects the runs, so tracing is lost rather than
        falling back to a project. It may change without notice.

    Args:
        run_type: The type of run (span) to create.

            Examples: `llm`, `chain`, `tool`, `prompt`, `retriever`, etc.

            Defaults to "chain".
        name: The name of the run. Defaults to the function name.
        metadata: The metadata to add to the run. Defaults to `None`.
        tags: The tags to add to the run. Defaults to `None`.
        client: The client to use for logging the run to LangSmith. Defaults to
            `None`, which will use the default client.
        reduce_fn: A function to reduce the output of the function if the function
            returns a generator.

            Defaults to `None`, which means the values will be logged as a list.

            !!! note

                If the iterator is never exhausted (e.g. the function returns an
                infinite generator), this will never be called, and the run itself will
                be stuck in a pending state.
        project_name: The name of the project to log the run to.

            Defaults to `None`, which will use the default project.
        address: (beta) An `AgentAddress`, such as `ls.AgentAddress(id, environment)`, to log the
            run to instead of a project. Cannot be combined with a project in
            the same call. Defaults to the `LANGSMITH_AGENT_*` env vars.
        process_inputs: Custom serialization / processing function for inputs.

            Defaults to `None`.
        process_outputs: Custom serialization / processing function for outputs.

            Defaults to `None`.
        dangerously_allow_filesystem: Whether to allow filesystem access for attachments.

            Defaults to `False`.

            Traces that reference local filepaths will be uploaded to LangSmith.
            In general, network-hosted applications should not be using this because
            referenced files are usually on the user's machine, not the host machine.
        enabled: Whether tracing is enabled for this function.

            Defaults to `None`, which will use the default value from the current context.
        exceptions_to_handle: Exception types to ignore when logging errors.

            If an exception of one of these types is raised, the run will still be recorded
            but the error field will be `None` instead of containing the full traceback.

            Defaults to `None`.

    Returns:
        The decorated function.

    !!! note

        Requires that `LANGSMITH_TRACING_V2` be set to 'true' in the environment.

    Examples:
        !!! example "Basic usage"

            ```python
            @traceable
            def my_function(x: float, y: float) -> float:
                return x + y


            my_function(5, 6)


            @traceable
            async def my_async_function(query_params: dict) -> dict:
                async with httpx.AsyncClient() as http_client:
                    response = await http_client.get(
                        "https://api.example.com/data",
                        params=query_params,
                    )
                    return response.json()


            asyncio.run(my_async_function({"param": "value"}))
            ```

        !!! example "Streaming data with a generator"

            ```python
            @traceable
            def my_generator(n: int) -> Iterable:
                for i in range(n):
                    yield i


            for item in my_generator(5):
                print(item)
            ```

        !!! example "Async streaming data"

            ```python
            @traceable
            async def my_async_generator(query_params: dict) -> Iterable:
                async with httpx.AsyncClient() as http_client:
                    response = await http_client.get(
                        "https://api.example.com/data",
                        params=query_params,
                    )
                    for item in response.json():
                        yield item


            async def async_code():
                async for item in my_async_generator({"param": "value"}):
                    print(item)


            asyncio.run(async_code())
            ```

        !!! example "Specifying a run type and name"

            ```python
            @traceable(name="CustomName", run_type="tool")
            def another_function(a: float, b: float) -> float:
                return a * b


            another_function(5, 6)
            ```

        !!! example "Logging with custom metadata and tags"

            ```python
            @traceable(
                metadata={"version": "1.0", "author": "John Doe"}, tags=["beta", "test"]
            )
            def tagged_function(x):
                return x**2


            tagged_function(5)
            ```

        !!! example "Specifying a custom client and project name"

            ```python
            custom_client = Client(api_key="your_api_key")


            @traceable(client=custom_client, project_name="My Special Project")
            def project_specific_function(data):
                return data


            project_specific_function({"data": "to process"})
            ```

        !!! example "Manually passing `langsmith_extra`"

            ```python
            @traceable
            def manual_extra_function(x):
                return x**2


            manual_extra_function(5, langsmith_extra={"metadata": {"version": "1.0"}})
            ```

        !!! example "Handling specific exceptions"

            ```python
            @traceable(exceptions_to_handle=(ValueError, TypeError))
            def function_with_handled_exceptions(x):
                if x < 0:
                    raise ValueError("Negative value")  # Won't send error in the trace
                return x**2


            function_with_handled_exceptions(-5)
            ```
    r   rË   NÚchainzUnrecognized run_type: z. Must be one of: z . Did you mean @traceable(name='z')?é   zšThe `traceable()` decorator only accepts one positional argument, which should be the run_type. All other arguments should be passed as keyword arguments.ÚextrazJThe `extra` keyword argument is deprecated. Please use `metadata` instead.r�   rG   r�   rF   rE   r    rC   rD   r‘   r“   rÇ   rÈ   FrÉ   )Úextra_outerr�   rF   rE   r    rC   rD   rË   r‘   r“   Úinvocation_params_fnrÈ   rG   rÉ   rs   r’   )Úoutputs_processorzHThe following keyword arguments are not recognized and will be ignored: rr   c                ól  •‡ ‡
‡— t        j                  ‰ «      }|j                  j                  dd «      d uŠ|j                  j                  dd «      d uŠ
t	        j
                  ‰ «      d dœ	 	 	 	 	 	 	 dˆˆˆ ˆ
ˆfd„«       }t	        j
                  ‰ «      d dœ	 	 	 	 	 	 	 dˆˆˆ ˆ
ˆˆfd„«       }t	        j
                  ‰ «      d dœ	 	 	 	 	 	 	 dˆˆˆ ˆ
fd„«       }t	        j
                  ‰ «      d dœ	 	 	 	 	 	 	 dˆˆˆ ˆ
ˆˆfd„«       }t	        j
                  ‰ «      d dœ	 	 	 	 	 	 	 dˆˆˆ ˆ
ˆˆfd„«       }t	        j
                  ‰ «      d dœ	 	 	 	 	 	 	 dˆˆˆ ˆ
ˆˆfd	„«       }t        j                  ‰ «      r|}n2t        j                  ‰ «      r|}nt        ‰ «      r‰r|}n
|}n‰r|}n|}t        |d
d«       t        |d‰j                  d«      ‰‰‰j                  d«      ‰j                  d«      ‰ dœ«       t        j                  |«      }	|	j                  j                  d«      s‹|	j                  g d„ |	j                  j                  «       D «       ¢t        j                  dt         j                  j                  d ¬«      ‘d„ |	j                  j                  «       D «       ¢¬«      }	|	|_        |S )NrV   Úconfigr¸   c           	   Ÿ  óÜ  •‡‡‡
K  — ‰s‰j                  dd«       t        j                  t        «       t        ‰‰| ‰‰¬«      ƒ d{  –—† }	 t        j
                  «       }‰r|d   ‰d<   t        |d   «      Š
|xr t        «        }‰
rbˆˆˆˆ
fd„}|r(t        j                   |«       |d   ¬«      ƒ d{  –—† }n‡t        di t        |d   «      ¤Ž5   |«       ƒ d{  –—† }ddd«       nW ‰‰i ‰¤Ž}|r#t        j                  ||d   ¬«      ƒ d{  –—† }n*t        di t        |d   «      ¤Ž5  |ƒ d{  –—† }ddd«       t        j                  t        «       ‰|¬
«      ƒ d{  –—†  |S 7 �Œ'7 Œº7 Œ”# 1 sw Y   Œ;xY w7 Œm7 ŒL# 1 sw Y   ŒKxY w# t        $ rN}	t        |	«       t        j                  t        j                  t        «       ‰||	¬	«      «      ƒ d{  –—†7   ‚ d}	~	ww xY w7 Œƒ­w)z"Async version of wrapper function.rÔ   N©Úcontainer_inputr¹   r¼   r€   Únew_runrV   c               “  ó`   •K  — ‰5   ‰‰ i ‰¤Žƒ d {  –—† cd d d «       S 7 Œ# 1 sw Y   y xY w­wrÆ   r@   ©r¼   rŠ   r€   Úotel_context_managers   €€€€r9   Úrun_with_otel_contextzRtraceable.<locals>.decorator.<locals>.async_wrapper.<locals>.run_with_otel_context½  s.   øè ø€ Ú1Ù)-¨tÐ)>°vÑ)>×#>÷ 2Ñ1Ø#>ø÷ 2Ð1üs    ƒ.†"’ “"–
. "¢+§.rl   ©rl   ©Úerrorr¿   r@   )rk   Ú
aitertoolsÚaio_to_threadr   Ú
_setup_runÚasyncio_accepts_contextÚ_maybe_create_otel_contextÚ_runtime_override_activeÚasyncioÚcreate_taskrƒ   rp   ÚBaseExceptionÚ_cleanup_tracebackÚshield)r¹   r¼   r€   Úrun_containerÚaccepts_contextÚuse_ctx_taskrÜ   Úfunction_resultÚfr_coror7   rÛ   Ú_on_run_endr×   rŠ   Úfunc_accepts_configÚfunc_accepts_parent_runs    ``       @€€€€€r9   Úasync_wrapperz3traceable.<locals>.decorator.<locals>.async_wrapperŸ  s  ûè ø€ ñ 'Ø—
‘
˜8 TÔ*Ü",×":Ñ":Ü“ÜØØ /Ø /ØØô#÷ ˆMð+Ü",×"DÑ"DÓ"F�Ù*Ø)6°yÑ)A�F˜:Ñ&ä'AØ! )Ñ,ó(Ð$ð  /ÒQÔ7OÓ7QÐ3Q�Ù'÷?ñ $Ü07×0CÑ0CÙ1Ó3¸]È9Ñ=Uô1÷ +™ô -ñ Ü1°-À	Ñ2JÓKóñ 5JÓ4K×.K˜O÷ð ñ
 # DÐ3¨FÑ3�GÙ#Ü07×0CÑ0CØ#¨]¸9Ñ-Eô1÷ +™ô -ñ Ü1°-À	Ñ2JÓKóð 5<¯m˜O÷ô ×*Ñ*Ü“ ¨]ÀOô÷ ð ð #Ð"ðsùð4+øð /Lø÷ð úð+øð /<ø÷ð ûô !ò ä" 1Ô%Ü—n‘nÜ×,Ñ,Ü$›¨°]È!ôó÷ ñ ð
 ûðúðúsÂ   †A G,ÁE-ÁG,ÁA)F Â5E0Â6F ÃE4ÃE2ÃE4Ã"0F ÄF ÄF Ä/FÄ5FÄ6FÄ:F Å$G,Å&G*Å'G,Å0F Å2E4Å4E=Å9F ÆFÆFÆ	F Æ	G'ÆAG"ÇGÇG"Ç"G'Ç'G,c               óÖ  •K  — ‰s|j                  dd «       t        j                  t        «       t        ‰‰| ||¬«      ƒ d {  –—† }g }	 ‰r|d   |d<   t        |d   «      } ‰|i |¤Ž}t        j                  «       }|xr t        «        }t        j                  |«      rO|r#t        j                  ||d   ¬«      ƒ d {  –—† }n*t        di t        |d   «      ¤Ž5  |ƒ d {  –—† }d d d «       t        |||d   r|d   j                  dk(  nd||‰j!                  d	«      |¬
«      2 3 d {  –—† }	|	­–— Œ7 Œõ7 Œx7 ŒW# 1 sw Y   ŒVxY w7 Œ6 ne# t"        $ rY}
t%        |
«       t        j&                  t        j                  t        «       ‰||
t)        |‰«      ¬«      «      ƒ d {  –—†7   ‚ d }
~
ww xY wt        j                  t        «       ‰|t)        |‰«      ¬«      ƒ d {  –—†7   y ­w)NrÔ   rÖ   rØ   rV   rl   rÝ   ÚllmFr“   )Ú	generatorrë   Ú
is_llm_runrì   Úresultsr“   rÛ   ©rß   rÀ   r¿   r@   )rk   rà   rá   r   râ   rä   rã   rå   r™   Úiscoroutineræ   rç   rƒ   rp   Ú_process_async_iteratorrË   rb   rè   ré   rê   Ú_get_function_result)r¹   r¼   r€   rë   rø   rÛ   Úasync_gen_resultrì   rí   Úitemr7   rð   r×   rŠ   rñ   rò   r�   s              €€€€€€r9   Úasync_generator_wrapperz=traceable.<locals>.decorator.<locals>.async_generator_wrapperã  s  øè ø€ ñ 'Ø—
‘
˜8 TÔ*Ü",×":Ñ":Ü“ÜØØ /Ø /ØØô#÷ ˆMð "$ˆGð3Ù*Ø)6°yÑ)A�F˜:Ñ&ô
 (BØ! )Ñ,ó(Ð$ñ $(¨Ð#8°Ñ#8Ð ä",×"DÑ"DÓ"F�Ø.ÒQÔ7OÓ7QÐ3Q�Ü×&Ñ&Ð'7Ô8Ù#Ü18×1DÑ1DØ,°mÀIÑ6Nô2÷ ,Ñ(ô -ñ Ü1°-À	Ñ2JÓKóð 6F×/EÐ,÷ô
 #:Ø.Ø"/ð )¨Ò3ð & iÑ0×9Ñ9¸UÒBà"à$0Ø#Ø"1×"5Ñ"5°oÓ"FØ)=õ#÷ ˜$ð ”Jðcøð6,øð 0Fø÷ð úð
øñ #øô !ò Ü" 1Ô%Ü—n‘nÜ×,Ñ,Ü$›Ø#Ø%ØÜ 4°W¸iÓ Hôó÷ ñ ð ûðúô ×*Ñ*Ü“ØØÜ,¨W°iÓ@ô	÷ ò ùs·   ƒA G)ÁD9ÁG)ÁA7E ÃD;ÃE ÃD?Ã%D=Ã&D?Ã*A E Ä*EÄ.EÄ/EÄ2E Ä9G)Ä;E Ä=D?Ä?EÅE ÅEÅE ÅG)Å	F1ÅAF,Æ%F(Æ&F,Æ,F1Æ11G)Ç"G%Ç#G)c                ó¼  •‡‡‡— ‰s‰j                  dd«       t        ‰‰
| ‰‰¬«      }t        j                  ‰«      j                  j                  dd«      du}	 |r|d   ‰d<   t        |d   «      Š‰rˆˆˆˆfd„}|d   j                  |«      }n |d   j                  ‰g‰¢­i ‰¤Ž} ‰	||¬	«       |S # t        $ r}t        |«        ‰	||¬«       ‚ d}~ww xY w)
ú>Create a new run or create_child() if run is passed in kwargs.rÔ   NrÖ   rV   rØ   c                 óD   •— ‰5   ‰‰ i ‰¤Žcd d d «       S # 1 sw Y   y xY wrÆ   r@   rÚ   s   €€€€r9   rÜ   zLtraceable.<locals>.decorator.<locals>.wrapper.<locals>.run_with_otel_contextJ  s   ø€ Ú1Ù#'¨Ð#8°Ñ#8÷ 2×1Ò1ús   „–rl   rÞ   r¿   )
rk   râ   r™   Ú	signatureÚ
parametersrb   rä   Úrunrè   ré   )r¹   r¼   r€   rë   rò   rÜ   rî   r7   rÛ   rð   r×   rŠ   rñ   s    ``     @€€€€r9   Úwrapperz-traceable.<locals>.decorator.<locals>.wrapper.  s  û€ ñ 'Ø—
‘
˜8 TÔ*Ü&ØØ /Ø /ØØôˆMô ×!Ñ! $Ó'×2Ñ2×6Ñ6°zÀ4ÓHÐPTÐTð $ðÙ*Ø)6°yÑ)A�F˜:Ñ&ä'AØ! )Ñ,ó(Ð$ñ (÷9ð '4°IÑ&>×&BÑ&BØ-ó'‘Oð 'C m°IÑ&>×&BÑ&BØð'Ø#ò'Ø'-ñ'�Oñ ˜¨Õ?Ø"Ð"øô !ò Ü" 1Ô%Ù˜M°Õ3Øûðús   ÁAB7 Â7	CÃ CÃCc           	   ?  ó2  •K  — ‰s|j                  dd «       t        ‰‰| ||¬«      }t        j                  ‰«      j                  j                  dd «      d u}g }d }	 |r|d   |d<    |d   j                  ‰g|¢­i |¤Ž}t        |d   «      }t        ||‰dk(  |‰j                  d«      |¬«      E d {  –—† }|�|j                  |«        ‰
|t        |‰«      ¬
«       |S 7 Œ-# t        $ r&}	t        |	«        ‰
||	t        |‰«      ¬	«       ‚ d }	~	ww xY w­w)NrÔ   rÖ   rV   rØ   rl   rõ   r“   )r÷   rø   r“   rÛ   rù   r¿   )rk   râ   r™   r  r  rb   r  rä   Ú_process_iteratorÚappendrè   ré   rü   )r¹   r¼   r€   rë   rò   rø   Úfunction_returnÚgenerator_resultrÛ   r7   rð   r×   rŠ   rñ   r�   rË   s             €€€€€€r9   Úgenerator_wrapperz7traceable.<locals>.decorator.<locals>.generator_wrapper\  sU  øè ø€ ñ 'Ø—
‘
˜8 TÔ*Ü&ØØ /Ø /ØØôˆMô ×!Ñ! $Ó'×2Ñ2×6Ñ6°zÀ4ÓHÐPTÐTð $ð "$ˆGØ#'ˆOðÙ*Ø)6°yÑ)A�F˜:Ñ&à#? =°Ñ#;×#?Ñ#?ÀÐ#VÀtÒ#VÈvÑ#VÐ ä'AØ! )Ñ,ó(Ð$ô .?Ø$Ø!Ø'¨5Ñ0Ø#Ø"1×"5Ñ"5°oÓ"FØ)=ô.÷ #�ð #Ð.Ø—N‘N ?Ô3ñ ˜Ô/CÀGÈYÓ/WÕXà"Ð"ð-#ùô !ò Ü" 1Ô%ÙØ!ØÜ0°¸)ÓDõð
 ûðüs=   ƒADÁAC% Â5C#Â6C% ÃDÃ#C% Ã%	DÃ.!DÄDÄDc                ó^  •— ‰	s|j                  dd «       t        ‰‰| ||¬«      }	 ‰
r|d   |d<    |d   j                  ‰g|¢­i |¤Ž}t        |d«      rt        ||‰«      S t        |d«      rt        ||‰«      S  ‰||¬	«       |S # t        $ r}t	        |«        ‰||¬«       ‚ d }~ww xY w)
NrÔ   rÖ   rØ   rV   rl   rÞ   Ú__iter__Ú	__aiter__r¿   )rk   râ   r  Ú	Exceptionré   r‹   Ú_TracedStreamÚ_TracedAsyncStream©r¹   r¼   r€   Útrace_containerÚstreamr7   rð   r×   rŠ   rñ   rò   r�   s         €€€€€€r9   Ústream_wrapperz4traceable.<locals>.decorator.<locals>.stream_wrapper”  sÓ   ø€ ñ 'Ø—
‘
˜8 TÔ*Ü(ØØ /Ø /ØØôˆOðÙ*Ø)8¸Ñ)C�F˜:Ñ&Ø7˜¨Ñ3×7Ñ7¸ÐN¸tÒNÀvÑN�ô �v˜zÔ*Ü$ V¨_¸iÓHÐHÜ˜ Ô-ä)¨&°/À9ÓMÐMñ ˜°Õ8ØˆMøô ò Ü" 1Ô%Ù˜O°1Õ5Øûðús   §#B Â	B,ÂB'Â'B,c           	   Ÿ  ó  •K  — ‰	s|j                  dd «       t        j                  t        «       t        ‰‰| ||¬«      ƒ d {  –—† }	 ‰
r|d   |d<    ‰|i |¤Žƒ d {  –—† }t        |d«      rt        ||‰«      S t        |d«      rt        ||‰«      S t        j                  t        «       ‰||¬«      ƒ d {  –—†  |S 7 Œ|7 Œc# t
        $ r0}t        j                  t        «       ‰||¬«      ƒ d {  –—†7   ‚ d }~ww xY w7 ŒF­w)	NrÔ   rÖ   rØ   rV   rÞ   r  r  r¿   )	rk   rà   rá   r   râ   r  r‹   r  r  r  s         €€€€€€r9   Úasync_stream_wrapperz:traceable.<locals>.decorator.<locals>.async_stream_wrapperµ  s  øè ø€ ñ 'Ø—
‘
˜8 TÔ*Ü$.×$<Ñ$<Ü“ÜØØ /Ø /ØØô%÷ ˆOðÙ*Ø)8¸Ñ)C�F˜:Ñ&Ù# TÐ4¨VÑ4×4�ô �v˜{Ô+Ü)¨&°/À9ÓMÐMÜ˜ Ô,ä$ V¨_¸iÓHÐHô ×*Ñ*Ü“ ¨_Àfô÷ ð ð ˆMð=øð 5ùÜò Ü ×.Ñ.Ü “N K°Èô÷ ñ ð ûð	úðúsa   ƒA DÁC ÁDÁ	C ÁCÁC Á#ADÂ9D Â:DÃC Ã	C=Ã$C8Ã1C4Ã2C8Ã8C=Ã=DÚ__langsmith_traceable__TÚ__traceable_config__r‘   rE   rF   )r‘   r’   rG   rE   rF   Úwrappedc              3  ón   K  — | ]-  }|j                   t        j                  j                  k7  r|–— Œ/ y ­wrÆ   ©r8   r™   Ú	ParameterÚVAR_KEYWORD©Ú.0Úparams     r9   Ú	<genexpr>z/traceable.<locals>.decorator.<locals>.<genexpr>ú  ó0   è ø€ ð á%<˜EØ Ÿ:™:¬×):Ñ):×)FÑ)FÒFô Ù%<ùó   ‚35)Údefaultc              3  ón   K  — | ]-  }|j                   t        j                  j                  k(  r|–— Œ/ y ­wrÆ   r  r   s     r9   r#  z/traceable.<locals>.decorator.<locals>.<genexpr>  r$  r%  )r  )r¼   r   r¹   r½   r€   r   r¾   r   )r¼   r   r¹   r½   r€   r   r¾   r   )r™   r  r  rb   rˆ   ÚwrapsÚisasyncgenfunctionÚisgeneratorfunctionr›   ÚsetattrÚreplaceÚvaluesr  ÚKEYWORD_ONLYÚ__signature__)rŠ   Úfunc_sigró   rÿ   r  r  r  r  Úselected_wrapperÚsigrñ   rò   rð   r×   rG   rÒ   r�   rË   s   `         @@€€€€€€r9   Ú	decoratorztraceable.<locals>.decoratorš  s_  û€ Ü×$Ñ$ TÓ*ˆØ"*×"5Ñ"5×"9Ñ"9¸*ÀdÓ"KÐSWÐ"WÐØ&×1Ñ1×5Ñ5°hÀÓEÈTÐQÐä	�‰˜Ó	ð 9=ñA	#ØðA	#à5ðA	#ð ðA	#ð ÷	A	#ð A	#ó 
ðA	#ôF 
�‰˜Ó	àDHñH	ØðH	Ø)AðH	ØTWðH	à÷H	ñ H	ó 
ðH	ôT 
�‰˜Ó	ð 9=ñ+	#Øð+	#à5ð+	#ð ð+	#ð ÷	+	#ó 
ð+	#ôZ 
�‰˜Ó	àDHñ2	#Øð2	#Ø)Að2	#ØTWð2	#à÷2	#ñ 2	#ó 
ð2	#ôn 
�‰˜Ó	àDHñ	Øð	Ø)Að	ØTWð	à÷	ñ 	ó 
ð	ô@ 
�‰˜Ó	àDHñ#	Øð#	Ø)Að#	ØTWð#	à÷#	ñ #	ó 
ð#	ôJ ×%Ñ% dÔ+Ø)@ÑÜ×(Ñ(¨Ô.Ø0ÑÜ�dŒ^ÙØ#7Ñ à#0Ñ áØ#1Ñ à#*Ð ÜÐ Ð";¸TÔBÜØØ"à"1×"5Ñ"5Ð6FÓ"GØ#4Ø"Ø'×+Ñ+¨FÓ3Ø+×/Ñ/°
Ó;Øñô	
ô ×ÑÐ 0Ó1ˆØ�~‰~×!Ñ! (Ô+Ø—+‘+ðñà%(§^¡^×%:Ñ%:Ô%<óðô ×%Ñ%Ø ¤'×"3Ñ"3×"@Ñ"@È$ôðñà%(§^¡^×%:Ñ%:Ô%<óðð ó ˆCð" .1ÐÔ*ØÐr;   )rŠ   r   )r   Ú	ls_clientÚ
RUN_TYPE_Tr‡   Ústrrk   Ú_VALID_RUN_TYPESrv   rw   Úlenrx   Ú_ContainerInputr$   ry   r{   rˆ   r‰   Ú_handle_container_endr}   ÚkeysÚcallable)	r¼   r€   r3  rð   r×   rG   rÒ   r�   rË   s	      @@@@@@r9   r•   r•      sZ  ý€ ô| Ü×Ññ œ
 4¨¡7¬CÔ0ð �ŠGà—*‘*˜Z¨Ó.Ò9°'ó€Hð Ô'Ñ'Ü�‰Ø% h ZÐ/AÔBRÐASð T.Ø.6¨Z°sð<ô	
ô ˆ4ƒy�1‚}Ü�‰ð$ô	
ð
 �&ÑÜ�‰ðäô	
ð
 —
‘
˜;¨Ó-€IØ�j‰j˜ DÓ)€GÜ%à—J‘J˜w¨Ó-Ø�Z‰Z˜ Ó%Ø—‘˜J¨Ó-Ø�Z‰Z˜ Ó%Ø�z‰z˜( DÓ)Ø—Z‘Z °Ó5Ü×)Ñ)¨&¯*©*°YÀÓ*EÓFØØ—z‘zÐ"2°DÓ9Ø—j‘j °$Ó7Ø#ŸZ™ZÐ(?ÀÓFØ%+§Z¡ZÐ0NÐPUÓ%VØØ#ŸZ™ZÐ(>ÀÓEô€Oô" ×"Ñ"Ø Ñ/¸ÈÑ9Sõð Ÿ
™
Ð#4°dÓ;ÐÜ×#Ñ#ÜØ+ô€Kñ
 Ü�‰ØVÜ�f—k‘k“mÓ$Ð% Qð(äô	
÷p ò p ôh ˆ4ƒy�A‚~œ( 4¨¡7Ô+±FÙ˜˜a™Ó!Ð!àÐr;   c                  óÞ   — e Zd ZdZ	 ddddddddddddddœ	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 dd„Zdd„Z	 	 	 	 	 	 	 	 dd„Zdd„Z	 	 	 d	 	 	 	 	 	 	 dd„Zdd	„Z		 	 	 d	 	 	 	 	 	 	 dd
„Z
y)Útraceaû	  Manage a LangSmith run in context.

    This class can be used as both a synchronous and asynchronous context manager.

    !!! warning "Experimental"
        `address` is in beta. It is enabled per workspace; a
        workspace without it rejects the runs, so tracing is lost rather than
        falling back to a project. It may change without notice.

    Args:
        name: Name of the run.
        run_type: Type of run (e.g., `'chain'`, `'llm'`, `'tool'`).
        inputs: Initial input data for the run.
        project_name: Project name to associate the run with.
        address: (beta) An `AgentAddress`, such as `ls.AgentAddress(id, environment)`, to log the
            run to instead of a project. Cannot be combined with a project in
            the same call. Defaults to the `LANGSMITH_AGENT_*` env vars.
        parent: Parent run.

            Can be a `RunTree`, dotted order string, or tracing headers.
        tags: List of tags for the run.
        metadata: Additional metadata for the run.
        client: LangSmith client for custom settings.
        run_id: Preset identifier for the run.
        reference_example_id: Associates run with a dataset example.

            Only for root runs in evaluation.
        exceptions_to_handle: Exception types to ignore.
        extra: Extra data to send to LangSmith.

            Use 'metadata' instead.

    Examples:
        Synchronous usage:

        ```python
        with trace("My Operation", run_type="tool", tags=["important"]) as run:
            result = "foo"  # Perform operation
            run.metadata["some-key"] = "some-value"
            run.end(outputs={"result": result})
        ```

        Asynchronous usage:

        ```python
        async def main():
            async with trace("Async Operation", run_type="tool", tags=["async"]) as run:
                result = "foo"  # Await async operation
                run.metadata["some-key"] = "some-value"
                # "end" just adds the outputs and sets error to None
                # The actual patching of the run happens when the context exits
                run.end(outputs={"result": result})


        asyncio.run(main())
        ```

        Handling specific exceptions:

        ```python
        import pytest
        import sys

        with trace("Test", exceptions_to_handle=(pytest.skip.Exception,)):
            if sys.platform == "win32":  # Just an example
                pytest.skip("Skipping test for windows")
            result = "foo"  # Perform test operation
        ```
    N)ÚinputsrÏ   rC   rD   r`   rE   rF   r    r§   r    rÉ   Úattachmentsc               ó"  — |j                  dd«      | _        |r5t        j                  dt	        |j                  «       «      › d�t        «       || _        || _        || _	        || _
        || _        t        j                  |«      | _        t        j                  || j                  ¬«       || _        || _        |j%                  d«      | _        || _        |	| _        |
| _        || _        || _        || _        d| _        d| _        d| _        y)	z_Initialize the trace context manager.

        Warns if unsupported kwargs are passed.
        Ú_end_on_exitTzEThe `trace` context manager no longer supports the following kwargs: rr   rs   rV   NF)rk   rB  rv   rw   r}   r;  rx   r�   rË   r?  r@  rÏ   r$   ry   rD   r{   rC   r`   rb   rV   rE   rF   r    r§   r    rÉ   rØ   Úold_ctxÚ	_untraced)r»   r�   rË   r?  rÏ   rC   rD   r`   rE   rF   r    r§   r    rÉ   r@  r€   s                   r9   Ú__init__ztrace.__init__[  sò   € ð2 #ŸJ™J ~°tÓ<ˆÔÙÜ�M‰MØWÜ˜&Ÿ+™+›-Ó(Ð)¨ð,ä"ôð
 ˆŒ	Ø ˆŒØˆŒØ&ˆÔØˆŒ
Ü"×0Ñ0°Ó9ˆŒÜ×&Ñ&¨|ÀTÇ\Á\ÕRØ(ˆÔØˆŒð Ÿ
™
 :Ó.ˆŒØˆŒ	Ø ˆŒØˆŒØˆŒØ$8ˆÔ!Ø$8ˆÔ!Ø48ˆŒØ'+ˆŒØˆ�r;   c                ó  — t        «       | _        t        j                  | j                  «      }t        j
                  j                  «       xs t        j                  }t        j                  j                  «       xs t        j                  }| j                  xs | j                  j                  d«      }d}d}d}	 t        | j                  | j                  || j                  | j                  dœ«      }|�|r|j                   |j                  }}n$t#        | j                  | j                  |«      \  }}t-        t/        | j0                  xs g |xs g z   «      «      }	i | j2                  xs i ¥|xs i ¥ddi¥}
| j4                  xs i }|
|d	<   |�R|rP|j7                  | j8                  | j:                  | j<                  || j>                  |	| j@                  ¬
«      | _!        n®tE        jF                  | j8                  tI        jJ                  | j:                  «      tI        jJ                  | jL                  d¬«      | j<                  |||tD        jN                  j                  «       | j>                  xs i |	|| j@                  xs i ¬«      | _!        |du r| jB                  jQ                  «        |�rt        j
                  j/                  |	«       t        j                  j/                  |
«       | jB                  �=t        jR                  j/                  tU        jV                  | jB                  «      «       nt        jR                  j/                  d«       t        jX                  j/                  |«       t        jZ                  j/                  |«       t        j\                  j/                  |«       | jB                  S # t$        j&                  $ r-}|rt%        j(                  |«       d| _        d}d}Y d}~�ŒÇd}~ww xY w)a]  Set up the tracing context and create a new run.

        This method initializes the tracing context, merges tags and metadata,
        creates a new run (either as a child of an existing run or as a new root run),
        and sets up the necessary context variables.

        Returns:
            run_trees.RunTree: The newly created run.
        r    Nr&  )r`   rV   r    rC   rD   TFÚ	ls_methodr>  rF   )r�   r§   rË   rÏ   r?  rE   r@  ©Úaccept_null)r�   r~   r    rË   rÏ   rC   rD   rH   r?  rE   r    r@  )/rp   rC  r#   Útracing_is_enabledrN   rd   rb   Ú_GLOBAL_TAGSre   Ú_GLOBAL_METADATAr    r|   r`   rV   rC   rD   Úsession_nameÚ_get_addressingr$   ÚEnvAddressErrorÚlog_untracedrD  r}   rR   rE   rF   rÏ   Úcreate_childr�   r§   rË   r?  r@  rØ   r!   ÚRunTreer4  Ú_ensure_uuidr    rh   ÚpostrQ   rS   rT   ra   rc   rg   )r»   rG   Ú
outer_tagsÚouter_metadataÚclient_Úparent_run_Úproject_name_Úaddress_r7   Útags_rF   rÐ   s               r9   Ú_setupztrace._setup‘  sD  € ô +Ó,ˆŒÜ×*Ñ*¨4¯<©<Ó8ˆä—^‘^×'Ñ'Ó)ÒB¬X×-BÑ-Bˆ
Ü!×+Ñ+×/Ñ/Ó1ÒN´X×5NÑ5NˆØ—+‘+Ò; §¡×!1Ñ!1°(Ó!;ˆØˆØ'0ˆØ+/ˆð	Ü)à"Ÿk™kØ $§¡Ø%Ø$(×$5Ñ$5Ø#Ÿ|™|ñóˆKð Ð&©7à*5×*BÑ*BÀK×DWÑDW˜x‘ä*9Ø×%Ñ% t§|¡|°[ó+Ñ'�˜xô ”s˜DŸI™IšO¨°
Ò0@¸bÑAÓBÓCˆð
Ø�}‰}Ò" ð
àÒ# ð
ð ˜ñ
ˆð —j‘jÒ& BˆØ"*ˆ�JÑàÐ"¡wØ&×3Ñ3Ø—Y‘YØ—{‘{ØŸ™Ø!Ø—{‘{ØØ ×,Ñ,ð 4ó ˆD�Lô %×,Ñ,Ø—Y‘YÜ×)Ñ)¨$¯+©+Ó6Ü%.×%;Ñ%;Ø×-Ñ-¸4ô&ð Ÿ™Ø!Ø*Ø Ü"×,Ñ,×0Ñ0Ó2Ø—{‘{Ò( bØØØ ×,Ñ,Ò2°ôˆDŒLð" �d‰?Ø�L‰L×ÑÔÚÜ�N‰N×Ñ˜uÔ%Ü×Ñ×"Ñ" 8Ô,Ø�|‰|Ð'Ü×-Ñ-×1Ñ1´'·+±+¸d¿l¹lÓ2KÕLä×-Ñ-×1Ñ1°$Ô7Ü×"Ñ"×&Ñ& }Ô5Ü×Ñ×!Ñ! (Ô+Ü×Ñ× Ñ  Ô)à�|‰|Ðøôy ×*Ñ*ò 	ñ Ü×(Ñ(¨Ô+Ø!ˆDŒNØˆGØŽKûð	ús   Â?A:O ÏPÏ"P Ð Pc                ó¨  — | j                   €y|�2t        || j                  «      }| j                   j                  |¬«       | j                  �kt        j                  | j                  «      }|du r2| j                  r&| j                  s| j                   j                  «        t        | j                  «       yt        j                  dt        «       y)a»  Clean up the tracing context and finalize the run.

        This method handles exceptions, ends the run if necessary,
        patches the run if it's not disabled, and resets the tracing context.

        Args:
            exc_type: The type of the exception that occurred, if any.
            exc_value: The exception instance that occurred, if any.
            traceback: The traceback object associated with the exception, if any.
        NrÞ   Tz(Tracing context was not set up properly.)rØ   Ú'_format_error_with_exceptions_to_handlerÉ   ÚendrC  r#   rJ  rB  rD  Úpatchr   rv   rw   ÚRuntimeWarning)r»   Úexc_typeÚ	exc_valueÚ	tracebackÚtbrG   s         r9   Ú	_teardownztrace._teardownô  s¡   € ð  �<‰<ÐØØÐÜ8Ø˜4×4Ñ4óˆBð �L‰L×Ñ 2ÐÔ&Ø�<‰<Ð#Ü×.Ñ.¨t¯|©|Ó<ˆGØ˜$‰ 4×#4Ò#4¸T¿^º^Ø—‘×"Ñ"Ô$ä  §¡Õ.ä�M‰MÐDÄnÕUr;   c                ó"   — | j                  «       S )zyEnter the context manager synchronously.

        Returns:
            run_trees.RunTree: The newly created run.
        )r\  ©r»   s    r9   Ú	__enter__ztrace.__enter__  s   € ð �{‰{‹}Ðr;   c                ó*   — | j                  |||«       y)a  Exit the context manager synchronously.

        Args:
            exc_type: The type of the exception that occurred, if any.
            exc_value: The exception instance that occurred, if any.
            traceback: The traceback object associated with the exception, if any.
        N)rf  )r»   rb  rc  rd  s       r9   Ú__exit__ztrace.__exit__  s   € ð 	�‰�x ¨IÕ6r;   c              ƒ  óž   K  — t        «       }t        j                  || j                  «      ƒ d{  –—† }t	        t        |«      «       |S 7 Œ­w)zzEnter the context manager asynchronously.

        Returns:
            run_trees.RunTree: The newly created run.
        N)r   rà   rá   r\  r   rp   )r»   Úctxro   s      r9   Ú
__aenter__ztrace.__aenter__+  sA   è ø€ ô ‹nˆÜ!×/Ñ/°°T·[±[ÓA×AˆäÔ0°Ó5Ô6Øˆð Bús   ‚.A°A±Ac           	   ƒ  ó(  K  — t        «       }|�?t        j                  t        j                  || j
                  |||«      «      ƒ d{  –—†  n+t        j                  || j
                  |||«      ƒ d{  –—†  t        t        |«      «       y7 ŒE7 Œ­w)a  Exit the context manager asynchronously.

        Args:
            exc_type: The type of the exception that occurred, if any.
            exc_value: The exception instance that occurred, if any.
            traceback: The traceback object associated with the exception, if any.
        N)r   ræ   rê   rà   rá   rf  r   rp   )r»   rb  rc  rd  rm  s        r9   Ú	__aexit__ztrace.__aexit__7  sŒ   è ø€ ô ‹nˆØÐÜ—.‘.Ü×(Ñ(Ø˜Ÿ™¨°9¸ióó÷ ñ ô ×*Ñ*Ø�T—^‘^ X¨y¸)ó÷ ð ô 	Ô0°Ó5Õ6ðøðús$   ‚ABÁBÁ	+BÁ4BÁ5BÂB©rÍ   )r�   r6  rË   úls_client.RUN_TYPE_Tr?  r¡   rÏ   r¡   rC   rž   rD   r¤   r`   zCOptional[Union[run_trees.RunTree, str, Mapping, Literal['ignore']]]rE   r¦   rF   úOptional[Mapping[str, Any]]r    r¨   r§   rŸ   r    rŸ   rÉ   ú)Optional[tuple[type[BaseException], ...]]r@  zOptional[schemas.Attachments]r€   r   )r¾   úrun_trees.RunTree)rb  zOptional[type[BaseException]]rc  úOptional[BaseException]rd  zOptional[TracebackType]r¾   ÚNone©NNN)r3   r®   r¯   r°   rE  r\  rf  ri  rk  rn  rp  r@   r;   r9   r>  r>    s„  „ ñDðR *1ð4ð
 "&Ø $Ø&*Ø*.ð Ø$(Ø04Ø-1Ø.2Ø<@ØJNØ59ñ%4àð4ð 'ð4ð
 ð4ð ð4ð $ð4ð (ð4ð
ð4ð "ð4ð .ð4ð +ð4ð ,ð4ð  :ð!4ð" Hð#4ð$ 3ð%4ð& ó'4ólaðFVà/ðVð +ðVð +ð	Vð
 
óVó@ð 37Ø-1Ø-1ð	7à/ð7ð +ð7ð +ð	7ð
 
ó7ó
ð 37Ø-1Ø-1ð	7à/ð7ð +ð7ð +ð	7ð
 
ô7r;   r>  c                óÎ   — | r| S t        «       }t        j                  j                  «       xs8 |r|j                  nd xs& t        j
                  xs t        j                  «       S rÆ   )rO   rN   ra   rb   rM  Ú_GLOBAL_PROJECT_NAMEr#   Úget_tracer_project)rC   Úprts     r9   Ú_get_project_namer}  R  sa   € ÙØÐÜ
Ó
 €Cô 	×Ñ×"Ñ"Ó$ò 	&Ù #ˆC×Ò¨ò	&ô ×(Ñ(ò	&ô
 ×#Ñ#Ó%ðr;   c                ó¤   — t        t        | |«      «      }|�(|j                  d|j                  |j                  f«       t        j                  |Ž S )zêResolve `(project_name, address)` for a new run.

    Mirrors `_get_project_name`'s levels, with `parent` (e.g. from headers)
    after the context vars; the first level naming either mode decides, and
    one naming both raises.
    é   )ÚlistÚ_addressing_tiersÚinsertrM  rD   r$   Úresolve)rC   rD   r`   Útierss       r9   rN  rN  a  sJ   € ô Ô" <°Ó9Ó:€EØÐØ�‰�Q˜×,Ñ,¨f¯n©nÐ=Ô>Ü×Ñ Ð&Ð&r;   c                ó(   — | \  }}|rd|iS |�d|iS i S )zGRender one level's `(project, address)` as `RunTree` keyword arguments.rC   rD   r@   )Útierrt   rD   s      r9   Ú_address_kwargsr‡  r  s/   € àÑ€GˆWÙØ Ð(Ð(Ø#*Ð#6ˆI�wÐÐ>¸BÐ>r;   c                ó  — t        «       }| |ft        j                  j                  «       t        j                  j                  «       f|r|j
                  nd|r|j                  ndft        j                  t        j                  ffS )zÇReturn the levels named in code, highest first, without the env vars.

    The argument, a context variable, the current run tree, then
    `ls.configure` -- the order `_get_project_name` walks.
    N)	rO   rN   ra   rb   rc   rM  rD   rz  Ú_GLOBAL_ADDRESS)rC   rD   r|  s      r9   r�  r�  z  sr   € ô Ó
 €Cà	�wÐÜ	×	Ñ	×	#Ñ	#Ó	%¤x×'8Ñ'8×'<Ñ'<Ó'>Ð?Ù ˆ×	Ò	 d¹3¨C¯KªKÀDÐIÜ	×	&Ñ	&¬×(@Ñ(@ÐAð	ð r;   c                ó  ‡‡‡— 	 ddl mŠm} ddlmŠmŠ t        | «      s'	 t        j                  | «      }t        d| › d|› �«      ‚ G ˆˆˆfd	„d
|«      } || «      S # t        $ r}t        d«      |‚d}~ww xY w# t        $ r d}Y ŒRw xY w)a†  Convert a function wrapped by the LangSmith `@traceable` decorator to a `Runnable`.

    Args:
        traceable_fn: The function wrapped by the `@traceable` decorator.

    Returns:
        Runnable: A `Runnable` object that maintains a consistent LangSmith
            tracing context.

    Raises:
        ImportError: If `langchain` module is not installed.
        ValueError: If the provided function is not wrapped by the `@traceable` decorator.

    Example:
        >>> @traceable
        ... def my_function(input_data):
        ...     # Function implementation
        ...     pass
        >>> runnable = as_runnable(my_function)
    r   )ÚRunnableConfigÚRunnableLambda)ÚInputÚOutputzjas_runnable requires langchain-core to be installed. You can install it with `pip install langchain-core`.Nz<source unavailable>zRas_runnable expects a function wrapped by the LangSmith @traceable decorator. Got z defined as:
c                  ó|   •‡ — e Zd ZdZ	 d	 	 	 	 	 dˆˆˆ fd„Ze	 	 	 	 dˆˆˆfd„«       Ze	 	 	 	 dˆˆˆfd„«       Zˆ xZS )	ú&as_runnable.<locals>.RunnableTraceablez‰Converts a `@traceable` decorated function to a `Runnable`.

        This helps maintain a consistent LangSmith tracing context.
        c           
     ó¸  •— d }| j                  |«      }t        |«      r3|�t        d«      ‚t        t        ‰g‰f   | j                  |«      «      }n0t        |«      r%t        t        ‰g‰f   | j                  |«      «      }|€$t        | j                  j                  › d|› �«      ‚t        ‰| �-  |t        t        t        ‰gt        ‰   f      |«      «       y )Nz�Func was provided as a coroutine function, but afunc was also provided. If providing both, func should be a regular function to avoid ambiguity.zG expects a function wrapped by the LangSmith @traceable decorator. Got )Ú_wrap_asyncr›   Ú	TypeErrorr   r   r�   Ú
_wrap_syncÚ
ValueErrorÚ	__class__r3   ÚsuperrE  r   r   )r»   rŠ   Úafuncr  Úawrappedr�  rŽ  r–  s        €€€r9   rE  z/as_runnable.<locals>.RunnableTraceable.__init__¸  sí   ø€ ð
 <@ˆGØ×'Ñ'¨Ó.ˆHÜ˜Œ~ØÐ'Ü#ð7óð ô
 œx¨¨°¨Ñ8¸$×:JÑ:JÈ4Ó:PÓQ‘Ü& tÔ,Üœx¨¨°¨Ñ8¸$¿/¹/È$Ó:OÓP�ØˆÜ Ø—~‘~×.Ñ.Ð/ð 02à26°ð9óð ô ‰GÑØÜÜœX u g¬y¸Ñ/@Ð&@ÑAÑBØóõr;   c                ó@   •‡ — dˆ fd„}t        t        ‰‰g‰f   |«      S )z4Wrap a synchronous function to make it asynchronous.c                óz   •— t         j                  j                  t        t        |«      «      } ‰di | ¤dd|ii¤ŽS ©Nr¹   rV   r@   ©r!   rR  Úfrom_runnable_configr   Údict)r?  rÔ   rV   rŠ   s      €r9   Úwrap_traceablezIas_runnable.<locals>.RunnableTraceable._wrap_sync.<locals>.wrap_traceableÞ  s8   ø€ Ü$×,Ñ,×AÑAÄ$ÄtÈVÓBTÓU�ÙÑM˜fÑM°zÀ8Ð6LÒMÐMr;   ©r?  rŸ  rÔ   r‹  r¾   r   )r   r   )rŠ   r   r�  rŽ  r‹  s   ` €€€r9   r”  z1as_runnable.<locals>.RunnableTraceable._wrap_syncØ  s'   ù€ õNô œ %¨Ð!8¸&Ð!@ÑAÀ>ÓRÐRr;   c                ó¾   •‡— | €yt        | «      st        d| › �«      ‚t        t        dt        ‰   f   | «      Šdˆfd„}t        t        ‰‰gt        ‰   f   |«      S )z.Wrap an async function to make it synchronous.NzXRunnableTraceable expects a function wrapped by the LangSmith @traceable decorator. Got .c              “  ó–   •K  — t         j                  j                  t        t        |«      «      } ‰di | ¤dd|ii¤Žƒ d {  –—† S 7 Œ­wrœ  r�  )r?  rÔ   rV   Úafunc_s      €r9   Úawrap_traceablezKas_runnable.<locals>.RunnableTraceable._wrap_async.<locals>.awrap_traceableó  sB   øè ø€ Ü$×,Ñ,×AÑAÄ$ÄtÈVÓBTÓU�Ù#ÑU fÑU¸zÈ8Ð>TÒU×UÐUÐUús   ƒ?A	ÁAÁA	r¡  )r�   r•  r   r   r   )r˜  r¥  r¤  r�  rŽ  r‹  s     @€€€r9   r’  z2as_runnable.<locals>.RunnableTraceable._wrap_asyncä  s|   ù€ ð
 ˆ}Øä(¨Ô/Ü ð2Ø27°ð:óð ô œ( 3¬	°&Ñ(9Ð#9Ñ:¸EÓBˆFõVô Ü˜% Ð0´)¸FÑ2CÐCÑDÀoóð r;   rÆ   )rŠ   r   r˜  ú*Optional[Callable[..., Awaitable[Output]]]r¾   rw  )rŠ   zCallable[..., Output]r¾   z)Callable[[Input, RunnableConfig], Output])r˜  r¦  r¾   z>Optional[Callable[[Input, RunnableConfig], Awaitable[Output]]])	r3   r®   r¯   r°   rE  Ústaticmethodr”  r’  Ú__classcell__)r–  r�  rŽ  r‹  s   @€€€r9   ÚRunnableTraceabler�  ²  s}   ù„ ñ	ð AEð	àð	ð >ð	ð ÷		ð@ 
ð		SØ'ð		Sà6ö		Só 
ð		Sð 
ð	Ø=ð	àKö	ó 
ô	r;   r©  )Úlangchain_core.runnablesr‹  rŒ  Úlangchain_core.runnables.utilsr�  rŽ  ÚImportErrorr�   r™   Ú	getsourcer  r•  )Útraceable_fnrŒ  r7   Úfn_srcr©  r�  rŽ  r‹  s        @@@r9   Úas_runnabler°  ‹  s´   ú€ ð*ßKß@ô ! Ô.ð	,Ü×&Ñ& |Ó4ˆFô ð*Ø*6¨°~ÀfÀXðOó
ð 	
÷
Gð G˜Nô GñR ˜\Ó*Ð*øôq ò ÜðDó
ð ð	ûðûô ò 	,Ø+ŠFð	,ús(   …A ¡A; Á	A8Á'A3Á3A8Á;B	ÂB	>   rõ   ÚtoolrÍ   ÚparserÚpromptÚ	embeddingÚ	retrieverc                  ó€   — e Zd ZU dZded<   ded<   ded<   ded<   d	ed
<   ded<   ded<   ded<   ded<   ded<   ded<   y)Ú_TraceableContainerú3Typed response when initializing a run a traceable.r£   rØ   rž   rC   Úouter_projectr¥   rV  r¦   rU  r«   rª   r¬   zcontextvars.Contextrl   rK   Ú_token_event_loggedrG   rt  rÉ   Nr­   r@   r;   r9   r·  r·  
  sG   … Ù=à(Ó(ØÓØ Ó Ø,Ó,Ø#Ó#Ø=Ó=Ø8Ó8Ø Ó Ø'Ó'ØÓØCÔCr;   r·  c                  ó¨   — e Zd ZU dZded<   ded<   ded<   ded	<   d
ed<   ded<   ded<   ded<   ded<   ded<   ded<   ded<   ded<   ded<   ded<   y)r9  r¸  r¡   rÐ   rž   r�   r¥   rF   r¦   rE   r¨   r    úOptional[Callable]r�   rC   r¤   rD   rr  rË   ú Optional[Callable[[dict], dict]]r‘   r“   rÑ   rK   rÈ   rG   rt  rÉ   Nr­   r@   r;   r9   r9  r9    s_   … Ù=àÓØ
ÓØ&Ó&Ø
ÓØ&Ó&Ø!Ó!ØÓØ#Ó#Ø"Ó"Ø4Ó4Ø%Ó%Ø:Ó:Ø"0Ó0ØÓØCÔCr;   r9  c                óh   — |rt        | |«      ryt        j                  «       }t        | «      › d|› �S )zGFormat error for logging, suppressing traceback for handled exceptions.Nz

)r‡   r#   Ú_format_excÚrepr)rß   rÉ   Ú
stacktraces      r9   r^  r^  .  s7   € ñ
 ¤
¨5Ð2FÔ GØä×"Ñ"Ó$€JÜ�5‹kˆ]˜$˜z˜lÐ+Ð+r;   c                óØ  — | j                  d«      }|€yt        |t        «      r|}nL|�Ft        |d«      r:t	        |j
                  «      r%t        |t        «      s	 |j                  dd¬«      }nd	|i}t        ||¬
«      x}�||j                  d<   |rt        || j                  d«      «      }n)d}| j                  d«      x}rt	        |«      r		  ||«       |j!                  ||¬«       | j                  d«      }	|	du st#        j$                  «       du r|j'                  «        | j                  d«      x}
rt	        |
«      r
	  |
|«       yyy# t        $ r3}t        j                  dt        |«      › d|› �«       d	|i}Y d}~�Œd}~ww xY w# t        $ r"}t        j                  d|› �«       Y d}~ŒÝd}~ww xY w# t        $ r"}t        j                  d|› �«       Y d}~yd}~ww xY w)zEnd the run.rØ   NÚ
model_dumpTÚjson)Úexclude_noneÚmodez&Failed to use model_dump to serialize z
 to JSON: Úoutput)rV   rÀ   rÂ   rÉ   rª   z$Failed to run _on_success function: ©rÀ   rß   rG   r¬   zFailed to run on_end function: )rb   r‡   rŸ  r‹   r<  rÃ  r2   r  rZ   ÚdebugrÄ   rF   r^  rè   rv   rw   r_  r#   rJ  r`  )Ú	containerrÀ   rß   rV   Údict_outputsr7   ÚusageÚ
error_reprrª   rG   r¬   s              r9   Ú_container_endrÎ  :  sî  € ð �}‰}˜YÓ'€HØÐàÜ�'œ4Ô Ø‰àÐÜ�G˜\Ô*Ü�W×'Ñ'Ô(Ü˜7¤DÔ)ð	/Ø"×-Ñ-¸4ÀfÐ-ÓM‰Lð ! 'Ð*ˆÜ¨¸<ÔHÐHˆÐUØ.3ˆ×ÑÐ*Ñ+ÙÜ<Ø�9—=‘=Ð!7Ó8ó
‰
ð ˆ
Ø$Ÿ=™=¨Ó7Ð7ˆKÐ7¼XÀkÔ=RðJÙ˜HÔ%ð ‡L�L˜¨Z€LÔ8à�m‰m˜IÓ&€GØ�$�œ%×2Ñ2Ó4¸Ñ<Ø�‰ÔØ—-‘- Ó)Ð)ˆÐ)¬x¸Ô/?ð	AÙ�8Õð 0@Ð)øô5 ò 	/Ü�L‰LØ8¼¸g»¸ÀzÐRSÐQTÐUôð % gÐ.ŽLûð		/ûô$ !ò JÜ—‘Ð DÀQÀCÐH×IÑIûðJûô ò 	AÜ�M‰MÐ;¸A¸3Ð?×@Ñ@ûð	AúsH   ÁE ÃF ÅF> Å	FÅ(FÆFÆ	F;ÆF6Æ6F;Æ>	G)ÇG$Ç$G)c                óB   — |j                  dd «      }|ri | ¥|¥}|S | }|S )Nr¢   )rb   )rÐ   r¹   r¢   Úextra_inners       r9   Ú_collect_extrarÑ  o  s;   € Ø×#Ñ# K°Ó6€IÙØ2˜Ð2¨	Ð2ˆð Ðð "ˆØÐr;   c                óª  — | j                  d«      }|dk(  ry t        |t        j                  «      r|S t        |t        t
        f«      r:t        j                  t        | j                  d«      | j                  d«      «      Ž }t        |t        «      rMt        j                  j                  |fd| j                  d«      it        «      ¤d| j                  d«      i¤ŽS t        |t
        «      rMt        j                  j                  |fd| j                  d«      it        «      ¤d| j                  d«      i¤ŽS | j                  d«      }|r|S t        «       }t        j                  «       �bt        j                  j                  || j                  d«      ¬«      x}r0|r,|�|j                  d	«      s|j                   |j                   kD  r|S |S )
Nr`   ÚignorerC   rD   r    rH   rV   r   Ú	callbacks)rb   r‡   r!   rR  r	   r6  r$   Úfirst_namedr�  Úfrom_headersr‡  Úfrom_dotted_orderrO   r(   Úget_langchain_core_versionrž  Údotted_order)r¹   rÔ   r`   ÚnamedrV   ÚcrtÚrts          r9   r|   r|   x  sÑ  € ð × Ñ  Ó*€FØ�ÒØÜ�&œ)×+Ñ+Ô,ØˆÜ�&œ7¤C˜.Ô)ô
 ×'Ñ'ÜØ×#Ñ# NÓ3°_×5HÑ5HÈÓ5Sóð
ˆô
 �&œ'Ô"Ü× Ñ ×-Ñ-Øñ
à"×&Ñ& xÓ0ð
ô ˜eÓ$ñ
ð %×(Ñ(¨Ó4ò	
ð 	
ô �&œ#ÔÜ× Ñ ×2Ñ2Øñ
à"×&Ñ& xÓ0ð
ô ˜eÓ$ñ
ð %×(Ñ(¨Ó4ò	
ð 	
ð ×"Ñ" :Ó.€HÙØˆÜ
Ó
 €CÜ×.Ñ.Ó0Ð<Ü×"Ñ"×7Ñ7Ø˜?×.Ñ.¨xÓ8ð 8ó 
ð 
ˆ2ð 
ñ ð Ð&¨6¯:©:°kÔ+Bð —?‘? S×%5Ñ%5Ò5à�	Ø€Jr;   c           	     óˆ  — t        j                  t        j                  j	                  «       t        j
                  j	                  «       f| r| j                  nd| r| j                  ndf|j	                  d«      |j	                  d«      f|d   |j	                  d«      ft        j                  t        j                  f«      S )a�  Settle a `@traceable` run's `(project, address)`.

    One walk over the precedence levels, highest first: the first level naming
    a project or an address decides, and one naming both raises. `evaluate()`
    relies on this -- it names its experiment in a `tracing_context`, which
    outranks an address on the decorator or in the env. `resolve` consults the
    env vars as the last level.
    NrC   rD   )
r$   rƒ  rN   ra   rb   rc   rM  rD   rz  r‰  )rX  r¹   r×   s      r9   Ú_resolve_traceable_addressingrÞ  µ  sª   € ô ×Ñä	×	Ñ	×	#Ñ	#Ó	%¤x×'8Ñ'8×'<Ñ'<Ó'>Ð?ñ )4ˆK×$Ò$¸Ù#.ˆK×Ò°Dð	
ð
 
×	Ñ	˜^Ó	,¨o×.AÑ.AÀ)Ó.LÐMà	˜Ñ	(¨/×*=Ñ*=¸iÓ*HÐIä	×	&Ñ	&¬×(@Ñ(@ÐAóð r;   c                óp  — |j                  d«      xs i }|j                  d«      }|j                  d«      }|j                  d«      }|j                  d«      xs d}	|j                  dd«      }
t        j                  j                  «       }t        d)i |xs i ¤Ž}|j                  d	«      �t	        j
                  |d	   «      |d	<   d|v rt	        j                  |d   «      |d<   |j                  d«      xs |j                  d«      }|j                  d|«      xs t        j                  j                  «       }t	        j                  |j                  d«      |j                  d	«      ¬«       |j                  d«      }|j                  d«      }|j                  d«      }d
}d
}d
}	 t        i |¥d|i¥|j                  d«      «      }|duxr' |du xs! t        |xs t        j                  «       «      }|r|�|j                  }|j                  }n|r|€	 t!        |||«      \  }}|r|�t	        j"                  |«       d}|sšt        j$                  t&        j(                  d«       t+        «       }|j-                  t        j.                  j0                  d
«       t3        d
||d
d
|j                  d«      |j                  d«      |d|j                  d«      ¬«
      S t5        j6                  | «      }|xs t        j8                  | «      }t;        ||«      }t        j<                  j                  «       xs t        j>                  }t        j@                  j                  «       xs t        jB                  }t+        «       }i |j                  d«      xs i ¥|xs i ¥}|j-                  t        j<                  j0                  |«       |jE                  |xs i «       d|d<   ||d<   tG        |g|¢­d| i|¤Ž\  }}|j                  d«      } | rP	  | |«      jI                  «       D �!�"ci c]  \  }!}"|"€Œ	|!|"“Œ }#}!}"|#r!tK        |#tL        «      r|jE                  |#«       |j                  d«      }$|$r		  |$|«      }|j                  d«      xs g |xs g z   }%|j-                  t        j@                  j0                  |%«       |%|xs g z  }%|�|j]                  ||	||%|||¬#«      }&n}|||	t_        j`                  |d¬$«      ||tb        jd                  j                  «       ||%|||
d%œ}'|�t_        j`                  |«      |'d&<   tc        jf                  d)i ti        tj        |'«      ¤Ž}&|du st        j                  «       du r	 |&jm                  «        t3        |&|||||j                  d«      |j                  d«      |d||j                  d«      ¬(«      }(|j-                  t        j                  j0                  |(d   «       |j-                  t        jp                  j0                  |«       |&�?|j-                  t        j.                  j0                  ts        jt                  |&«      «       |(S |j-                  t        j.                  j0                  d
«       |(S # t        j                  $ r}d
|}}Y d
}~�Œéd
}~ww xY w# t        j                  $ r}|}Y d
}~�Œ­d
}~ww xY wc c}"}!w # tN        $ r&}tP        jS                  d|› d|› �«       Y d
}~�Œ­d
}~ww xY w# tN        $ rV}tU        «       rtP        jW                  d ||«       n)tP        jW                  d!||«       tX        t[        d"|«      i}Y d
}~�Œód
}~ww xY w# tN        $ r0}tP        jS                  d'|&jn                  › d|› �«       Y d
}~�Œd
}~ww xY w)*r  rÐ   rF   rE   r    rË   rÍ   rÈ   FrD   NrH   r�   rC   rs   r    r§   rG   rÔ   Tz>LangSmith tracing is not enabled, returning original function.rª   r¬   rÉ   )
rØ   rC   r¹  rV  rU  rª   r¬   rl   rº  rÉ   r•   rG  rŠ   rÑ   z&Failed to infer invocation params for r0   r‘   zpprocess_inputs failed for %s; tracing unprocessed inputs because LANGSMITH_ALLOW_UNPROCESSED_PAYLOADS is set: %sz1process_inputs failed for %s; dropping inputs: %sr?  )r�   rË   r?  rE   rÏ   r§   r@  rH  )r�   r?  rË   r    rC   rD   rH   rÏ   rE   r    r@  rÈ   r~   zFailed to post run )rØ   rC   r¹  rV  rU  r¬   rª   rl   rº  rG   rÉ   r@   );rb   rN   ra   r�   r$   ry   rz   rg   r{   r|   rO  Úboolr#   rJ  rM  rD   rÞ  rP  Úlog_onceÚloggingÚDEBUGr   r  rQ   rR   r·  r™   r  Ú_get_function_namerÑ  re   rL  rd   rK  r\   Ú _get_inputs_and_attachments_saferj   r‡   rŸ  rè   rZ   rß   rA   r[   Ú_PROCESSING_FAILED_KEYr:   rQ  r4  rS  r!   rh   rR  r   r   rT  r~   rc   rS   rT   ))rŠ   r×   r¹   r¼   r€   rÐ   rF   rE   r    rË   rÈ   r¹  r�   rW  r    Úid_rG   Úselected_projectÚselected_addressÚ	env_errorrX  r7   Útracingrl   r  Úname_rÐ  rV  rU  Ú	metadata_r?  r@  rÑ   rm   rn   Úinvocation_paramsr‘   r[  rØ   Úrun_tree_kwargsÚresponse_containers)                                            r9   râ   râ   Ó  s£  € ð "×%Ñ% mÓ4Ò:¸€KØ×"Ñ" :Ó.€HØ×Ñ˜vÓ&€DØ× Ñ  Ó*€FØ×"Ñ" :Ó.Ò9°'€HØ#2×#6Ñ#6Ø&¨ó$Ð ô ×*Ñ*×.Ñ.Ó0€MÜ$Ñ?¨Ò(=¸2Ñ?€OØ×Ñ˜9Ó%Ð1Ü%0×%>Ñ%>Ø˜IÑ&ó&
ˆ˜	Ñ"ð �_Ñ$Ü&1×&DÑ&DØ˜JÑ'ó'
ˆ˜
Ñ#ð ×Ñ˜vÓ&ÒE¨/×*=Ñ*=¸fÓ*E€DØ×!Ñ! (¨FÓ3ÒM´x×7GÑ7G×7KÑ7KÓ7M€GÜ×"Ñ"Ø×#Ñ# NÓ3Ø×#Ñ# IÓ.õð +×.Ñ.Ð/EÓFÐØ
×
Ñ
˜hÓ
'€CØ×!Ñ! )Ó,€GØ&*ÐØ/3ÐØ7;€Ið)Ü%Ø2ˆÐ2 ¨'Ñ2°F·J±J¸xÓ4Hó
ˆð ˜UÐ"ò Ø�4ˆÒJœ4 Ò I¬u×/GÑ/GÓ/IÓJð ñ
 �;Ð*ð '×3Ñ3ÐØ&×.Ñ.ÑÙ	�YÐ&ð	Ü1NØ˜_¨oó2Ñ.ÐÐ.ñ
 �9Ð(ä× Ñ  Ô+ØˆÙÜ�‰Ü�M‰MØLô	
ô “.ˆà�‰”H×1Ñ1×5Ñ5°tÔ<Ü"ØØ)Ø'ØØØ'×+Ñ+¨MÓ:Ø"×&Ñ& xÓ0ØØ %Ø!0×!4Ñ!4Ð5KÓ!Lô
ð 	
ô ×!Ñ! $Ó'€IØÒ2”E×,Ñ,¨TÓ2€EÜ  ¨oÓ>€KÜ×'Ñ'×+Ñ+Ó-ÒJ´×1JÑ1J€NÜ—‘×#Ñ#Ó%Ò>¬×)>Ñ)>€JÜ‹n€GðØ×Ñ˜zÓ*Ò0¨bðàÒ˜Rð€Ið ‡K�K”×"Ñ"×&Ñ&¨	Ô2Ø×Ñ�X’^ Ô$Ø(€IˆkÑØ'€K�
ÑÜ:ØðØòØ#ðØ'-ñÑ€FˆKð +×.Ñ.Ð/EÓFÐÙð	Pá!5°fÓ!=×!CÑ!CÔ!Eô!Ù!E™˜˜AÈÉ��1‘Ð!Eð ñ !ñ !¤ZÐ0AÄ4Ô%HØ× Ñ Ð!2Ô3ð %×(Ñ(Ð)9Ó:€NÙð	SÙ# FÓ+ˆFð × Ñ  Ó(Ò.¨B°:Ò3CÀÑD€EØ‡K�K”—‘×"Ñ" EÔ*Ø	ˆTŠZ�RÑ€EØÐØ×*Ñ*ØØØØØØØ#ð +ó 
‰ð ØØ Ü$-×$:Ñ$:Ø$°$ô%ð -Ø'Ü!×+Ñ+×/Ñ/Ó1Ø ØØØ&Ø,Hñ
ˆð" ˆ?Ü$-×$:Ñ$:¸3Ó$?ˆO˜DÑ!Ü×#Ñ#ÑA¤d¬3°Ó&@ÑAˆà�$�œ%×2Ñ2Ó4¸Ñ<ð	BØ�L‰LŒNô -ØØ%Ø#Ø%ØØ×"Ñ" 8Ó,Ø#×'Ñ'¨Ó6ØØ!ØØ,×0Ñ0Ð1GÓHôÐð ‡K�K”×&Ñ&×*Ñ*Ð,>¸~Ñ,NÔOð ‡K�K”×!Ñ!×%Ñ%Ð'7Ô8ð
 ÐØ�‰”H×1Ñ1×5Ñ5´w·{±{À7Ó7KÔLð Ðð 	�‰”H×1Ñ1×5Ñ5°tÔ<ØÐøô} ×&Ñ&ò )Ø!% q�YŽûð)ûô* ×*Ñ*ò 	ØŽIûð	üó\!øô
 ò 	PÜ�L‰LÐAÀ%ÀÈÈ1È#ÐN×OÒOûð	Pûô ò 	SÜ*Ô,Ü—‘ðNàØõ	ô —‘ØGÈÐPQôô 1Ô2DÀXÈqÓ2QÐR�ÿùð	Sûôj ò 	BÜ�L‰LÐ.¨w¯z©z¨l¸"¸Q¸CÐ@×AÒAûð	Bús‘   Æ-!Z ÈZ? Ð[( Ð/
["Ð:["Ð?&[( Ñ9\ Ö]< ÚZ<Ú-Z7Ú7Z<Ú?[Û[Û[Û"[( Û(	\Û1\Ü\Ü	]9Ü#A]4Ý4]9Ý<	^5Þ%^0Þ0^5c                ó   — |�		  ||«      }	 t        | ||¬«       y# t         $ rq}t        | j                  d«      dd«      }t        «       rt        j                  d||«       n)t        j                  d||«       t        t        d|«      i}Y d}~Œ…d}~ww xY w# t         $ r+}t        j                  dt        |«      › �«       Y d}~yd}~ww xY w)	zHandle the end of run.NrØ   r�   zvprocess_outputs failed for run %s; tracing unprocessed outputs because LANGSMITH_ALLOW_UNPROCESSED_PAYLOADS is set: %sz7process_outputs failed for run %s; dropping outputs: %srÀ   rÈ  z!Unable to process trace outputs: )
rè   Úgetattrrb   rA   rZ   r[   ræ  r:   rÎ  rÀ  )rÊ  rÀ   rß   rÒ   r7   Úrun_names         r9   r:  r:  ž  sÑ   € ð Ð$ð	UÙ'¨Ó0ˆGð&FÜ�y¨'¸Ö?øô' ò 	Uä˜yŸ}™}¨YÓ7¸ÀÓFˆHÜ*Ô,Ü—‘ðð Øõô —‘ØMØØôô
 2Ô3EÀiÐQRÓ3SÐT�ÿøð#	Uûô( ò FÜ�‰Ð:¼4À»7¸)ÐD×EÑEûðFús,   „ �B œ	B¥A'BÂBÂ	CÂ"!CÃCc                ó   — t        | dd«      S )Nr  F)rò  rŒ   s    r9   r†   r†   À  s   € Ü�4Ð2°EÓ:Ð:r;   c                ó¤  —  | j                   |i |¤Ž}|j                  «        t        |j                  «      }|j	                  dd«       |j	                  dd«       | j
                  j                  «       D ]W  \  }}|j                  t        j                  j                  k(  sŒ.||v sŒ3|j                  ||   «       |j	                  |«       ŒY |S )z:Return a dictionary of inputs from the function signature.r»   NÚcls)Úbind_partialÚapply_defaultsrŸ  Ú	argumentsrk   r  rj   r8   r™   r  r  r\   )r  r¼   r€   Úboundrù  Ú
param_namer"  s          r9   Ú_get_inputsrü  Ä  s¸   € ð #ˆI×"Ñ" DÐ3¨FÑ3€EØ	×ÑÔÜ�U—_‘_Ó%€IØ‡M�M�&˜$ÔØ‡M�M�%˜ÔØ&×1Ñ1×7Ñ7Ö9Ñˆ
�EØ�:‰:œ×*Ñ*×6Ñ6Ó6ð ˜YÒ&Ø× Ñ  ¨:Ñ!6Ô7Ø—‘˜jÕ)ð :ð Ðr;   c                óŽ   — 	 t        | g|¢­i |¤ŽS # t        $ r*}t        j                  d| › d|› �«       ||dœcY d }~S d }~ww xY w©NzFailed to get inputs for r0   )r¼   r€   )rü  rè   rZ   rÉ  )r  r¼   r€   r7   s       r9   Ú_get_inputs_saferÿ  Ø  sQ   € ð0Ü˜9Ð6 tÒ6¨vÑ6Ð6øÜò 0Ü�‰Ð0°°¸2¸a¸SÐAÔBØ¨Ñ/Õ/ûð0ús   ‚ ‘	Aš?¹A¿Ac                ó  — | j                   t        j                  k(  sAt        | j                   «      t        k(  r&t        d„ t        | j                   «      D «       «      ry|�‹t        | j                   t        «      rq	 t        |d¬«      }|j                  | j                  «      }|�D|t        j                  k(  xs/ t        |«      t        k(  xr t        d„ t        |«      D «       «      S 	 yy# t        t        t        f$ r Y yw xY w)Nc              3  óB   K  — | ]  }|t         j                  k(  –— Œ y ­wrÆ   ©r"   Ú
Attachment©r!  Úargs     r9   r#  z!_is_attachment.<locals>.<genexpr>å  s   è ø€ ÐPÑ5O¨c�”w×)Ñ)Õ)Ñ5Oùó   ‚T)Úinclude_extrasc              3  óB   K  — | ]  }|t         j                  k(  –— Œ y ­wrÆ   r  r  s     r9   r#  z!_is_attachment.<locals>.<genexpr>ò  s#   è ø€ ð á#@˜Cð œw×1Ñ1Õ1Ù#@ùr  F)Ú
annotationr"   r  r   r   Úanyr   r‡   r6  r   rb   r�   Ú	NameErrorr“  ÚAttributeError)r"  rŠ   Ú
type_hintsÚresolved_annotations       r9   Ú_is_attachmentr  â  sô   € Ø×Ñœ7×-Ñ-Ò-Ü�5×#Ñ#Ó$¬	Ò1ÜÑP´X¸e×>NÑ>NÔ5OÓPÔPàð ÐœJ u×'7Ñ'7¼Ô=ð	ä'¨¸TÔBˆJØ",§.¡.°·±Ó"<ÐØ"Ð.Ø*¬g×.@Ñ.@Ñ@ò ÜÐ2Ó3´yÑ@ò Üñ ä#+Ð,?Ô#@óó ðð /ñ øô œ9¤nÐ5ò 	Øàð	ús   Á=A-C. Ã.DÄDc                ó€   — | j                   j                  «       D ��ch c]  \  }}t        ||«      r|’Œ c}}S c c}}w rÆ   )r  rj   r  )r  rŠ   r�   r"  s       r9   Ú_attachment_args_helperr  ý  sF   € ð
 %×/Ñ/×5Ñ5Ô7ôá7‰KˆD�%Ü˜% Ô&ò 	Ø7òð ùó s   ž:iè  )Úmaxsizec                ó   — t        | d «      S rÆ   )r  )r  s    r9   Ú$_cached_attachment_args_by_signaturer    s   € ä" 9¨dÓ3Ð3r;   zQweakref.WeakKeyDictionary[Callable[..., Any], tuple[inspect.Signature, set[str]]]Ú_attachment_args_cachec                ó<  — |€t        | «      S 	 t        5  t        j                  |«      }d d d «       �|d   | k(  r|d   S t        | |«      }t        5  | |ft        |<   d d d «       |S # 1 sw Y   Œ@xY w# t        $ r t        | |«      cY S w xY w# 1 sw Y   |S xY w)Nr   rÎ   )r  Ú_attachment_args_cache_lockr  rb   r“  r  )r  rŠ   Úcachedro   s       r9   Ú_cached_attachment_argsr    s¦   € ð €|Ü3°IÓ>Ð>ð8Þ(Ü+×/Ñ/°Ó5ˆF÷ )ð Ð˜f Q™i¨9Ò4Ø�a‰yÐä$ Y°Ó5€FÞ	$Ø(1°6Ð':Ô˜tÑ$÷ 
%à€M÷ )Ð(ûäò 8ä& y°$Ó7Ò7ð8ú÷ 
%à€Mús3   �A6 •A*«A6 ÁBÁ*A3Á/A6 Á6BÂBÂBc                 óŠ   — t         5  t        j                  «        d d d «       t        j	                  «        y # 1 sw Y   ŒxY wrÆ   )r  r  Úclearr  Úcache_clearr@   r;   r9   Ú_clear_cached_attachment_argsr  (  s+   € Þ	$Ü×$Ñ$Ô&÷ 
%ä(×4Ñ4Õ6÷ 
%Ð	$ús	   ‡9¹Ac                óR   — 	 t        | |«      S # t        $ r t        | |«      cY S w xY wrÆ   )r  r“  r  )r  rŠ   s     r9   Ú_attachment_argsr  1  s0   € ð8Ü& y°$Ó7Ð7øÜò 8Ü& y°$Ó7Ò7ð8ús   ‚ Ž&¥&rŒ   c               ó  — 	 t        | g|¢­i |¤Ž}t        | |«      }|r/i i }}|j                  «       D ]  \  }}	||v r|	||<   Œ|	||<   Œ ||fS |i fS # t        $ r,}
t        j                  d| › d|
› �«       ||dœi fcY d }
~
S d }
~
ww xY wrþ  )rü  r  rj   rè   rZ   r[   )r  rŠ   r¼   r€   ÚinferredÚattachment_argsr?  r@  rm   rn   r7   s              r9   rå  rå  ;  s³   € ð4Ü˜yÐ:¨4Ò:°6Ñ:ˆÜ*¨9°dÓ;ˆÙØ"$ b�KˆFØ Ÿ™Ö(‘��1Ø˜Ñ'Ø%&�K ’Nà !�F˜1’Ið	 )ð
 ˜;Ð&Ð&Ø˜ˆ|ÐøÜò 4Ü�‰Ð2°9°+¸RÀ¸sÐCÔDØ¨Ñ/°Ð3Õ3ûð4ús$   ‚AA ÁA Á	BÁ!BÁ<BÂBc                óš  — | €.t         j                  «       D ]  \  }}|j                  d«       Œ y| j                  «       D ]ˆ  \  }}|dk(  rU|�3t        j                  j                  t        j                  |«      «       nt        j                  j                  d«       Œ`t         j                  |«      }|€Œx|j                  |«       ŒŠ y)zSet the tracing context.Nr`   )rJ   rj   rR   rN   rQ   rS   rT   rb   )rl   rm   rn   Úvars       r9   r   r   R  sŸ   € à€Ü!×'Ñ'Ö)‰DˆAˆqØ�E‰E�$�Kð *àØ—‘–‰ˆˆ1Ø�Š=àˆ}Ü×-Ñ-×1Ñ1´'·+±+¸a³.ÕAä×-Ñ-×1Ñ1°$Ô7ØÜ×Ñ Ó"ˆØ‰?Ø�G‰G�A�Jñ  r;   c              #  óü  ‡ ‡K  — 	 	 |rˆ ˆfd„}‰d   j                  |«      }n‰d   j                  t        ‰ «      }|r	 ||«      }n|}|rx‰d   rs‰j                  d«      sb‰d   j                  dt        j                  j                  t        j                  j                  «      j                  «       d|idœ«       d‰d<   |j                  |«       |–— ŒÓ# t        $ r}	|	j                  cY d }	~	S d }	~	ww xY w­w)	NTc                 ó´   •— ‰j                  d«      } | r$t        | «      }|r|5  t        ‰«      cd d d «       S t        ‰«      S # 1 sw Y   t        ‰«      S xY w©NrØ   )rb   rä   Únext©rV   Úfresh_otel_contextrö   rë   s     €€r9   Únext_with_otel_contextz1_process_iterator.<locals>.next_with_otel_contextr  sP   ø€ à,×0Ñ0°Ó;�HÙÜ-GÈÓ-QÐ*Ù-Ú!3Ü'+¨I£÷ "4Ñ!3ä 	›?Ð*÷ "4ä 	›?Ð*ús   ¤AÁArl   rØ   rº  Ú	new_tokenrW   ©r�   Útimer€   )r  r(  rb   Ú	add_eventÚdatetimeÚnowÚtimezoneÚutcÚ	isoformatr	  ÚStopIterationÚvalue)
rö   rë   r÷   rø   r“   rÛ   r+  rþ   Útraced_itemr7   s
   ``        r9   r  r  e  sþ   ùè ø€ ð'ØÙ#õ+ð (¨	Ñ2×6Ñ6Ð7MÓN‘à$ YÑ/×3Ñ3´D¸)ÓD�ÙÙ+¨DÓ1‘à"�áØ! )Ò,Ø%×)Ñ)Ð*?Ô@à˜iÑ(×2Ñ2à +Ü (× 1Ñ 1× 5Ñ 5Ü$×-Ñ-×1Ñ1ó!ç#™)›+Ø#*¨KÐ"8ñôð 8<�Ð3Ñ4Ø�N‰N˜;Ô'ØŠJðI øôJ ò Ø�w‰w�ûðüs/   „C<†CC Ã	C9Ã#C4Ã.C9Ã/C<Ã4C9Ã9C<)rÛ   c              ó`  ‡ ‡K  — 	 	 |r`ˆ ˆfd„}|r(t        j                   |«       ‰d   ¬«      ƒ d {  –—† }n¥t        d
i t        ‰d   «      ¤Ž5   |«       ƒ d {  –—† }d d d «       nu|r6t        j                  t	        j
                  ‰ «      ‰d   ¬«      ƒ d {  –—† }n=t        d
i t        ‰d   «      ¤Ž5  t	        j
                  ‰ «      ƒ d {  –—† }d d d «       |r	 |«      }	n}	|rx‰d   rs‰j                  d«      sb‰d   j                  dt        j                  j                  t        j                  j                  «      j                  «       d|	id	œ«       d‰d<   |j                  |	«       |­–— �Œv7 �ŒJ7 �Œ%# 1 sw Y   Œ®xY w7 Œó7 Œ¿# 1 sw Y   Œ¾xY w# t        $ r Y y w xY w­w)NTc               “  óø   •K  — ‰j                  d«      } | r6t        | «      }|r)|5  t        j                  ‰«      ƒ d {  –—† cd d d «       S t        j                  ‰«      ƒ d {  –—† S 7 Œ*# 1 sw Y   Œ(xY w7 Œ­wr'  )rb   rä   rà   Úpy_anextr)  s     €€r9   Úanext_with_otel_contextz8_process_async_iterator.<locals>.anext_with_otel_context¦  sk   øè ø€ à,×0Ñ0°Ó;�HÙÜ-GÈÓ-QÐ*Ù-Ú!3Ü-7×-@Ñ-@ÀÓ-K×'K÷ "4Ñ!3ä!+×!4Ñ!4°YÓ!?×?Ð?ð (Lø÷ "4Ð!3úà?ús9   ƒ#A:¦A,¿A*Á A,Á"A:Á%A8Á&A:Á*A,Á,A5Á1A:rl   rÝ   rØ   rº  r,  rW   r-  r@   )ræ   rç   rƒ   rp   rà   r:  rb   r/  r0  r1  r2  r3  r4  r	  ÚStopAsyncIteration)
rö   rë   r÷   rì   rø   r“   rÛ   r;  rþ   r7  s
   ``        r9   rû   rû   ˜  s¹  ùè ø€ ð;ØÙ#õ@ñ #Ü!(×!4Ñ!4Ù/Ó1Ø -¨iÑ 8ô"÷ ‘Dô )ñ Ü-¨m¸IÑ.FÓGóñ &=Ó%>×>˜÷ð ñ
 #Ü!(×!4Ñ!4Ü"×+Ñ+¨IÓ6Ø -¨iÑ 8ô"÷ ‘Dô )ñ Ü-¨m¸IÑ.FÓGóô &0×%8Ñ%8¸Ó%C×C˜÷ñ Ù+¨DÓ1‘à"�áØ! )Ò,Ø%×)Ñ)Ð*?Ô@à˜iÑ(×2Ñ2à +Ü (× 1Ñ 1× 5Ñ 5Ü$×-Ñ-×1Ñ1ó!ç#™)›+Ø#*¨KÐ"8ñôð 8<�Ð3Ñ4Ø�N‰N˜;Ô'Ø‹Jñq ðùð  ?ù÷ð úðøð  Dø÷ð ûô2 ò Ùðüs�   „F.†-F ³E=´F ÁFÁF ÁFÁ ;F ÂFÂF Â8FÃFÃFÃB(F Æ FÆFÆF ÆFÆFÆF Æ	F+Æ(F.Æ*F+Æ+F.ÚTc                  óP   — e Zd ZdZ	 d
	 	 	 	 	 dd„Zdd„Zd„ Zd„ Zd„ Zd„ Z	d
dd	„Z
y)Ú_TracedStreamBasez%Base class for traced stream objects.Nc                ó’   — || _         || _        d| _        || _        g | _        |d   r|d   j
                  dk(  | _        y d| _        y )NFrØ   rõ   )Ú__ls_stream__Ú__ls_trace_container__Ú__ls_completed__Ú__ls_reduce_fn__Ú__ls_accumulated_output__rË   Ú__is_llm_run__)r»   r  r  r�   s       r9   rE  z_TracedStreamBase.__init__æ  s`   € ð $ˆÔØ&5ˆÔ#Ø %ˆÔØ )ˆÔØ24ˆÔ&ð ˜yÒ)ð ˜IÑ&×/Ñ/°5Ñ8ð 	Õð ð 	Õr;   c                ó.   — t        | j                  |«      S rÆ   )rò  rA  )r»   r�   s     r9   Ú__getattr__z_TracedStreamBase.__getattr__÷  s   € Ü�t×)Ñ)¨4Ó0Ð0r;   c                ó|   — t        t        t        | j                  «      t        | j                  «      z   «      «      S rÆ   )r€  rR   Údirr–  rA  rh  s    r9   Ú__dir__z_TracedStreamBase.__dir__ú  s+   € Ü”Cœ˜DŸN™NÓ+¬c°$×2DÑ2DÓ.EÑEÓFÓGÐGr;   c                ó"   — d| j                   ›d�S )Nz
Traceable(r1   )rA  rh  s    r9   Ú__repr__z_TracedStreamBase.__repr__ý  s   € Ø˜D×.Ñ.Ð1°Ð3Ð3r;   c                ó,   — t        | j                  «      S rÆ   )r6  rA  rh  s    r9   Ú__str__z_TracedStreamBase.__str__ 	  s   € Ü�4×%Ñ%Ó&Ð&r;   c                ó°   — 	 | j                   s| j                  «        	 | j                  j	                  «        y # t        $ r Y Œ'w xY w# t        $ r Y y w xY wrÆ   )rC  Ú
_end_tracerè   rA  Ú__del__rh  s    r9   rR  z_TracedStreamBase.__del__	  sX   € ð	Ø×(Ò(Ø—‘Ô!ð	Ø×Ñ×&Ñ&Õ(øô ò 	Ùð	ûô ò 	Ùð	ús    ‚: ŸA	 º	AÁAÁ		AÁAc                óÞ   — | j                   ry 	 | j                  r| j                  | j                  «      }n| j                  }t        | j                  ||¬«       d| _         y # d| _         w xY w)NrÈ  T)rC  rD  rE  rÎ  rB  )r»   rß   Úreduced_outputs      r9   rQ  z_TracedStreamBase._end_trace	  sg   € Ø× Ò Øð	)Ø×$Ò$Ø!%×!6Ñ!6°t×7UÑ7UÓ!V‘à!%×!?Ñ!?�ÜØ×+Ñ+Ø&Øõð %)ˆDÕ!ø DˆDÕ!ús   �AA# Á#	A,rÆ   )r  z$Union[Iterator[T], AsyncIterator[T]]r  r·  r�   r¼  )r�   r6  ©rß   rv  )r3   r®   r¯   r°   rE  rH  rK  rM  rO  rR  rQ  r@   r;   r9   r?  r?  ã  sJ   „ Ù/ð )-ð	
à4ð
ð -ð
ð &ó	
ó"1òHò4ò'ò	õ)r;   r?  c                  óT   ‡ — e Zd ZdZ	 	 d	 	 	 	 	 	 	 dˆ fd„Zd	d„Zd
d„Zd„ Zd„ Zˆ xZ	S )r  z>A wrapper for synchronous stream objects that handles tracing.c                ó²   •— t         ‰| �  |||¬«       || _        t        | j                  | j                  | j
                  | j                  |¬«      | _        y )N©r  r  r�   )r÷   rø   r“   )r—  rE  rA  r  rB  rF  rE  Ú__ls__gen__©r»   r  r  r�   r“   r–  s        €r9   rE  z_TracedStream.__init__"	  s^   ø€ ô 	‰ÑØØ+Øð 	ô 	
ð
 $ˆÔÜ,Ø×ÑØ×'Ñ'Ø×*Ñ*Ø×2Ñ2Ø'ô
ˆÕr;   c                ój   — 	 t        | j                  «      S # t        $ r | j                  «        ‚ w xY wrÆ   )r(  rY  r5  rQ  rh  s    r9   Ú__next__z_TracedStream.__next__7	  s4   € ð	Ü˜×(Ñ(Ó)Ð)øÜò 	Ø�O‰OÔØð	ús   ‚ —2c              #  ó¸   K  — 	 | j                   E d {  –—†  | j                  «        y 7 Œ# t        $ r#}t        |«       | j                  |¬«       ‚ d }~ww xY w­w©NrÞ   )rY  rQ  rè   ré   )r»   r7   s     r9   r  z_TracedStream.__iter__>	  sS   è ø€ ð	Ø×'Ñ'×'Ð'ð �O‰OÕð (ùÜò 	Ü˜qÔ!Ø�O‰O !ˆOÔ$Øûð	üs0   ‚A„+ “)”+ ˜A©+ «	A´AÁAÁAc                ó:   — | j                   j                  «        | S rÆ   )rA  ri  rh  s    r9   ri  z_TracedStream.__enter__H	  s   € Ø×Ñ×$Ñ$Ô&Øˆr;   c                ó¸   — 	 | j                   j                  |||«      | j                  |r|¬«       S d ¬«       S # | j                  |r|¬«       w d ¬«       w xY wr^  )rA  rk  rQ  ©r»   rb  Úexc_valÚexc_tbs       r9   rk  z_TracedStream.__exit__L	  sO   € ð	AØ×%Ñ%×.Ñ.¨x¸À&ÓIà�O‰O©X 'ˆOÕ@¸4ˆOÕ@øˆD�O‰O©X 'ˆOÕ@¸4ˆOÕ@ús	   ‚; »A©NN)r  úIterator[T]r  r·  r�   r¼  r“   r¼  ©r¾   r=  )r¾   re  )
r3   r®   r¯   r°   rE  r\  r  ri  rk  r¨  ©r–  s   @r9   r  r  	  sN   ø„ ÙHð )-Ø,0ð
àð
ð -ð
ð &ð	
ð
 *õ
ó*óòöAr;   r  c                  ó^   ‡ — e Zd ZdZ	 	 d	 	 	 	 	 	 	 d	ˆ fd„Zd
dd„Zdd„Zdd„Zd„ Zd„ Z	ˆ xZ
S )r  z?A wrapper for asynchronous stream objects that handles tracing.c                óØ   •— t         ‰| �  |||¬«       || _        t        | j                  | j                  | j
                  t        j                  «       | j                  |¬«      | _	        y )NrX  )rö   rë   r÷   rì   rø   r“   )
r—  rE  rA  rû   rB  rF  rà   rã   rE  Ú_TracedAsyncStream__ls_genrZ  s        €r9   rE  z_TracedAsyncStream.__init__V	  si   ø€ ô 	‰ÑØØ+Øð 	ô 	
ð
 $ˆÔÜ/Ø×(Ñ(Ø×5Ñ5Ø×*Ñ*Ü&×>Ñ>Ó@Ø×2Ñ2Ø'ô
ˆ�r;   c              ƒ  óÄ   K  — t        «       }t        j                  t        j                  || j
                  |«      «      ƒ d {  –—†  t        t        |«      «       y 7 Œ­wrÆ   )r   ræ   rê   rà   rá   rQ  r   rp   )r»   rß   rm  s      r9   Ú_aend_tracez_TracedAsyncStream._aend_tracel	  sF   è ø€ Ü‹nˆÜ�n‰nœZ×5Ñ5°c¸4¿?¹?ÈEÓRÓS×SÐSÜÔ0°Ó5Õ6ð 	Tús   ‚AA ÁAÁA c              ƒ  óÈ   K  — 	 t        t        t        j                  | j                  «      ƒ d {  –—† «      S 7 Œ# t
        $ r | j                  «       ƒ d {  –—†7   ‚ w xY w­wrÆ   )r   r=  rà   r:  rj  r<  rl  rh  s    r9   Ú	__anext__z_TracedAsyncStream.__anext__q	  sP   è ø€ ð	Üœ¤×!4Ñ!4°T·]±]Ó!C×CÓDÐDÐCùÜ!ò 	Ø×"Ñ"Ó$×$Ñ$Øð	üs1   ‚A"„,; °9
±; ¸A"¹; »AÁAÁAÁA"c               óÌ   K  — 	 | j                   2 3 d {  –—† }|­–— Œ7 Œ
6 	 | j                  «       ƒ d {  –—†7   y # t        $ r | j                  «       ƒ d {  –—†7   ‚ w xY w­wrÆ   )rj  rl  rè   )r»   rþ   s     r9   r  z_TracedAsyncStream.__aiter__x	  s_   è ø€ ð	%Ø"Ÿmšm÷ �dØ”
ðø™mð ×"Ñ"Ó$×$Ò$øô	 ò 	Ø×"Ñ"Ó$×$Ñ$Øð	üsF   ‚A$„= �!”•!˜= Ÿ!¡= £A$¶9·A$½A!ÁAÁA!Á!A$c              ƒ  óV   K  — | j                   j                  «       ƒ d {  –—†  | S 7 Œ­wrÆ   )rA  rn  rh  s    r9   rn  z_TracedAsyncStream.__aenter__‚	  s(   è ø€ Ø× Ñ ×+Ñ+Ó-×-Ð-Øˆð 	.ús   ‚) '¡)c              ƒ  óÊ   K  — 	 | j                   j                  |||«      ƒ d {  –—† | j                  «       ƒ d {  –—†  S 7 Œ7 Œ# | j                  «       ƒ d {  –—†7   w xY w­wrÆ   )rA  rp  rl  ra  s       r9   rp  z_TracedAsyncStream.__aexit__†	  sT   è ø€ ð	%Ø×+Ñ+×5Ñ5°hÀÈÓP×Pà×"Ñ"Ó$×$Ñ$ð Qøà$ù�$×"Ñ"Ó$×$Ò$üsG   ‚A#„ A ¤A¥A ¨A#»A¼A#ÁA ÁA#ÁA ÁAÁA Á A#rd  )r  úAsyncIterator[T]r  r·  r�   r¼  r“   r¼  rÆ   rU  rf  )r¾   rr  )r3   r®   r¯   r°   rE  rl  rn  r  rn  rp  r¨  rg  s   @r9   r  r  S	  sR   ø„ ÙIð )-Ø,0ð
à ð
ð -ð
ð &ð	
ð
 *õ
ô,7ó
ó%òö%r;   r  c                ó|   — | r|�		  || «      S | S y # t         $ r!}t        j                  |«       | cY d }~S d }~ww xY wrÆ   )rè   rZ   rß   )rø   r�   r7   s      r9   rü   rü   �	  sI   € ÙØÐ ðÙ  Ó)Ð)ð
 ˆNð øô !ò Ü—‘˜Q”Ø•ûðús   † ‘	;š6°;¶;c                óF  — | j                   }|r“|j                  �|j                  j                  j                  j                  t        «      rL|j                  }|j                  �4|j                  j                  j                  j                  t        «      rŒL|| _         y y rÆ   )Ú__traceback__Útb_nextÚtb_frameÚf_codeÚco_filenameÚendswithÚ_EXCLUDED_FRAME_FNAME)r7   Útb_s     r9   ré   ré   ™	  s}   € Ø
�/‰/€CÙ
Ø�k‰kÐ%¨#¯,©,×*=Ñ*=×*IÑ*I×*RÑ*RÜ!ô+
ð —+‘+ˆCð �k‰kÐ%¨#¯,©,×*=Ñ*=×*IÑ*I×*RÑ*RÜ!õ+
ð ˆ�ð r;   c                 ó`   — t         €	 ddl} da t         S t         S # t        $ r
 da Y t         S w xY w)zCache for otel import check.Nr   TF)rL   Úopentelemetry.tracer¬  )Úopentelemetrys    r9   Ú_is_otel_availabler€  £	  s@   € ô Ðð	$Û&à"ˆOô ÐŒ?Ðøô ò 	$Ø#‰OÜÐð	$ús   ˆ š-¬-c                ó"  — | r| j                   j                  €yt        «       syddlm}m}m}m}m} ddl	m
}m}  || j                  «      } || j                  «      }	 |||	d ||j                  «       |«       ¬«      }
 ||
«      } ||«      S )zËCreate OpenTelemetry context manager if OTEL is enabled and available.

    Args:
        run_tree: The current run tree.

    Returns:
        Context manager for use_span or None if not available.
    Nr   )ÚNonRecordingSpanÚSpanContextÚ
TraceFlagsÚ
TraceStateÚuse_span)Úget_otel_span_id_from_uuidÚget_otel_trace_id_from_uuidF)Útrace_idÚspan_idÚ	is_remoteÚtrace_flagsÚtrace_state)r    Úotel_exporterr€  r~  r‚  rƒ  r„  r…  r†  Úlangsmith._internal._otel_utilsr‡  rˆ  r‰  r~   ÚSAMPLED)rV   r‚  rƒ  r„  r…  r†  r‡  rˆ  r‰  rŠ  Úspan_contextÚnon_recording_spans               r9   rä   rä   °	  s�   € ñ �x—‘×4Ñ4Ð<ØÜÔØ÷õ ÷ñ
 +¨8×+<Ñ+<Ó=€HÙ(¨¯©Ó5€GáØØØÙ˜z×1Ñ1Ó2Ù“Lô€Lñ *¨,Ó7ÐÙÐ&Ó'Ð'r;   )r6   r6  r7   rè   r¾   r6  )r¾   rà  )r¾   r£   )rV   ru  r¾   úGenerator[None, None, None])rF   r   r¾   rw  rÆ   )rl   zOptional[contextvars.Context]r¾   údict[str, Any])rC   rž   rD   r¤   rE   r¦   rF   r¥   r`   z@Optional[Union[run_trees.RunTree, Mapping, str, Literal[False]]]rG   z'Optional[Union[bool, Literal['local']]]r    r¨   rH   r©   rI   rž   r€   r   r¾   r“  )rŠ   r   r¾   z'TypeGuard[SupportsLangsmithExtra[P, R]])rŠ   úCallable[P, R]r�   rž   rF   rs  rE   r¦   r    r¨   r�   ú0Optional[Callable[[Sequence], Union[dict, str]]]rC   rž   rD   r¤   r‘   r½  r’   úOptional[Callable[..., dict]]r“   r¼  r¾   úSupportsLangsmithExtra[P, R])rŠ   r   r¾   rà  )rV   ru  rÀ   r¡   r€   r   r¾   z(Optional[schemas.ExtractedUsageMetadata])rŠ   r•  r¾   r˜  rq  ) rË   rr  r�   rž   rF   rs  rE   r¦   r    r¨   r�   r–  rC   rž   rD   r¤   r‘   r½  r’   r—  r“   r¼  rÇ   r½  rÈ   rà  rG   rK   rÉ   rt  r¾   z8Callable[[Callable[P, R]], SupportsLangsmithExtra[P, R]])r¼   r   r€   r   r¾   z/Union[Callable, Callable[[Callable], Callable]])rC   rž   r¾   rž   rd  )rC   rž   rD   r¤   r`   r£   r¾   ú,tuple[Optional[str], Optional[AgentAddress]])r†  z_addressing.Tierr¾   r”  )rC   rž   rD   r¤   r¾   ztuple[_addressing.Tier, ...])r®  r   r¾   r+   )rß   zBaseException | NonerÉ   rt  r¾   rž   )rÊ  r·  rÀ   úOptional[Any]rß   rv  r¾   rw  )rÐ   rŸ  r¹   r�   r¾   rŸ  )r¹   r�   rÔ   r¡   r¾   r£   )rX  r£   r¹   r�   r×   r9  r¾   r™  rx  )rŠ   r   r×   r9  r¹   r½   r¼   r   r€   r   r¾   r·  )
rÊ  r·  rÀ   rš  rß   rv  rÒ   r—  r¾   rw  )rŠ   r   r¾   rà  )r  úinspect.Signaturer¼   r   r€   r   r¾   r”  )r"  zinspect.ParameterrŠ   r¼  r¾   rà  )r  r›  rŠ   r¼  r¾   úset[str])r  r›  r¾   rœ  )r¾   rw  )
r  r›  r¼   r   rŠ   r¼  r€   r   r¾   z tuple[dict, schemas.Attachments])rl   r¥   )rö   re  rë   r·  r÷   rà  rø   ú	list[Any]r“   r¼  rÛ   rš  r¾   zGenerator[T, None, Any])rö   rr  rë   r·  r÷   rà  rì   rà  rø   r�  r“   r¼  rÛ   rš  r¾   zAsyncGenerator[T, None])rø   r€  r�   r   r¾   r   )r7   rè   )rV   r£   )”r°   Ú
__future__r   ræ   Ú
contextlibÚcontextvarsr0  rˆ   r™   râ  Ú	threadingrv   rS   Úcollections.abcr   r   r   r   r   r	   r
   r   Útypingr   r   r   r   r   r   r   r   r   r   r   r   r   r   r   Útyping_extensionsr   r   r   r   Úlangsmith._internal._contextÚ	_internalrN   Ú	langsmithr    r4  r!   r"   r#   Úlangsmith._internalr$   r%   rà   Úlangsmith._runtime_overridesr&   rå   Úlangsmith.addressr'   Úlangsmith.envr(   Úlangsmith.run_treesr)   Útypesr*   rª  r+   Ú	getLoggerr3   rZ   ræ  r5   r:   rA   rQ   ra   rc   rd   re   rf   rg   rh   ri   rJ   r±   r{  rL   rO   ÚcontextmanagerrX   r]   rp   rƒ   Úget_run_tree_contextr�   r–   r›   r�   r³   rµ   r·   rÄ   r•   r>  r}  rN  r‡  r�  r°  r7  r·  r9  r^  rÎ  rÑ  r|   rÞ  râ   r:  r†   rü  rÿ  r  r  Ú	lru_cacher  ÚWeakKeyDictionaryr  ÚLockr  r  r  r  r  rå  r   r  rû   r=  r?  r  r  rü   ré   r€  rä   r@   r;   r9   Ú<module>r´     s	  ðÚ 7å "ã Û Û Û Û Û Û Û Û Û ÷÷ ñ õ %÷÷ ÷ ÷ ñ ÷$ IÓ Hç /Ð /Ý )ß /Ñ /Ý +Ý 4õõ +Ý &Ý ,áÝ#å1à	ˆ×	Ñ	˜8Ó	$€Ø#Ð Ø1Ð ó
WóLð ×/Ñ/Ø×*Ñ*Ø× Ñ Ø�N‰NØ×"Ñ"Ø×(Ñ(Ø×ÑØ×#Ñ#Ø&×=Ñ=ñ
4€Ð0ó 
ð 3Ð à"&€�Ó &ó+ð ×Ñð3Øð3à ò3ó ð3ó(	ð .2ðØ*ðàóð0 ×Ñð #'Ø&*Ø $Ø)-ØOSØ7;Ø)-Ø=AØ+/ñY.àðY.ð $ðY.ð ð	Y.ð
 'ðY.ð MðY.ð 5ðY.ð 'ðY.ð ;ðY.ð )ðY.ð ðY.ð !òY.ó ðY.ðz ,Ð óð Ø,0Ø $Ø)-ØBFØ"&Ø&*Ø7;Ø59Ø(,ñØ
ðð ðð *ð	ð
 ðð 'ðð @ðð  ðð $ðð 5ðð 3ðð &ðð "óó>ôR�Y eõ RñB ˆC˜4Ô €ÙˆcƒN€ð ô˜X w¨q°!¨t¡}ó ó ðð6 #ñBàðBð ðBð ð	Bð
 .óBð 
ð'Ø
ð'à!ò'ó 
ð'ð
 
à%,ðCð Ø,0Ø $Ø)-ØBFØ"&Ø&*Ø7;Ø59Ø(,Ø>BØ).Ø"ØFJñ!CØ"ðCð ðCð *ð	Cð
 ðCð 'ðCð @ðCð  ðCð $ðCð 5ðCð 3ðCð &ðCð <ðCð #'ðCð ðCð  Dð!Cð" >ò#Có 
ðCð(q	Øðq	àðq	ð 5óq	÷h{7ñ {7ó|	ð" '+Ø*.ð'Øð'à#ð'ð (ð'ð 2ó	'ó"?ð KOðØðØ1Gðà!óó"p+òhÐ ôD˜)¨5õ Dô D�i uõ Dð(	,Øð	,àCð	,ð ó	,ð "Ø%)ð2AØ"ð2Aàð2Að #ð2Að 
ó	2Aójð "ð:Ø#ð:àð:ð !ó:ðzØ,ðà#ðð %ðð 2ó	ðB 15ØØðHØ
ðHà$ðHð .ðHð ð	Hð
 ðHð óHðZ "Ø%)Ø7;ð	FØ"ðFàðFð #ðFð 5ð	Fð
 
óFóD;ðØ ðØ),ðØ8;ðàóð(0Ø ð0Ø),ð0Ø8;ð0àó0ôð8 >BðØ ðØ(:ðàóð €×Ñ˜TÔ"ò4ó #ð4ð €G×ÒÓð ð ó  ð -˜iŸnšnÓ.Ð ð >BðØ ðØ(:ðàóó,7ð 'DÐ Ô #ð >Bð8Ø ð8Ø(:ð8àó8ð  $ñ4Ø ð4àð4ð ð4ð ð	4ð
 &ó4ô.ð4 +/ð0Øð0à&ð0ð ð0ð
 ð0ð &ð0ð (ð0ð ó0ðv +/ñEØðEà&ðEð ð	Eð
 ðEð ðEð &ðEð (ðEð óEñP ˆCƒL€ô9)˜ ™
ô 9)ôx1AÐ% w¨q¡zô 1Aôh7%Ð*¨G°A©Jô 7%ót	óó
ó'(ðV ×&Ñ&€Ø�‰€Ø×Ñ€	Ø×,Ñ,Ð Ø
×
Ñ
€Ø×4Ñ4Ñ r;   