Ë
    ñÏjÎ%  ã                  ó*  — d Z ddlmZ ddlZddlZddlmZmZmZm	Z	m
Z
 ddlmZmZmZ ddlmZ g d¢Z ej$                  d«      Zd	Z ej$                  d
ej*                  «      Z ej$                  d«      Z G d„ ded¬«      Ze
 G d„ de«      «       Z G d„ dej4                  «      Z ej8                  d¬«       G d„ d«      «       Z ej8                  d¬«       G d„ d«      «       Z ej8                  d¬«       G d„ d«      «       Zdd„Z d d„Z!d!d„Z"y)"a,  Addresses that name features that hold traces in a tracing project.

!!! warning "Beta"
    Addressing runs to an agent is enabled per workspace. A workspace without
    it rejects the runs, so tracing is lost rather than falling back to a
    project. This API may change without notice.

An `Address` names the tracing project of a feature: an `AgentAddress`'s
environment, an `ExperimentAddress`, or the workspace's `EvaluatorAddress` traces.
Query APIs resolve an address to its project (`client.sessions.resolve`). Only an
`AgentAddress` can receive traces, so tracing entry points take an `AgentAddress`,
and anything else is rejected.
The environment of an agent is one of `local`, `development`, `staging` or
`production`, and is always lowercase.

Example:
    ```python
    import langsmith as ls

    support = ls.AgentAddress(id="customer-support", environment="production")


    @ls.traceable(address=support)
    def handle(order): ...


    with ls.tracing_context(address=ls.AgentAddress("customer-support", "staging")):
        handle(order)
    ```
é    )ÚannotationsN)ÚAnyÚOptionalÚProtocolÚcastÚruntime_checkable)ÚLiteralÚRequiredÚ	TypedDict)Úutils)ÚAddressÚAgentAddressÚ
ApiAddressÚEvaluatorAddressÚEnvAddressErrorÚExperimentAddressz![a-z](?:[a-z0-9-]{0,61}[a-z0-9])?)ÚlocalÚdevelopmentÚstagingÚ
productionz<[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}z'lrn:agents/([^/]+)/environments/([^/]+)c                  ó0   — e Zd ZU dZded<   ded<   ded<   y)	r   z8(beta) An address as `client.sessions.resolve` takes it.z5Required[Literal['AGENT', 'EXPERIMENT', 'EVALUATOR']]ÚkindÚstrÚidz8Literal['LOCAL', 'DEVELOPMENT', 'STAGING', 'PRODUCTION']ÚenvironmentN)Ú__name__Ú
__module__Ú__qualname__Ú__doc__Ú__annotations__© ó    úN/var/www/html/gaurav-v2/venv/lib/python3.12/site-packages/langsmith/address.pyr   r   ?   s   … ÙBà
?Ó?ØƒGØIÔIr"   r   F)Útotalc                  ó   — e Zd ZdZdd„Zy)r   z@(beta) Names the tracing project of a feature, such as an agent.c                 ó   — y)z-Return the address as the query APIs take it.Nr!   ©Úselfs    r#   Úto_api_addresszAddress.to_api_addressK   s   € àr"   N©Úreturnr   ©r   r   r   r   r)   r!   r"   r#   r   r   G   s
   „ áJôr"   r   c                  ó   — e Zd ZdZy)r   a  (beta) The `LANGSMITH_AGENT_*` / project env vars can't address a run.

    Raised for half an address, an invalid one, or an address beside a project.
    Tracing entry points (`@traceable`, `trace`, `tracing_context`,
    `create_run`) catch it, log it and leave the call untraced, so a bad
    environment never breaks the code being traced. Explicit ingestion calls
    (`batch_ingest_runs`, `multipart_ingest`) let it raise for runs that name no
    destination, rather than drop part of a batch the caller built.
    N)r   r   r   r   r!   r"   r#   r   r   P   s   „ òr"   r   T)Úfrozenc                  ób   — e Zd ZU dZded<   ded<   dd„Zdd„Zedd„«       Zdd„Z	edd	„«       Z
y
)r   a²  (beta) The address of an agent's environment.

    Args:
        id: The agent's ID: 1 to 63 lowercase ASCII letters, digits or
            hyphens, starting with a letter and ending with a letter or digit.
            The server creates the agent on first use.
        environment: One of `local`, `development`, `staging` or `production`, in any
            case.

    Raises:
        LangSmithUserError: If a value is invalid.
    r   r   r   c                óØ  — t        | j                  t        «      rt        j	                  | j                  «      s#t        j                  d| j                  ›d�«      ‚t        | j                  t        «      r| j                  j                  «       nd}|t        vr9t        j                  ddj                  t        «      › d| j                  ›d�«      ‚t        j                  | d|«       y)	z2Validate the fields and lowercase the environment.z‡Address agent id must be 1 to 63 lowercase ASCII letters, digits, or hyphens, start with a letter, and end with a letter or digit, got z$. Use an id such as 'support-agent'.Nz#Address environment must be one of ú, z, got Ú.r   )Ú
