k7iR SrSSKJrJrJr SSKJrJrJrJ r J r J r J r J r SSKJr SSKJr SSKJr SSKJ r SSKJ r SS KJ r SS KJ r SS KJ r SS KJrJr SS KJr SSKJrJrJrJ r J!r!J"r" SSK#J$r$J%r% \"\&5r'\"S\\5r(\"S\ \5r)\"S\ \5r*\"S\\5r+\"S\ \5r,\"S\ \5r-\"S\\5r.\"S\ \5r/S\0\1\4S\2\4Sjr3"SS\\(\*\)\+\,\-\.\/45r4SS/r5g) zHOpenAPI parsing logic for converting OpenAPI specs to HTTPRoute objects.)AnyGenericTypeVar)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 URSS5nURS5(aw[R"U5n[R SUR 35 [U[[[[[[[U5 nUR5$[ R"U5n[R SUR 35 [U["[$[&[([*[,[.U5 nUR5$![0aTn[R3SU35 UR55n[R3SU35 [7SU35UeS nAff=f) 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 r rr r rr rerrorerrors ValueError)r"openapi_version openapi_30parser openapi_31e error_detailss g/home/james-whalen/.local/lib/python3.13/site-packages/fastmcp/experimental/utilities/openapi/parser.pyparse_openapi_to_http_routesr@7sM#&&y"5O)L  % %e , ,#22<@J LLB:CUCUBVW # F<<> !!// =J LLB:CUCUBVW # F<<> ! L 9!=>  *=/:;3M?CD!K Ls B D!A6D E6"AE11E6c"\rSrSrSrS\S\\S\\S\\ S\\ S\\ S \\ S \\ S \4S jrS \S\4SjrS\S\4SjrS\S\4SjrS*S\\S-S\\S-S\\4SjjrS\S\S-4SjrS\S\4SjrS\\\4S\\\4S-4SjrS\\\4S-S\\\ 44Sjr!S+S\S \\\4S!\"\S-S\"\4S"jjr#S#\\S$\S-S \\\4S\\\44S%jr$S&\\\ 4S \\\4S\\\44S'jr%S\\&4S(jr'S)r(g),r-mz[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 pXlX lX0lX@lXPlX`lXplXlXlg)z?Initialize the parser with the OpenAPI schema and type classes.N) r%rCrDrErFrGrHrIr9) selfr%rCrDrErFrGrHrIr9s r?__init__OpenAPIParser.__init__{s8 *$* 0(**.param_inr#cFUS;aU$[RSUS35 g)z@Convert string parameter location to our ParameterLocation type.)pathqueryheadercookiezUnknown parameter location: z, defaulting to 'query'rR)r+warning)rKrOs r?_convert_to_parameter_location,OpenAPIParser._convert_to_parameter_locations* < <O5hZ?VWXrNitemcr[XR5(GaURn[U[5(dU$UR S5(d[ SU35eUR S5RS5nURnUGH:nUR5(a$[U[5(aU[U5nO[U[5(aXTRR;a [XES5nOUR (aXTR ;aUR UnO}US:Xa[#US5(a UR$nOY[#XE5(a [XES5nOH<HH6H11H6 schema_objcURU5n[X R5(aURSSSS9nO<[U[5(aUnO$[ R S[U5S35 0n[U5nU$![a3nS[U5;ae[ RSU3SS 9 0sS nA$S nAf[a#n[ RSU3SS 9 0sS nA$S nAff=f) z1Resolves a schema and returns it as a dictionary.jsonT)modeby_alias exclude_nonez%Expected Schema after resolving, got z. Returning empty dict.-External or non-local reference not supportedz"Failed to extract schema as dict: Fexc_infoN) rlr^rD model_dumprkr+rUtyperr8r`r6 Exception)rKrvresolved_schemaresultr=s r?_extract_schema_as_dict%OpenAPIParser._extract_schema_as_dicts "// ;O/??;;(33$T4OT22(;D#a&H LL=aSAEL RI  LL=aSAEL RI s0BB C0(C:C0 C0 C+%C0+C0Noperation_paramspath_item_paramsc /n0nU=(d /U=(d /-nUGHsnURU5n[XpR5(d$[R S[ U5S35 MTUR nSSKJn [X5(a UROUn URU 5n URn URU 4n X;aMSXM'0nU (ajURU 5nURU 5n[XR5(d-[US5(aUR bUR US'O[US5(aUR"(a[%['UR"R)55S5nU(a[US 5(aUR*(avUR*nURU5nURU5n[UUR5(d-[US5(aUR bUR US'[-US S5n[-US S5n[/URU UR0UUR2UUS 9nUR5U5 GMv U$![6a>n[-US [-USS55n[R9SUSU3SS9 SnAGMSnAff=f)z>'7'I'I ,0,H,H,V)150A0A,0O- *+@$BTBT U U '(=y I I 5 = = I;P;X;X-i8")Y= 7D9+"+&//, ) 5 5# !'' 3Y'j  $ &',y*Q  3J#a&H2E9EH LL28*CsCe   2E9EH LL28*CsCe    ssA FA$FFF'*DF F!+E F FF:FFF H 7G H 'HH  status_codec[U5nSUs=:*=(a S:$s $![[4a UR5S;s$f=f)z>Check if a status code represents a successful response (2xx).i,)r2xx)rer8rplower)rKrcode_ints r?_is_success_status_code%OpenAPIParser._is_success_status_codesS =;'H(((S( (( (I& =$$&*<< < =s""#AAoperation_responsescU(dg/SQnUHnX1;dM X1U4s $ UR5H upEURU5(dMXE4s $ g)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_response+OpenAPIParser._get_primary_success_responsesi#=#D*$788# )<(A(A(C $K++K88#11)D rNc 0nU(dU$URU5nU(d[RS5 U$UupE[RSU35 URU5n[ X`R 5(d'[R SUS[U5S35 U$[URS9n[US5(GaUR(aURR5HupU (dM[U S5(dM!U R(dM4S n U Rn [ XR5(aKU Rn [ U [ 5(a*U R#S 5(aU R%S 5S n UR'U 5n U (aU U S 'XR(U'M Xr[!U5'U$![*a:nS[!U5;ae[R-SUSUSU35 S nAGM%S nAf[.a*n[R-SUSUSU35 S nAGMWS nAff=f![*aEnS[!U5;ae[1USS5n[R-SUSUSU3SS9 S nAU$S nAf[.a5n[1USS5n[R-SUSUSU3SS9 S nAU$S nAff=f)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/rZx-fastmcp-top-level-schemar|rz' in response : r_rz+Failed to extract response for status code z from reference 'r]Fr})rr+r,rlr^rGrUrrrrjrrrrCr_r`r(rbrrr8r6rrh)rKrextracted_responsesprimary_responserrresponse resp_inforrtop_level_schema_namerrqrr=rs r?_extract_responses OpenAPIParser._extract_responsess!8:"& & ==>QR LLV W&   7 }EFH ((5Hh(9(9::H V>**FH+*%1E1EFIx++0@0@6>6F6F6L6L6N2N&#N4GHH*<<< 481+9+K+KL),8J8JKK*6*:*:#-gs#;#;@R@R$;A"A"=DMM#K 0 1&#"G * NRU !S !&"LL"KNK[\//:m2aS!B )"LL"KNK[\//:m2aS!B >#a&H{E9=H LL=k]K##+*Cs4  #" {E9=H LL=k]K##+*Cs4   #" suAI*AIII/BG  I I*.HI I,I III K%#:J## K%0*K  K%r all_schemas collectedcF^^^Tc [5mUUU4SjmT"U5 T$)a, 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 c>[U[5(aSU;at[US[5(a\USnURS5(aUR S5SnOgTb(UT;a"UT;aTR U5 T"TU5 UR 5H nT"U5 M g[U[5(aUH nT"U5 M gg)z%Recursively find all $ref references.z$ref)z#/$defs/rrZrN)r^rkr`r(rbaddrrd)objr_ schema_namerrXrr find_refss r?r=OpenAPIParser._extract_schema_dependencies..find_refs's#t$$S=ZF S%A%Af+C~~&KLL&)iinR&8 "-'y8';6! k2!+k":;!ZZ\Ee$*C&&DdO 'rN)set)rKrrrrs ``@r?_extract_schema_dependencies*OpenAPIParser._extract_schema_dependenciess'"  I $8 &rN parametersrc[5nUHCnUR(dMURURU5nURU5 ME U(aTUR(aCURR 5H%nURXs5nURU5 M' UVs0sHoU;dM XU_M sn$s snf)a 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_dependencies0OpenAPIParser._extract_input_schema_dependenciesFs" E}}}88 T%%d+ L77"."="="D"D"F88U%%d+#G 1? 0>+BU #Dd# #   s 3 C  C  responsescv[5nUR5HznUR(dMURR5HFnSU;aUSnXb;aURU5 UR XR5nUR U5 MH M| UVs0sHoU;dM XU_M sn$s snf)z 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)rrrrrr) rKrrrrrrrrs r?#_extract_output_schema_dependencies1OpenAPIParser._extract_output_schema_dependenciesjs"((*H&&&&.&=&=&D&D&FN3~E&45Q&R &5*..{; <<&D#))$/'G+"1? 0>+BU #Dd# #   s  B6* B6c /n[URS5(aURR(d[R S5 /$0n[URS5(aURR (aURR n[US5(aUR (awUR R5HYupE[XPR5(a&URU5nURU5X$'MFURU5X$'M[ U(a=UR5H)upE[U[5(dM[U5X$'M+ URRR5GHup[XR5(d'[R SUS [!U 5S 35 MG[U S 5(a U R"OSn /S Qn U GHn [%XS5n U (dM[XR&5(dM5U R)5nUR+[%U S S5U 5nUR-[%U S S55nUR/[%U SS55n0n[U S5(aYU R0(aHU R0R5VVs0sH!unnUR3S5(dMUU_M# nnnUR5UUU5nUR7UU5n[9UU[%U SS5[%U SS5[%U SS5[%U S/5=(d /UUUUUUUR:S9 n[=USS9unnUUlUUl URCU5 GM GM! [RKS$[MU5S%35 U$![a'n[R SUSU35 SnAGM8SnAff=fs snnf![a9n[R SUSUSU35 S0S.Ul0Ul SnANSnAff=f![DaInS[GU5;ae[%U SS5n[RISUSUS US!U3S"S#9 SnAGMSnAf[a9n[%U SS5n[RISUSUS US!U3S"S#9 SnAGMSnAff=f)&z*Parse the OpenAPI schema into HTTP routes.pathsz$OpenAPI schema has no paths defined.r[schemasz%Failed to extract schema definition 'r]Nz%Skipping invalid path item for path 'z ' (type: )r)r'putpostdeleteoptionsheadpatchtrace requestBodyrrizx- operationIdsummaryrtags) rQmethod operation_idrrrrrrrequest_schemasresponse_schemas extensionsr9F) convert_refsz)Failed to pre-calculate schema for route  robject)r propertiesr|rzFailed to process operation z (ID: z): Tr}zFinished parsing. Extracted z HTTP routes.)'rjr%rr+rUr[rrr^rCrlrrrkrrIrrrhrHupperrrrrir(rrrr9rflat_param_schema parameter_maprr8r`r6r,len)rKroutesschema_definitionsr[rrrr=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?r5OpenAPIParser.parses"$t||W--T\\5G5G NNA BI  4<< . .4<<3J3J00Jz9--*2D2D$.$6$6$<$<$>LD %f.@.@AA.2.?.?.GO7;7S7S /8.48<7S7S &8.4%?"  2 8 8 : fd++/Ef/M&,!; (,||'9'9'?'?'A #Hm-?-?@@;H:YtTaObNccde=,77((  L!- #MF 9I7I7I!J!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 >O& O&BQ&'P P A sCx4 .\##'S>D#8\# c< \#D&* 11#s(^1s8d? 1 S 1f" '" &," #s(^ " c3h " H$ \)*$ #s(^$  c3h $ L[tI[rNr-r@N)6r'typingrrropenapi_pydanticrrrr r r r r openapi_pydantic.v3.v3_0r)r3r0r4r.r1r2r/pydanticrrfastmcp.utilities.loggingrmodelsrrrrrrrrrr#r+rrrrrrr r!rkr`rdr@r-__all__r+rNr?r3s.N((   ;>><>B<8/0 H  :w 3 )VY / \9l ; \9l ; ~{NC K; 7 \9l ; K; 7 3LtCH~3L$y/3Ll~    ~ F" rN