
    i$0                       d dl m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mZmZ d dlmZ d dlmZmZ d dlmZ d dlZddlmZmZmZmZ  e
d	          Z e
d
eedf                   Z e
de	eef                   Z  e
dee                   Z! e
dedef                   Z"drdZ#dsdZ$dtd#Z%dud&Z&dvd(Z'dwd+Z(dxd-Z)dyd0Z*dzd2Z+d{d5Z,d|d7Z-d}d9Z.d~d;Z/dd=Z0d>d?d@ddEZ1ddGZ2ddJZ3 e
dK          Z4 e
dL          Z5eddN            Z6eddQ            Z6eddR            Z6ddTZ6ddVZ7ddXZ8ddZZ9dd\Z:dd^Z;dd`Z<ddbZ=dddZ>ddfZ?ddjZ@ddkZAdldmddoZBddqZCdS )    )annotationsN)	AnyTupleMappingTypeVarCallableIterableSequencecastoverload)Path)datedatetime)	TypeGuard   )OmitNotGiven	FileTypesHeadersLike_T_TupleT.)bound	_MappingT
_SequenceT	CallableTtIterable[Iterable[_T]]returnlist[_T]c                    d | D             S )Nc                    g | ]	}|D ]}|
S  r"   ).0sublistitems      a/home/agentuser/.hermes/hermes-agent/venv/lib/python3.11/site-packages/anthropic/_utils/_utils.py
<listcomp>zflatten.<locals>.<listcomp>"   s%    666Wg66dD6666    r"   )r   s    r&   flattenr)   !   s    666666r(   queryMapping[str, object]pathsSequence[Sequence[str]]list[tuple[str, FileTypes]]c          	     `    g }|D ](}|                     t          | |dd                     )|S )zRecursively extract files from the given dictionary based on specified paths.

    A path may look like this ['foo', 'files', '<array>', 'data'].

    Note: this mutates the given dictionary.
    r   Nindexflattened_key)extend_extract_items)r*   r,   filespaths       r&   extract_filesr7   %   sE     *,E O O^E4qMMMNNNNLr(   objobjectr6   Sequence[str]r1   intr2   
str | Nonec          	        	          }n# t           $ r t          |           sg cY S ddlm} J t	          |           rLg }| D ]C} ||rdz   nd           |                    dz   t          t          |          f           D|cY S  ||            t          t          |           fgcY S w xY wdz  t          |           rt	 t          d d          D                       r| 
                    |          }n| |         }n# t          $ r g cY S w xY w|n	d| d	z  t          |
          S t	          |           r%|dk    rg S t          fd| D                       S g S )Nr   )assert_is_file_content[] )key   c              3  "   K   | ]
}|d k    V  dS )<array>Nr"   )r#   ps     r&   	<genexpr>z!_extract_items.<locals>.<genexpr>[   s&      88a1	>888888r(   []r0   rD   c           	     D    g | ]}t          |dz   nd          S )Nr?   r0   )r4   )r#   r%   r2   r1   r6   s     r&   r'   z"_extract_items.<locals>.<listcomp>s   sV         :G:S-$"6"6Y]	    r(   )
IndexErroris_given_filesr>   is_listappendr   r   is_dictallpopKeyErrorr4   r)   )	r8   r6   r1   r2   rA   r>   r5   entryr%   s	    ```     r&   r4   r4   8   sP   75k 7 7 7}} 	III 	433333 (((3<< 	13E M M&&u-2_-$2F2F]_````md2DE4J4JKLLLLLLLs6666Y 4 456666'7* 
QJEs|| %
	 884<88888  wws||3x 	 	 	 III		
  MMZZZZ'M'	
 
 
 	
 
 
)I         

 

 
	
 Is-    B8A#B8%B87B8?D DD_T | NotGiven | OmitTypeGuard[_T]c                Z    t          | t                     ot          | t                     S N)
isinstancer   r   r8   s    r&   rK   rK      s'    #x(((FC1F1F-FFr(   TypeGuard[tuple[object, ...]]c                ,    t          | t                    S rW   rX   tuplerY   s    r&   is_tupler^          c5!!!r(   _TupleT | objectTypeGuard[_TupleT]c                ,    t          | t                    S rW   r\   rY   s    r&   
is_tuple_trc      r_   r(   TypeGuard[Sequence[object]]c                ,    t          | t                    S rW   rX   r
   rY   s    r&   is_sequencerg          c8$$$r(   _SequenceT | objectTypeGuard[_SequenceT]c                ,    t          | t                    S rW   rf   rY   s    r&   is_sequence_trl      rh   r(   TypeGuard[Mapping[str, object]]c                ,    t          | t                    S rW   rX   r   rY   s    r&   
is_mappingrp          c7###r(   _MappingT | objectTypeGuard[_MappingT]c                ,    t          | t                    S rW   ro   rY   s    r&   is_mapping_tru      rq   r(   TypeGuard[dict[object, object]]c                ,    t          | t                    S rW   )rX   dictrY   s    r&   rO   rO          c4   r(   TypeGuard[list[object]]c                ,    t          | t                    S rW   )rX   listrY   s    r&   rM   rM      ry   r(   TypeGuard[Iterable[object]]c                ,    t          | t                    S rW   )rX   r	   rY   s    r&   is_iterabler      rh   r(   r%   c                    t          |           r1t          t          d |                                 D                       S t	          |           rt          t          d | D                       S | S )zMinimal reimplementation of copy.deepcopy() that will only copy certain object types:

    - mappings, e.g. `dict`
    - list

    This is done for performance reasons.
    c                4    i | ]\  }}|t          |          S r"   deepcopy_minimal)r#   kvs      r&   
<dictcomp>z$deepcopy_minimal.<locals>.<dictcomp>   s'    IIIDAq,Q//IIIr(   c                ,    g | ]}t          |          S r"   r   )r#   rS   s     r&   r'   z$deepcopy_minimal.<locals>.<listcomp>   s!    CCCU)%00CCCr(   )rp   r   r   itemsrM   )r%   s    r&   r   r      so     $ KBIIDJJLLIIIJJJt}} EBCCdCCCDDDKr(   z, or)delimfinalseqr   strr   c                   t          |           }|dk    rdS |dk    r| d         S |dk    r| d          d| d| d          S |                    | d d                   d| d| d          z   S )Nr   r@   rB   r    )lenjoin)r   r   r   sizes       r&   
human_joinr      s    s88Dqyyrqyy1vqyya&++5++3q6+++::c#2#h"7e"7"7c"g"7"777r(   stringc                    d|  dS )zOAdd single quotation marks around the given string. Does *not* do any escaping.'r"   )r   s    r&   quoter      s    v===r(   variants Callable[[CallableT], CallableT]c                      d fd}|S )a4  Decorator to enforce a given set of arguments or variants of arguments are passed to the decorated function.

    Useful for enforcing runtime validation of overloaded functions.

    Example usage:
    ```py
    @overload
    def foo(*, a: str) -> str: ...


    @overload
    def foo(*, b: bool) -> str: ...


    # This enforces the same constraints that a static type checker would
    # i.e. that either a or b must be passed to the function
    @required_args(["a"], ["b"])
    def foo(*, a: str | None = None, b: bool | None = None) -> str: ...
    ```
    funcr   r   c                     t          j                   j        }d |                                D             t	          j                   d fd            }|S )Nc                B    g | ]\  }}|j         |j        |j        hv |S r"   )kindPOSITIONAL_ONLYPOSITIONAL_OR_KEYWORD)r#   nameparams      r&   r'   z0required_args.<locals>.inner.<locals>.<listcomp>   sL     
 
 
ez%+    r(   argsr9   kwargsr   c                 H  
 t                      
t          |           D ]g\  }}	 
                    |                    "# t          $ r9 t	          j         dt                     dt          |            d          d w xY w|                                D ]}
                    |           D ]!}t          
fd|D                       }|r nŌ"t                    dk    r t          d D                       }d| d}nt                    d	k    sJ t          t          d	                   
z
            }	t          |	          dk    rd
t          d |	D                        }ndt          |	d	                    }t	          |           | i |S )Nz	() takes z argument(s) but z were givenc              3      K   | ]}|v V  	d S rW   r"   )r#   r   given_paramss     r&   rF   z@required_args.<locals>.inner.<locals>.wrapper.<locals>.<genexpr>  s(      JJu4JJJJJJr(   rB   c                P    g | ]#}d t          d |D             d          z   dz   $S )(c                ,    g | ]}t          |          S r"   r   r#   args     r&   r'   zLrequired_args.<locals>.inner.<locals>.wrapper.<locals>.<listcomp>.<listcomp>  s    *I*I*I#5::*I*I*Ir(   and)r   ))r   )r#   variants     r&   r'   zArequired_args.<locals>.inner.<locals>.wrapper.<locals>.<listcomp>  sA    vvvbiz*I*I*I*I*IQVWWWWZ]]vvvr(   z,Missing required arguments; Expected either z arguments to be givenr   zMissing required arguments: c                ,    g | ]}t          |          S r"   r   r   s     r&   r'   zArequired_args.<locals>.inner.<locals>.wrapper.<locals>.<listcomp>  s    HgHgHgX[sHgHgHgr(   zMissing required argument: )set	enumerateaddrJ   	TypeError__name__r   keysrP   r   r|   r   )r   r   i_rA   r   matches
variationsmsgmissingr   r   
positionalr   s             @r&   wrapperz-required_args.<locals>.inner.<locals>.wrapper   s	   %(UUL!$    1  $$Z]3333!      #=kk3z??kkUXY]U^U^kkk   
 {{}} & &  %%%%# % %JJJJ'JJJKK E x==1$$!+vvmuvvv" "J lkkkCCx==1,,,, #3x{#3#3l#BCCG7||a''jZHgHg_fHgHgHg=h=hjjOE'!*<M<MOOnn$4((((s   AAB)r   r9   r   r9   r   r9   )inspect	signature
parametersr   	functoolswraps)r   paramsr   r   r   s   `  @r&   innerzrequired_args.<locals>.inner   s    "4((3
 
