lKj dZddlmZmZmZmZddlmZmZm Z m Z m Z m Z m Z mZddlmZddlmZddlm Zddlm Zddlm Zdd lm Zdd lm Zdd lmZdd lmZmZdd lmZddlmZmZm Z m!Z!m"Z"m#Z#ddl$m%Z%m&Z&ee'Z(edeeZ)edeeZ*ede eZ+ede eZ,ede eZ-ede eZ.edeeZ/ede eZ0de1e2efde3efdZ4Gddee)e+e*e,e-e.e/e0fZ5ddgZ6y) zHOpenAPI parsing logic for converting OpenAPI specs to HTTPRoute objects.)AnyGenericTypeVarcast)OpenAPI Operation ParameterPathItem Reference RequestBodyResponseSchema)r)r)r )r )r )r )r )r) BaseModelValidationError) get_logger) HTTPRoute JsonSchema ParameterInfoParameterLocationRequestBodyInfo ResponseInfo)_combine_schemas_and_map_params_replace_ref_with_defsTOpenAPITSchema TReference TParameter TRequestBody TResponse TOperation TPathItem openapi_dictreturnc |jdd} |jdrvtj|}tj d|j t|ttttttt| }|jSt!j|}tj d|j t|t"t$t&t(t*t,t.| }|jS#t0$rT}tj3d||j5}tj3d|t7d||d }~wwxYw) z Parses an OpenAPI schema dictionary into a list of HTTPRoute objects using the openapi-pydantic library. Supports both OpenAPI 3.0.x and 3.1.x versions. openapiz3.0z0Successfully parsed OpenAPI 3.0 schema version: z0Successfully parsed OpenAPI 3.1 schema version: z"OpenAPI schema validation failed: zValidation errors: zInvalid OpenAPI schema: N)get startswith OpenAPI_30model_validateloggerdebugr& OpenAPIParser Reference_30 Schema_30 Parameter_30RequestBody_30 Response_30 Operation_30 PathItem_30parserr rr r r rr rerrorerrors ValueError)r#openapi_version openapi_30parser openapi_31e error_detailss q/Users/ahmed/devFolder/Ultron/claude-voice/.venv/lib/python3.12/site-packages/fastmcp/utilities/openapi/parser.pyparse_openapi_to_http_routesrA7sJ#&&y"5O)L  % %e ,#22<@J LLB:CUCUBVW # F<<> !!// =J LLB:CUCUBVW # F<<> ! L 9!=>  *=/:;3M?CD!K Ls BDA5D E.AE))E.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&y)*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_clsr:c ||_||_||_||_||_||_||_||_| |_y)z?Initialize the parser with the OpenAPI schema and type classes.N) r&rCrDrErFrGrHrIr:) selfr&rCrDrErFrGrHrIr:s r@__init__zOpenAPIParser.__init__{sJ *$* 0(**.param_inr$c||dvrtt|Stjd|dttdS)z@Convert string parameter location to our ParameterLocation type.)pathqueryheadercookiezUnknown parameter location: z, defaulting to 'query'rQ)rrr,warning)rKrNs r@_convert_to_parameter_locationz,OpenAPIParser._convert_to_parameter_locations> < <)84 45hZ?VWX%w//rMitemct||jr|j}t|ts|S |j dst d||j djd}|j}|D]}|jrt|tr|t|}nt|tr||jjvrt||d}n|j r||j vr|j |}no|dk(rt#|dr |j$}nQt#||rt||d}n7d}n4t|t&r|j)|}nt d|d|d|t d |d |dt||jr|j+|S|S|S#t,t.t0t2t f$r}t d |d ||d}~wwxYw) 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 '': ) isinstancerCrefstrr)r9stripsplitr&isdigitlistintr __class__ model_fieldsgetattr model_extrahasattrrYdictr( _resolve_refAttributeErrorKeyError IndexError TypeError)rKrVref_strpartstargetpartr>s r@rjzOpenAPIParser._resolve_refs dD.. /hhGgs+ , Y))$/$I'S d+11#6!D||~*VT*B!'D !2#FI66#3#3#@#@@%,VT4%@F#//DFs r@_extract_schema_as_dictz%OpenAPIParser._extract_schema_as_dicts "// ;O/4??;(33$T4OT2(;D#a&H LL=aSAEL RI  LL=aSAEL RI s0A?B C, )B:4C,: C,C'!C,'C,Noperation_paramspath_item_paramsc <g}i}|xsg|xsgz}|D]8} |j|}t||js#tj dt |dO|j }ddlm} t|| r |jn|} |j| } |j} |j| f} | |vrd|| <i}| r`|j| }|j| }t||jst|dr|j |j |d<nt|dr|j"rt%t'|j"j)d}|rt|d rw|j*rk|j*}|j|}|j|}t||js't|dr|j |j |d<t-|d d}t-|d d}t/|j| |j0||j2|| }|j5|;|S#t6$r@}t-|d t-|dd}tj9d|d|dYd}~d}~wwxYw)z param_names r@_extract_parametersz!OpenAPIParser._extract_parameterss 13  ',"1A1GRH &LR  --l; !)T-?-?@NNB4 ?BSS^_%--%'14&@HNNh"&!D!D\!R#,#9#9 '^^\:  +)- I&%'!#(,(D(DEU(V%'+&7&78H&IO&8J8JK#OY?+33?7F7N7N))4Y 2y7H7H'+D1B1B1I1I1K,Ld'S$(#$46IJ,>>'7'I'I ,0,H,H,V)150A0A,0O- *+@$BTBT U '(=y I 5 = = I;P;X;X-i8")Y= 7D9+"+&//, ) 5 5# !'' 3Y'j  $ &',y*Q  3Jref_names r@_extract_request_bodyz#OpenAPIParser._extract_request_bodySs "; ,,-@ALlD,A,AB@lAS@TTef!0%..(44!  |Y/L4H4H6B6J6J6P6P6R2NN&#N4GH*<<*.*F*F . @ @+K!,.<<^L7S6% $ *NRU !S !&"LL"KNK[[^_`^a b )"LL"KNK[[^_`^a b  >#a&H2E9EH LL28*CsCe   2E9EH LL28*CsCe    ssA EAE+ E8 E*C40E4 E=)D+&E+ E7EEEE G%(8F%% G%1*G  G% status_codec t|}d|cxkxrdkScS#ttf$r|jdvcYSwxYw)z>Check if a status code represents a successful response (2xx).i,)r2xx)rcr9rnlower)rKrcode_ints r@_is_success_status_codez%OpenAPIParser._is_success_status_codesP =;'H((S( (( (I& =$$&*<< < =s!AAoperation_responsesc|sygd}|D]}||vs|||fcS|jD]\}}|j|s||fcSy)zTGet the primary success response for an MCP tool. We only need one success response.N)200201202204207)rr)rKrpriority_codescoder resp_or_refs r@_get_primary_success_responsez+OpenAPIParser._get_primary_success_responsesp#=#D**1$788# )<(A(A(C $K++K8#[11)D rMc i}|s|S|j|}|stjd|S|\}}tjd| |j|}t ||j s'tj d|dt|d|St|j}t|dr|jr|jjD]\}} | rt| dr| jr d } | j} t | |jrA| j} t | t r%| j#d r| j%d d } |j'| } | r| | d <| |j(|<|j(j1|i||t!|<|S#t*$r7}dt!|vrtj-d|d|d|Yd }~d }~wt.$r)}tj-d|d|d|Yd }~Gd }~wwxYw#t*$rF}dt!|vrt3|dd}tj-d|d|d|dYd }~|Sd }~wt.$r8}t3|dd}tj-d|d|d|dYd }~|Sd }~wwxYw)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/rXx-fastmcp-top-level-schemaryrz' in response : r]rz+Failed to extract response for status code z from reference 'r[Frz)rr,r-rjr\rGrTr}rrrhrrrrCr]r^r)r`rrr9r7r~ setdefaultrf)rKrextracted_responsesprimary_responserrresponse resp_inforrtop_level_schema_namerrorr>rs r@_extract_responsesz OpenAPIParser._extract_responsess78:"& & ==>QR LLV W&  [ 7 }EFL ((5Hh(9(9:H V>**FH+*%1E1EFIx+0@0@6>6F6F6L6L6N2NN&#N4GH*<< 481+9+K+KL),8J8JK*6*:*:#-gs#;@R@R$;A"=DMM# K 0 1&#"O * NRU !S !&"LL"KNK[\//:m2aS!B )"LL"KNK[\//:m2aS!B >#a&H{E9=H LL=k]K##+*Cs4   #" {E9=H LL=k]K##+*Cs4    #" siA H4A(H4B G-H4 H1 ,G<6H4< H1H,&H4,H11H44 K=;I>> K -J==Kr all_schemas collectedcB tfd|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 ctt|trd|vret|dtrR|d}|jdr|j dd}ny$|vr |vrj |||j D] }| yt|tr|D] }| yy)z%Recursively find all $ref references.z$ref)z#/$defs/rrXrN)r\rir^r)r`addrrb)objr] schema_namerrVrr find_refss r@rz=OpenAPIParser._extract_schema_dependencies..find_refs+s#t$S=ZF S%Af+C~~&KL&)iinR&8 "-'y8';6! k2!+k":;!ZZ\Ee$*C&DdO 'rM)set)rKrrrrs ``@r@_extract_schema_dependenciesz*OpenAPIParser._extract_schema_dependenciess'"  I $8 &rM parametersrctt}|D]<}|js|j|j|}|j|>|rN|jrB|jj D]%}|j||}|j|'|Dcic] }||vs|||c}Scc}w)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 )rschema_rupdaterr) rKrrrneeded_schemasparamdepsrrs r@"_extract_input_schema_dependenciesz0OpenAPIParser._extract_input_schema_dependenciesJs" E}}88 T%%d+ L77"."="="D"D"F88U%%d+#G 1? 0>$+BUD+d# #   s B5*B5 responsesc|r|siSt}|jD]}|js|jjD]t}|j||}|j ||j d}t |tsH||vsM|j||j||||v|Dcic] }||vs|||c}Scc}w)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)r) rrrrrr(r\r^r) rKrrrrrrrrs r@#_extract_output_schema_dependenciesz1OpenAPIParser._extract_output_schema_dependenciesns I#&5!((*H**"*"9"9"@"@"B88U%%d+,001MN k3/K;4N"&&{355#K0#"06#C +$1? 0>$+BUD+d# #   s  CCcF g}t|jdr|jjstj dgSi}t|jdr|jj r|jj }t|dr|j rs|j jD]V\}} t||jr&|j|}|j|||<n|j|||<X|r7|jD]$\}}t|tst|||<&|jjjD]\}} t| |js&tj d|d t!| d Ct| d r | j"nd} gd } | D]} t%| | d} | st| |j&s+| j)} |j+t%| d d| }|j-t%| d d}|j/t%| dd}i}t| drJ| j0r>| j0jDcic]\}}|j3dr||}}}|j5|||}|j7||}t9||t%| ddt%| ddt%| ddt%| dgxsg|||||||j: } t=|d\}}||_||_ |jC|tjKd$tM|d%|S#t$r&}tj d|d|Yd}~d}~wwxYwcc}}w#t$r9}tj d|d|d|did|_i|_ Yd}~d}~wwxYw#tD$rI}dtG|vrt%| dd}tjId|d|d |d!|d"#Yd}~d}~wt$r;}t%| dd}tjId|d|d |d!|d"#Yd}~d}~wwxYw)&z*Parse the OpenAPI schema into HTTP routes.pathsz$OpenAPI schema has no paths defined.rYschemasz%Failed to extract schema definition 'r[Nz%Skipping invalid path item for path 'z ' (type: )r)r(putpostdeleteoptionsheadpatchtrace requestBodyrrgzx- operationIdsummaryrtags) rPmethod operation_idrrrrrrrequest_schemasresponse_schemas extensionsr:F) convert_refsz)Failed to pre-calculate schema for route  robject)r} propertiesryrzFailed to process operation z (ID: z): TrzzFinished parsing. Extracted z HTTP routes.)'rhr&rr,rTrYrrr\rCrjrr~rirrIr}rrfrHupperrrrrgr)rrrr:rflat_param_schema parameter_maprr9r^r7r-len)rKroutesschema_definitionsrYrrrr>path_str path_item_objpath_level_params http_methods method_lower operation method_upperrrrrkv input_schemasoutput_schemasroute flat_schema param_map schema_errorop_errorop_ids r@r6zOpenAPIParser.parses"$t||W-T\\5G5G NNA BI  4<< .4<<3J3J00Jz9-*2D2D$.$6$6$<$<$>LD& %fd.@.@A.2.?.?.GO7;7S7S /8.t48<7S7S &8.t4%?"  2 8 8 : ffd+/Ef/M&t,!; (,||'9'9'?'?'A #HmmT-?-?@;H:YtTaObNccde=,7((  L!- #M<F It7I7I!J#/#5#5#7LT%)%=%=#I|TBDU& -1,F,F#I}dC-)%)$;$;#I{DA% &( "9m<AVAV-6,A,A,G,G,I*,IDAq#$<<#5!"1,I'*)-(O(O&-.) *.)Q)Q%.* !*!)#/)0M4)P$+Iy$$G(/ =$(O!(FB!?!E2'1):&/,9-;'1,0,@,@!"55T %-262K7BE32;E/ e,U!-1(Bj  3CK= NO G%CD6QCPv*T ) 5"NN"KL>YZ[cZddfgsft u )1.07E335E// 5& Jc$O" ' =) L :<.(SYZ_Y``cdlcmn%)%% ' =) L :<.(SYZ_Y``cdlcmn%)%s{ANB P O ;A:P 6OP  N>N99N>P  P /P?P P  P  R >Q R %0RR )NN)N)'__name__ __module__ __qualname____doc__rr}rrrrr r!r"r^rLrrUrrjrrrbrrrrboolrrituplerrrrrrrrr6rMr@r.r.msif//J'/M / J' / |, /9o/J'/I//.0s0?P0555n#*D.2-1a s)d*a s)d*a  m  a F@@SWAW@D=3=4=#'S> sCx4 .`##'S>D#8`# c< `#L&* 11#s(^1s8d? 1 S 1f" '" &," #s(^ " c3h " H' \)*' #s(^'  c3h ' R[tI[rMr.rAN)7rtypingrrrropenapi_pydanticrrr r r r r ropenapi_pydantic.v3.v3_0r*r4r1r5r/r2r3r0pydanticrrfastmcp.utilities.loggingrmodelsrrrrrrrrrrr,rrrrrr r!r"rir^rbrAr.__all__rrMr@r$s.N..   ;>><>B<8/0 H  :w 3 )VY / \9l ; \9l ; ~{NC K; 7 \9l ; K; 7 3LtCH~3L$y/3LlE    E T" rM