isinstancer   r   Ú_AGENT_ID_PATTERNÚ	fullmatchr   ÚLangSmithUserErrorr   ÚlowerÚ_ENVIRONMENTSÚjoinÚobjectÚ__setattr__)r(   r   s     r#   Ú__post_init__zAgentAddress.__post_init__n   sÑ   € ä˜$Ÿ'™'¤3Ô'Ô/@×/JÑ/JÈ4Ï7É7Ô/SÜ×*Ñ*ðà—w‘w�kÐ!EðGóð ô )3°4×3CÑ3CÄSÔ(IˆD×Ñ×"Ñ"Ô$Ètð 	ð œmÑ+Ü×*Ñ*Ø5°d·i±iÄÓ6NÐ5Oð PØ×'Ñ'Ð*¨!ð-óð ô 	×Ñ˜4 °Õ<r"   c                ó:   — d| j                   › d| j                  › �S )zFReturn `lrn:agents/{id}/environments/{environment}`. Wire format only.zlrn:agents/z/environments/)r   r   r'   s    r#   Ú_lrnzAgentAddress._lrn€   s    € à˜TŸW™W˜I ^°D×4DÑ4DÐ3EÐFÐFr"   c                ó¤   — t        |t        «      rt        j                  |«      nd}|€t	        j
                  d«      ‚ | |j                  «       Ž S )a  Parse an LRN read from the wire, such as a `baggage` header.

        The value is untrusted, so it is not echoed in the error.

        Raises:
            LangSmithUserError: If `value` is not an agent LRN, or names an
                invalid id or environment.
        NzNot an agent address.)r3   r   Ú_LRN_PATTERNr5   r   r6   Úgroups)ÚclsÚvalueÚmatchs      r#   Ú	_from_lrnzAgentAddress._from_lrn„   sG   € ô 2<¸EÄ3Ô1G”×&Ñ& uÔ-ÈTˆØˆ=Ü×*Ñ*Ð+BÓCÐCÙ�E—L‘L“NÐ#Ð#r"   c                óf   — t        dd| j                  | j                  j                  «       dœ«      S )z5Return this agent as the address the query APIs take.r   ÚAGENT)r   r   r   )r   r   r   Úupperr'   s    r#   r)   zAgentAddress.to_api_address“   s/   € äØØ D§G¡G¸D×<LÑ<L×<RÑ<RÓ<TÑUó
ð 	
r"   c                óÂ  — t        «       }t        |j                  «       «      sy|j                  «       D ��cg c]
  \  }}|rŒ	|‘Œ }}}	 |r(t	        j
                  ddj                  |«      › d�«      ‚ | |j                  «       Ž S c c}}w # t        j
                  $ r=}dj                  d„ |j                  «       D «       «      }t        d|› d|› �«      |‚d}~ww xY w)	a  Read the agent named by the `LANGSMITH_AGENT_*` env vars.

        Reads `LANGSMITH_AGENT_ID` and `LANGSMITH_AGENT_ENVIRONMENT`, and
        returns `None` if neither is set.

        Raises:
            EnvAddressError: If only one is set, or a value is invalid.
        NzAn address needs z and z	 as well.r1   c              3  ó6   K  — | ]  \  }}|sŒ	|› d |›�–— Œ y­w)Ú=Nr!   )Ú.0ÚnamerC   s      r#   Ú	<genexpr>z(AgentAddress.from_env.<locals>.<genexpr>¯   s%   è ø€ ð  Ù7E©¨¨eÊ�4�&˜˜%˜Ô#±~ùs   ‚
�z4The LANGSMITH_AGENT_* env vars can't address a run (z): )Ú
env_valuesÚanyÚvaluesÚitemsr   r6   r9   r   )rB   rQ   rM   rC   ÚmissingÚeÚpresents          r#   Úfrom_envzAgentAddress.from_envš   sã   € ô “ˆÜ�6—=‘=“?Ô#ØØ+1¯<©<¬>ÔG©>™K˜D %Â’4¨>ˆÑGð	ÙÜ×.Ñ.Ø'¨¯©°WÓ(=Ð'>¸iÐHóð ñ ˜Ÿ™›Ð(Ð(ùó Høô ×'Ñ'ò 	Ø—i‘iñ  Ø7=·|±|´~ó ó ˆGô "ØFÀwÀiÈsÐSTÐRUÐVóàðûð		ús#   ¸
BÁBÁ<B ÂCÂ!8CÃCN©r+   ÚNone)r+   r   )rC   r   r+   r   r*   )r+   zOptional[AgentAddress])r   r   r   r   r    r<   r>   ÚclassmethodrE   r)   rV   r!   r"   r#   r   r   \   sL   … ñð 	ƒGØÓó=ó$Gð ò$ó ð$ó
ð òó ñr"   r   c                  ó,   — e Zd ZU dZded<   dd„Zdd„Zy)	r   zÝ(beta) The tracing project of an experiment, by its id.

    Query APIs take it; it cannot be sent traces.

    Args:
        id: The experiment's UUID.

    Raises:
        LangSmithUserError: If `id` is not a UUID.
    r   r   c                ó  — t        | j                  t        «      rt        j	                  | j                  «      s#t        j                  d| j                  ›d�«      ‚t        j                  | d| j                  j                  «       «       y)z!Validate the id and lowercase it.zbAn experiment id must be a UUID with hyphens, such as '0190c3d4-0000-7000-8000-0000000000b1', got r2   r   N)