%||~~
 
 

 
		!	) !	) !	) !	) !	) !	) !	) 
	!	)F r(   )r   r   r   r   r"   )r   r   s   ` r&   required_argsr      s)    ,0 0 0 0 0 0d Lr(   _K_VNonec                    d S rW   r"   rY   s    r&   strip_not_givenr   &  s    (+r(   Mapping[_K, _V | NotGiven]dict[_K, _V]c                    d S rW   r"   rY   s    r&   r   r   *  s    FIcr(   c                    d S rW   r"   rY   s    r&   r   r   .  s    ,/Cr(   object | Nonec                h    | dS t          |           s| S d |                                 D             S )zHRemove all top-level keys where their values are instances of `NotGiven`Nc                D    i | ]\  }}t          |t                    ||S r"   )rX   r   r#   rA   values      r&   r   z#strip_not_given.<locals>.<dictcomp>:  s-    XXX:3Juh<W<WXCXXXr(   )rp   r   rY   s    r&   r   r   2  s;    
{tc?? 
XXXXXXr(   valc                $    t          | d          S )N
   )base)r;   r   s    r&   coerce_integerr   =  s    sr(   floatc                     t          |           S rW   )r   r   s    r&   coerce_floatr   A  s    ::r(   boolc                &    | dk    p| dk    p| dk    S )Ntrue1onr"   r   s    r&   coerce_booleanr   E  s    &=5C3J5#+5r(   
