"> !!/ ==J LLW:CUWW   #  F<<>> ! LLL =!==>>>  :=::;;;CMCCDD!K Ls BD51BD55 F%?A!F  F%ceZdZdZdedeedeedeedee dee dee d ee d e fd Zd e d efdZded efdZded efdZ d(deedzdeedzd eefdZded edzfdZde d efdZdee efd ee efdzfdZdee efdzd ee effdZ d)dedee efd e!e dzd e!e fd!Z"d"eed#edzdee efd ee effd$Z#d%ee efdee efd ee effd&Z$d ee%fd'Z&dS)*r-z[Unified parser for OpenAPI schemas with generic type parameters to handle both 3.0 and 3.1.r% reference_cls schema_cls parameter_clsrequest_body_cls response_cls operation_cls path_item_clsr9c ||_||_||_||_||_||_||_||_| |_dS)z?Initialize the parser with the OpenAPI schema and type classes.N) r%rBrCrDrErFrGrHr9) selfr%rBrCrDrErFrGrHr9s r?__init__zOpenAPIParser.__init__{sP *$* 0(**.param_inr#cN|dvr|Std|ddS)z@Convert string parameter location to our ParameterLocation type.)pathqueryheadercookiezUnknown parameter location: z, defaulting to 'query'rP)r+warning)rJrMs r?_convert_to_parameter_locationz,OpenAPIParser._convert_to_parameter_locations6 < < <OWhWWWXXXwrLitemc`t||jr|j}t|ts|S |dst d||dd}|j}|D]1}| r+t|tr|t|}nt|tr||j jvrt||d}n|jr||jvr|j|}n|dkrt#|dr|j}nft#||rt||d}nDd}nAt|t&r||}nt d|d|d|t d |d |d3t||jr||S|S#t,t.t0t2t f$r}t d |d ||d}~wwxYw|S) z.Resolves a reference to its target definition.z#/z/External or non-local reference not supported: /N componentszCannot traverse part 'z' in reference ''zReference part 'z' not found in path 'zFailed to resolve reference '': ) isinstancerBrefstrr(r8stripsplitr%isdigitlistintr __class__ model_fieldsgetattr model_extrahasattrrXdictr' _resolve_refAttributeErrorKeyError IndexError TypeError)rJrUref_strpartstargetpartr=s r?rizOpenAPIParser._resolve_refs dD. / /1 YhGgs++  , Y))$//$S'SS d++11#66!D||~~*VT*B*B!'D !2#FI666#3#@@@%,VT4%@%@FF#/ .DF#a&&HH LLAaAAEL R R RIIIIII    LLAaAAEL R R RIIIIII s0BB D%2CD D* D DDNoperation_paramspath_item_paramsc Rg}i}|pg|pgz}|D]} ||}t||js,tdt |dZ|j}ddlm} t|| r|j n|} | | } |j } |j | f} | |vrd|| <i}| ra| | }|| }t||js!t|dr|j |j|d<nt|dr|jrt%t'|jd}|r~t|d rn|jrg|j}| |}||}t||js!t|dr|j |j|d<t-|d d}t-|d d}t/|j | |j||j|| }||=#t6$rM}t-|d t-|dd}td|d|dYd}~d}~wwxYw|S)zY (8'I ,0,H,H,V,V)150A0A,0O0O- *+@$BT U UY '(=y I IY!6 = I;P;X-i8")Y== 7D99+"+&/, ) 5# !'' 3333   $ &',y*Q*Q  FJFF1FFQV   s'AI *AI :FI  J$AJJ$request_body_or_refc|sdS ||}t||js-tdt |ddSt |j|j}t|dr|j r|j D]\}}|rt|dr|j r | |j }||j|<D#t$r<}dt!|vrtd|d |Yd}~d}~wt$$r*}td|d |Yd}~d}~wwxYw|S#t$rP}dt!|vrt'|d d }td |d |d Yd}~dSd}~wt$$r>}t'|d d }td |d |d Yd}~dSd}~wwxYw)z-Extract and resolve request body information.Nz*Expected RequestBody after resolving, got z. Returning None.)rrrrrx)Failed to extract schema for media type 'rZr\rz Failed to extract request body 'Fry)rir[rEr+rSr|rrrrgritemsrrcontent_schemar8r]r6r}re) rJr request_bodyrequest_body_infomedia_type_strmedia_type_obj schema_dictr=ref_names r?_extract_request_bodyz#OpenAPIParser._extract_request_bodySs" 4; ,,-@AALlD,ABB flASASffft!0%.(4!!!  |Y// L4H 6B6J6P6P6R6R2NN&#N4GHH+< *.*F*F . @++K!,.<^LL *NRU !SS  !&"LL bN b b_` b b )"LL bN b b_` b b % $   >#a&&HH2E9EEH LLC8CCCCe    44444   2E9EEH LLC8CCCCe    44444  shAE*A)E*$C,+E*, E$62D-(E*- E$: EE*E$$E** H 4AF?? H  3HH  status_codec t|}d|cxkodkncS#ttf$r|dvcYSwxYw)z>Check if a status code represents a successful response (2xx).i,)r2xx)rbr8rmlower)rJrcode_ints r?_is_success_status_codez%OpenAPIParser._is_success_status_codest =;''H(((((S(((( (I& = = =$$&&*<< < < < =s!'A  A operation_responsesc|sdSgd}|D]}||vr |||fcS|D] \}}||r||fcS!dS)zTGet the primary success response for an MCP tool. We only need one success response.N)200201202204207)rr)rJrpriority_codescoder resp_or_refs r?_get_primary_success_responsez+OpenAPIParser._get_primary_success_responses# 4=<<# 9 9D***1$78888+)<(A(A(C(C 2 2 $K++K88 2#[1111 2trLc i}|s|S||}|std|S|\}}td| ||}t ||js0td|dt|d|St|j }t|drY|j rQ|j D]6\}} | r-t| dr| j r d } | j } t | |jrL| j} t | t r0| d r| d d } || } | r| | d <| |j|<#t*$r?}dt!|vrtd|d|d|Yd }~d }~wt.$r.}td|d|d|Yd }~.d }~wwxYw8||t!|<n#t*$rR}dt!|vrt1|dd}td|d|d|dYd }~nPd }~wt.$r@}t1|dd}td|d|d|dYd }~nd }~wwxYw|S)zcExtract and resolve response information. Only includes the primary success response for MCP tools.z;No success responses found, tool will have no output schemaz Using primary success response: z2Expected Response after resolving for status code z, got z. Returning empty responses.)rrrN#/components/schemas/rWx-fastmcp-top-level-schemarxrz' in response : r\rz+Failed to extract response for status code z from reference 'rZFry)rr+r,rir[rFrSr|rrrgrrrrBr\r]r(r_rrr8r6r}re)rJrextracted_responsesprimary_responserrresponse resp_inforrtop_level_schema_namerrnrr=rs r?_extract_responsesz OpenAPIParser._extract_responsess8:" '& & ==>QRR ' LLV W W W&  [ E EEFFFH ((55Hh(9:: +HHH>>HHH+*%1EFFFIx++' 0@' 6>6F6L6L6N6N&&2NN&%#N4GHH%+<% 481+9+KL),8JKKS*6*:#-gs#;#;!S@R@R$;A"A"!S=DMM#?!B!B )"LL!BN!B!B/:!B!B>?!B!B 5> K 0 0 1 1   >#a&&HH{E9==H LL4k44#+440144             {E9==H LL4k44#+440144          #"sjAI 7A)I !BF21I 2 H1<5G61I 6 H1#H,&I ,H11I K-AJ  K--6K((K-r all_schemas collectedcPtfd|S)al Extract all schema names referenced by a schema (including transitive dependencies). Args: schema: The schema to analyze all_schemas: All available schema definitions collected: Set of already collected schema names (for recursion) Returns: Set of schema names that are referenced Nct|trd|vrt|dtrk|d}|dr|dd}ndS.|vr*|vr&|||D] }|dSt|tr|D]}|dSdS)z%Recursively find all $ref references.z$ref)z#/$defs/rrWrN)r[rhr]r(r_addrra)objr\ schema_namerrUrr find_refss r?rz=OpenAPIParser._extract_schema_dependencies..find_refs's(#t$$ $S==ZF S%A%A=f+C~~&KLL&)iinnR&8 "-'y88';66! k222! +k":;;;!ZZ\\%%EIe$$$$%%C&& $$$DIdOOOO $ $$$rL)set)rJrrrrs ``@r?_extract_schema_dependenciesz*OpenAPIParser._extract_schema_dependenciessQ"  I $ $ $ $ $ $ $8  &rL parametersrcTt}|D]9}|jr0||j}||:|rN|jrG|jD]-}||}||.fd|DS)aZ Extract only the schema definitions needed for input (parameters and request body). Args: parameters: Route parameters request_body: Route request body all_schemas: All available schema definitions Returns: Dictionary containing only the schemas needed for input c*i|]}|v||Sr.0rrs r? zDOpenAPIParser._extract_input_schema_dependencies..f1   (,$+BUBUD+d#BUBUBUrL)rschema_rupdaterr)rJrrrneeded_schemasparamdepsrs ` r?"_extract_input_schema_dependenciesz0OpenAPIParser._extract_input_schema_dependenciesFs"  , ,E} ,88 TT%%d+++  ,L7 ,"."="D"D"F"F , ,88UU%%d++++    0>    rL responsesc|rsiSt}|D]}|js |jD]}||}|||d}t |tr7|vr3|||||fd|DS)a Extract only the schema definitions needed for outputs (responses). Args: responses: Route responses all_schemas: All available schema definitions Returns: Dictionary containing only the schemas needed for outputs r)rc*i|]}|v||Srrrs r?rzEOpenAPIParser._extract_output_schema_dependencies..rrL) rrrrrr'r[r]r)rJrrrrrrrs ` r?#_extract_output_schema_dependenciesz1OpenAPIParser._extract_output_schema_dependenciesjs2   I#&55!((**  H* "*"9"@"@"B"B  88UU%%d+++,001MNN k3//K;4N4N"&&{33355#K0#"06     0>    rLc g}t|jdr |jjstdgSi}t|jdr|jjr|jj}t|dr|jr|jD]\}} t||j r.| |}| |||<n| |||<b#t$r*}td|d|Yd}~d}~wwxYw|rA|D],\}}t|trt|||<-|jjD]\}} t| |js/td|d t!| d Jt| d r| jnd} gd } | D]} t%| | d} | rt| |jr| } |t%| d d| }|t%| d d}|t%| dd}i}t| dr*| jr#d| jD}||||}|||}t7||t%| ddt%| ddt%| ddt%| dgpg|||||||j } t;|d\}}||_||_nK#t$r>}td|d|d|did|_i|_Yd}~nd}~wwxYw| |#tB$rV}dtE|vrt%| dd}t#d|d|d |d!|d"#Yd}~Xd}~wt$rD}t%| dd}t#d|d|d |d!|d"#Yd}~d}~wwxYwt$d$tK|d%|S)&z*Parse the OpenAPI schema into HTTP routes.pathsz$OpenAPI schema has no paths defined.rXschemasz%Failed to extract schema definition 'rZNz%Skipping invalid path item for path 'z ' (type: )r)r'putpostdeleteoptionsheadpatchtrace requestBodyrrfcDi|]\}}|d||S)zx-)r()rkvs r?rz'OpenAPIParser.parse..s@***$(Aq#$<<#5#5* !1***rL operationIdsummaryrtags) rOmethod operation_idrrrrrrrequest_schemasresponse_schemas extensionsr9F) convert_refsz)Failed to pre-calculate schema for route  robject)r| propertiesrxrzFailed to process operation z (ID: z): TryzFinished parsing. Extracted z HTTP routes.)&rgr%rr+rSrXrrr[rBrirr}rhrrHr|rrerGupperrrrrfrrrr9rflat_param_schema parameter_maprr8r]r6r,len)rJroutesschema_definitionsrXrrr~r=path_str path_item_objpath_level_params http_methods method_lower operation method_upperrrrr input_schemasoutput_schemasroute flat_schema param_map schema_errorop_errorop_ids r?r5zOpenAPIParser.parses"$t|W-- T\5G  NNA B B BI  4< . . 4<3J 0Jz9-- *2D $.$6$<$<$>$>LD& %fd.@AA.2.?.?.G.GO7;7S7S /88.t448<7S7S &88.t4%PDPPQPP  N 2 8 8 : : N N ffd++N/Ef/M/M&t,(,|'9'?'?'A'As s  #HmmT-?@@ eHeetTaObObeee=,77 ((    L!-[ [  #M<FF XIt7I!J!JX#/#5#5#7#7LT%)%=%=#I|TBBDU&& -1,F,F#I}dCC--)%)$;$;#I{DAA%% &( "9m<<AV**,5,A,G,G,I,I***J)-(O(O&-.)) *.)Q)Q%.** !*!)#/)0M4)P)P$+Iy$$G$G(/ =$(O(O!(FB!?!?!E2'1):&/,9-;'1,0,@!!!"55T %-26662K7BE32;E//( 5 5 5"NN uL u u[c u ugs u u )1.077E335E////// 5 e,,,,%   Jc$OO" ' =) L L n<nn(nnZ_nndlnn%)%% ' =) L L n<nn(nnZ_nndlnn%)%m[ z  NCKKNNNOOO si%AD D5 D00D5D5O?:"NO? O%'4O O? O%%O?? R+ A Q R+'9R&&R+)NN)N)'__name__ __module__ __qualname____doc__rr|rrrrrr r!r]rKrrTrrirrrarrrrboolrrhtuplerrrrrrrrr5rrLr?r-r-msZfe//J'/M / J' / |, /9o/J'/I/////.s?P555555n#*D.2-1a a s)d*a s)d*a  m  a a a a F@@SWAW@@@@D=3=4====#'S> sCx4 .\##'S>D#8\# c< \#\#\#\#D&* 111#s(^1s8d? 1 S 1111f" '" &," #s(^ " c3h " " " " H' \)*' #s(^'  c3h ' ' ' ' R[tI[[[[[[rLr-r@N)6rtypingrrropenapi_pydanticrrrr r r r r openapi_pydantic.v3.v3_0r)r3r0r4r.r1r2r/pydanticrrfastmcp.utilities.loggingrmodelsrrrrrrrrrrr+rrrrrrr r!rhr]rar@r-__all__rrLr?r)s NN((((((((((                    ;:::::>>>>>>>>>>>><<<<<<>>>>>>BBBBBB<<<<<<888888////////000000 H   7:w 3 3 ')VY / / W\9l ; ; W\9l ; ; w~{NCC GK; 7 7 W\9l ; ; GK; 7 7 3LtCH~3L$y/3L3L3L3LlA A A A A    A A A L" rL