r3   r   r   Ú_UUID_PATTERNr5   r   r6   r:   r;   r7   r'   s    r#   r<   zExperimentAddress.__post_init__Æ   sh   € ä˜$Ÿ'™'¤3Ô'¬}×/FÑ/FÀtÇwÁwÔ/OÜ×*Ñ*ð?Ø?C¿w¹w¸kÈðLóð ô 	×Ñ˜4  t§w¡w§}¡}£Õ7r"   c                ó4   — t        dd| j                  dœ«      S )z:Return this experiment as the address the query APIs take.r   Ú
EXPERIMENT)r   r   )r   r   r'   s    r#   r)   z ExperimentAddress.to_api_addressÏ   s   € ä�L¨<¸t¿w¹wÑ"GÓHÐHr"   NrW   r*   )r   r   r   r   r    r<   r)   r!   r"   r#   r   r   ·   s   … ñ	ð 	ƒGó8ôIr"   r   c                  ó   — e Zd ZdZdd„Zy)r   z§(beta) The tracing project of the workspace's evaluators.

    Evaluator traces share one project per workspace. Query APIs take it; it
    cannot be sent traces.
    c                ó   — t        dddi«      S )z'Return the address the query APIs take.r   r   Ú	EVALUATOR)r   r'   s    r#   r)   zEvaluatorAddress.to_api_addressÜ   s   € ä�L 6¨;Ð"7Ó8Ð8r"   Nr*   r,   r!   r"   r#   r   r   Ô   s   „ ñô9r"   r   c                óÊ   — t        | t        «      r| S t        | t        «      r)t        | t        «      st	        j
                  d| ›d�«      ‚t	        j
                  d| ›d�«      ‚)a-  Return `address` if it is an `AgentAddress`: the only address that takes traces.

    The one place an address given to a tracing entry point is checked; the SDK
    then carries it as is. A string is not an address.

    Raises:
        LangSmithUserError: If `address` is not an `AgentAddress`.
    z/Only an `AgentAddress` can receive traces, got r2   zUAn address must be an `AgentAddress` such as `ls.AgentAddress(id, environment)`, got )r3   r   r   r   r   r6   ©Úaddresss    r#   Úensure_agentre   á   sl   € ô �'œ<Ô(ØˆÜ�'œ7Ô#¬J°wÄÔ,DÜ×&Ñ&Ø=¸g¸[ÈÐJó
ð 	
ô ×
"Ñ
"ð	3Ø3:°+¸Qð	@óð r"   c                óx   — t        | t        «      rt        | t        «      s| S t        j                  d| ›d�«      ‚)aC  Return `address` if it is an `Address` of any kind, as a lookup takes it.

    For the calls that only resolve an address to its project, such as
    `get_run_url`. Whatever receives traces takes `ensure_agent`. A string is
    not an address.

    Raises:
        LangSmithUserError: If `address` is not an `Address`.
    zUAn address must be an `AgentAddress`, `ExperimentAddress` or `EvaluatorAddress`, got r2   )r3   r   r   r   r6   rc   s    r#   Úensure_addressrg   ö   s@   € ô �'œ7Ô#¬J°wÄÔ,DØˆÜ
×
"Ñ
"ð	#Ø#* +¨Qð	0óð r"   c                 ó^   — dD � ci c]  } d| › �t        j                  | d¬«      “Œ c} S c c} w )zIReturn each `LANGSMITH_AGENT_*` env var an address reads, with its value.)ÚAGENT_IDÚAGENT_ENVIRONMENTÚ
LANGSMITH_)Ú	LANGSMITH)Ú
namespaces)r   Úget_env_var)rM   s    r#   rO   rO     sB   € ñ 6óá5ˆDð �T�FÐœU×.Ñ.¨tÀÔOÑOØ5ñð ùò s   …"*)rd   r   r+   r   )rd   r   r+   r   )r+   zdict[str, Optional[str]])#r   Ú
__future__r   ÚdataclassesÚreÚtypingr   r   r   r   r   Útyping_extensionsr	   r
   r   Ú	langsmithr   Ú__all__Úcompiler4   r8   Ú
IGNORECASEr\   r@   r   r   r6   r   Ú	dataclassr   r   r   re   rg   rO   r!   r"   r#   Ú<module>ry      s7  ðñõ> #ã Û 	ß CÕ Cç :Ñ :å ò€ð �B—J‘JÐCÓDÐ ØA€ð �—
‘
ØCÀRÇ]Á]ó€ð ˆr�z‰zÐDÓE€ôJ� %õ Jð ôˆhó ó ðô	�e×.Ñ.ô 	ð €×Ñ˜dÔ#÷Wð Wó $ðWðt €×Ñ˜dÔ#÷Ið Ió $ðIð8 €×Ñ˜dÔ#÷	9ð 	9ó $ð	9óó*ô$r"   