int | Nonec                (    | d S t          |           S rW   )r   r   s    r&   maybe_coerce_integerr   I      
{t#r(   float | Nonec                (    | d S t          |           S rW   )r   r   s    r&   maybe_coerce_floatr   O  s    
{tr(   bool | Nonec                (    | d S t          |           S rW   )r   r   s    r&   maybe_coerce_booleanr   U  r   r(   prefixc                ^    |                      |          r| t          |          d         S | S )zXRemove a prefix from a string.

    Backport of `str.removeprefix` for Python < 3.9
    N)
startswithr   )r   r   s     r&   removeprefixr   [  s4    
    %c&kkmm$$Mr(   suffixc                `    |                      |          r| dt          |                    S | S )zXRemove a suffix from a string.

    Backport of `str.removesuffix` for Python < 3.9
    N)endswithr   )r   r   s     r&   removesuffixr   e  s4    
 v &nVn%%Mr(   r   c                    t          |                                           }t          j                            |           }||fS rW   )r   
read_bytesosr6   basename)r6   contents	file_names      r&   file_from_pathr   o  s9    Dzz$$&&H  &&Ix  r(   headersr   headerc                   |                                 }t          |           rK|                                 D ]6\  }}|                                 |k    rt          |t                    r|c S 7t          j        dd |                                          }|||                                |fD ]}| 	                    |          }|r|c S t          d| d          )Nz([^\w])(\w)c                |    |                      d          |                      d                                          z   S )NrB   r   )groupupper)pats    r&   <lambda>z%get_required_header.<locals>.<lambda>~  s,    #))A,,STI[I[I]I]:] r(   zCould not find z header)lowerru   r   rX   r   resub
capitalizer  get
ValueError)r   r   lower_headerr   r   intercaps_headernormalized_headerr   s           r&   get_required_headerr  u  s    <<>>LG MMOO 	 	DAqwwyyL((Z3-?-?( vn.].]_e_p_p_r_rss$lFLLNNDTU  -.. 	LLL	 6v666
7
77r(   c                 L    	 t          j                    S # t          $ r Y dS w xY w)Nfalse)sniffiocurrent_async_library	Exceptionr"   r(   r&   get_async_libraryr    s8    ,...   wws    
##   maxsizer  c                V    t          j        |           }t          t          |          S )zmA version of functools.lru_cache that retains the type signature
    for the wrapped function arguments.
    r  )r   	lru_cacher   r   )r  r   s     r&   r  r    s0     !  G Wr(   datac                :   t          |           rd |                                 D             S t          |           r.t          | t          t
          t          f          sd | D             S t          | t          t          f          r| 	                                S | S )zvTranslates a mapping / sequence recursively in the same fashion
    as `pydantic` v2's `model_dump(mode="json")`.
    c                N    i | ]"\  }}t          |          t          |          #S r"   	json_safer   s      r&   r   zjson_safe.<locals>.<dictcomp>  s,    PPPZS%	#	% 0 0PPPr(   c                ,    g | ]}t          |          S r"   r  )r#   r%   s     r&   r'   zjson_safe.<locals>.<listcomp>  s    111D	$111r(   )
rp   r   r   rX   r   bytes	bytearrayr   r   	isoformat)r  s    r&   r   r     s     $ QPP4::<<PPPP4 2D3y2I!J!J 211D1111$4())  ~~Kr(   )r   r   r   r   )r*   r+   r,   r-   r   r.   )
r8   r9   r6   r:   r1   r;   r2   r<   r   r.   )r8   rT   r   rU   )r8   r9   r   rZ   )r8   r`   r   ra   )r8   r9   r   rd   )r8   ri   r   rj   )r8   r9   r   rm   )r8   rr   r   rs   )r8   r9   r   rv   )r8   r9   r   rz   )r8   r9   r   r}   )r%   r   r   r   )r   r:   r   r   r   r   r   r   )r   r   r   r   )r   r:   r   r   )r8   r   r   r   )r8   r   r   r   )r8   r9   r   r9   )r8   r   r   r9   )r   r   r   r;   )r   r   r   r   )r   r   r   r   )r   r<   r   r   )r   r<   r   r   )r   r<   r   r   )r   r   r   r   r   r   )r   r   r   r   r   r   )r6   r   r   r   )r   r   r   r   r   r   )r   r   )r  r   r   r   )r  r9   r   r9   )D
__future__r   r   r  r   r   typingr   r   r   r   r   r	   r
   r   r   pathlibr   r   r   typing_extensionsr   r  _typesr   r   r   r   r   r9   r   r   r   r   r   r)   r7   r4   rK   r^   rc   rg   rl   rp   ru   rO   rM   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r  r  r  r   r"   r(   r&   <module>r*     s   " " " " " " 				 				     
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
       # # # # # # # # ' ' ' ' ' '  ; ; ; ; ; ; ; ; ; ; ; ;WT]]
')5#5
6
6
6GKwsF{';<<<	W\&)9:::
GKxS'9:::	7 7 7 7   &G G G GTG G G G" " " "" " " "% % % %% % % %$ $ $ $$ $ $ $! ! ! !! ! ! !% % % %     48d 8 8 8 8 8 8   
H H H HV WT]]WT]] 
 + + + 
 + 
 I I I 
 I 
 / / / 
 /Y Y Y Y      6 6 6 6               ! ! ! !8 8 8 8&    (+           r(   