+ Q(i Rt^RIHtHtHtHt^RIHtHtH t H t H t H t H t Ht^RIHt^RIHt^RIH t^RIH t^RIH t^RIH t^R IH t^R IHt^R IHtHt^R IHt^R IHtHtH t H!t!H"t"H#t#^RI$H%t%H&t&]!]'4t(]!R]]4t)]!R]]4t*]!R] ]4t+]!R] ]4t,]!R] ]4t-]!R] ]4t.]!R]]4t/]!R] ]4t0RRlt1!RR]])]+]*],]-].]/]03,4t2RR.t3R#)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 TPathItemchV^8dQhR\\\3,R\\,/#) openapi_dictreturn)dictstrrlistr)formats"f/Users/agent/.openclaw/workspace/venv/lib/python3.14/site-packages/fastmcp/utilities/openapi/parser.py __annotate__r*7s*3L3LtCH~3L$y/3Lc VPRR4pVPR4'dx\P!V4p\P RVP 24\V\\\\\\\V4 pVP4#\ P!V4p\P RVP 24\V\"\$\&\(\*\,\.V4 pVP4# \0dUp\P3RT 24TP54p\P3RT 24\7RT 24ThR p?ii;i) 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& r)parse_openapi_to_http_routesrG7sM#&&y"5O)L  % %e , ,#22<@J LLB:CUCUBVW # F<<> !!// =J LLB:CUCUBVW # F<<> ! L 9!=>  *=/:;3M?CD!K Ls%DA6D"A6D E8$AE33E8ca]tRt^mtoRtV3RlRltV3RlRltV3RlRltV3RlR ltRV3R lR llt V3R lRlt V3RlRlt V3RlRlt V3RlRlt RV3RlRlltV3RlRltV3RlRltV3RlRltRtVtR #) r5z[Unified parser for OpenAPI schemas with generic type parameters to handle both 3.0 and 3.1.c<V^8dQhRS[RS[S[,RS[S[,RS[S[,RS[S[,RS[S[,RS[S[,RS[S[,R S[ / #) r"r- reference_cls schema_cls parameter_clsrequest_body_cls response_cls operation_cls path_item_clsrA) rtyperrrrrrr r&)r( __classdict__s"r)r*OpenAPIParser.__annotate__{s///J'/M / J' / |, /9o/J'/I//r+c  rWnW nW0nW@nWPnW`nWpnWnWnR#)z?Initialize the parser with the OpenAPI schema and type classes.N) r-rJrKrLrMrNrOrPrA) selfr-rJrKrLrMrNrOrPrAs &&&&&&&&&&r)__init__OpenAPIParser.__init__{s8 *$* 0(**.r+c&<V^8dQhRS[RS[/#)r"param_inr$)r&r)r(rRs"r)r*rSs00s0?P0r+c VR9d\\V4#\PRV R24\\R4#)z@Convert string parameter location to our ParameterLocation type.queryzUnknown parameter location: z, defaulting to 'query')pathr[headercookie)rrr3warning)rUrYs&&r)_convert_to_parameter_location,OpenAPIParser._convert_to_parameter_locations> < <)84 45hZ?VWX%w//r+c&<V^8dQhRS[RS[/#)r"itemr$)r)r(rRs"r)r*rSs5555r+c \WP4'EdVPp\V\4'gV#VP R4'g\ RV 24hVP R4PR4pVPpVEFMpVP4'd*\V\4'dV\V4,pM\V\4'dWTPP9d\WER4pMVP 'd%WTP 9dVP V,pMVR8Xd \#VR4'dVP$pM[\#WE4'd\WER4pM=RpM:\V\&4'dVP)V4pM\ RV RV R24hVeEK>\ R V R V R24h \W@P4'dVP+V4#V#V# \,\.\0\2\ 3dp\ R T R T 24ThRp?ii;i) 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 '': ) isinstancerJrefr&r0r@stripsplitr-isdigitr'intr __class__ model_fieldsgetattr model_extrahasattrrfr%r/ _resolve_refAttributeErrorKeyError IndexError TypeError)rUrcref_strpartstargetpartrEs&& r)rtOpenAPIParser._resolve_refs  d.. / /hhGgs++ , Y))$//$I'S d+11#6!D||~~*VT*B*B!'D !2#FI66#3#3#@#@@%,V4%@F#///D Exception)rUrresolved_schemaresultrEs&& r)_extract_schema_as_dict%OpenAPIParser._extract_schema_as_dicts "// ;O/??;;(33$T4OT22(;D#a&H LL=aSAEL RI  LL=aSAEL RI s6B B C>,C C> C>C>C93C>9C>Ncx<V^8dQhRS[S[,R,RS[S[,R,RS[S[,/#)r"operation_paramsNpath_item_paramsr$)r'rr)r(rRs"r)r*rSsEa a s)d*a s)d*a  m  a r+c  .p/pT;'g.T;'g.,pVEFpVPV4p\WpP4'g%\P R\ V4 R24KUTP p^RIHp \W4'd VPMTp VPV 4p VPp VPV 3p W9dKRWM&/pV 'dnVPV 4pVPV 4p\WP4'g0\VR4'dVP eVP VR&M\VR4'dVP"'d\%\'VP"P)44R4pV'd\VR4'dVP*'dzVP*pVPV4pVPV4p\VVP4'g0\VR4'dVP eVP VR&\-VR R4p\-VR R4p\/VPV VP0VVP2VVR 7pVP5V4EK V# \6dBp\-TR \-TR R44p\P9RT RT 2RR7Rp?EKRp?ii;i)z)rUrrextracted_params seen_params all_params param_or_ref parameterrYr param_in_strparam_locationparam_schema_obj param_keyparam_schema_dictrfirst_media_type media_schemaresolved_media_schemarr param_inforE param_names&&& r)_extract_parameters!OpenAPIParser._extract_parameterss 13  ',,"1A1G1GRH &LR  --l; !)-?-?@@NNB4 ?BSS^_%--%'1&@&@HNNh"&!D!D\!R#,#9#9 '^^\: +)- &%'!#(,(D(DEU(V%'+&7&78H&IO&8J8JKK#OY??+33?7F7N7N))4Y 22y7H7H7H'+D1B1B1I1I1K,Ld'S$(#$46IJJ,>>>'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  3Jrrq) rUr request_bodyrequest_body_infomedia_type_strmedia_type_obj schema_dictrEref_names && r)_extract_request_body#OpenAPIParser._extract_request_bodySs"; ,,-@ALl,A,ABB@lAS@TTef!0%..(44!  |Y//L4H4H4H6B6J6J6P6P6R2N&#N4GHH*<<<*.*F*F . @ @+K!,.<<^L7S6% $ *NRU !S !&"LL"KNK[[^_`^a b )"LL"KNK[[^_`^a b  >#a&H2E9EH LL28*CsCe   2E9EH LL28*CsCe    sAFAF!$F FF3*D#F# F.,E F F-F.F FFF H&";G## H&0H&1*H!!H&c&<V^8dQhRS[RS[/#)r" status_coder$)r&bool)r(rRs"r)r*rSs==3=4=r+c \V4p^Tu;8*;'dR8#u# \\3dTP4R9u#i;i)z>Check if a status code represents a successful response (2xx).i,)r2xx)rnr@rxlower)rUrcode_ints&& r)_is_success_status_code%OpenAPIParser._is_success_status_codesS =;'H(((S( (( (I& =$$&*<< < =s##$A  A c`<V^8dQhRS[S[S[3,RS[S[S[3,R,/#)r"operation_responsesr$N)r%r&rtuple)r(rRs"r)r*rSs2#'S> sCx4 r+c V'gR#.ROpVFpW19gK W1V,3u# VP4F!wrEVPV4'gKWE3u# R#)zTGet the primary success response for an MCP tool. We only need one success response.N)200201202204207)rr)rUrpriority_codescoder resp_or_refs&& r)_get_primary_success_response+OpenAPIParser._get_primary_success_responsesi#=#D*$788# )<(A(A(C $K++K88#11)D r+c`<V^8dQhRS[S[S[3,R,RS[S[S[3,/#)r"rNr$)r%r&rr)r(rRs"r)r*rSs8`#`##'S>D#8`# c< `#r+c  @/pV'gV#VPV4pV'g\PR4V#VwrE\PRV 24VPV4p\ W`P 4'g(\P RV R\V4 R24V#\VPR7p\VR4'Ed(VP'EdVPP4FwrV 'd\V R4'dV P'dR p V Pp \ WP4'dRV Pp \ V \ 4'd0V P#R 4'dV P%R 4R,p VP'V 4p V 'dV V R &WP(V&KVP(P1V/4K Wr\!V4&V# \*d<pR \!T49dh\P-RT RT RT 24R p?EKJR p?i\.d+p\P-RT RT RT 24R p?EK}R p?ii;i \*dJpR \!T49dh\3TRR4p\P-RT RT RT 2RR7R p?T#R p?i\.d9p\3TRR4p\P-RT RT RT 2RR7R p?T#R p?ii;i)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/rex-fastmcp-top-level-schemarrz' in response : rjrz+Failed to extract response for status code z from reference 'rhFr)rr3r4rtrirNr_rQrrrsrrrrJrjr&r0rlrrr@r>r setdefaultrq)rUrextracted_responsesprimary_responserrresponse resp_inforrtop_level_schema_namerryrrErs&& r)_extract_responses OpenAPIParser._extract_responsessE8:"& & ==>QR LLV W&   7 }EFL ((5Hh(9(9::H V>**FH+*%1E1EFIx++0@0@0@6>6F6F6L6L6N2N&#N4GHH*<<< 481+9+K+KL),8J8JKK*6*:*:#-gs#;#;@R@R$;A"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    #" sAJ-;J)A J5A!H 0H H /J J/I J JJJ9JJJ L>K L$L%-LLc v<V^8dQhRS[RS[S[S[3,RS[S[,R,RS[S[,/#)r"r all_schemas collectedNr$)r%r&rset)r(rRs"r)r*rSsG111#s(^1s8d? 1 S 1r+c HaaaSf \4oVVV3RloS!V4S#)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<\V\4'dRV9d\VR,\4'dnVR,pVPR4'dVP R4R,pMR#Se/VS9d(VS9d!SP V4S!SV,4VP 4F pS!V4K R#\V\4'dVF pS!V4K R#R#)z%Recursively find all $ref references.z$refreN)z#/$defs/rr)rir%r&r0rladdrr')objrj schema_namerrcrr 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 'r+)r)rUrrrrs&&ff@r)_extract_schema_dependencies*OpenAPIParser._extract_schema_dependenciess'"  I $8 &r+c |<V^8dQhRS[S[,RS[R,RS[S[S[3,RS[S[S[3,/#)r" parametersrNrr$)r'rrr%r&r)r(rRs"r)r*rSJsM" " '" &," #s(^ " c3h " r+c \4pVFDpVP'gKVPVPV4pVPV4KF V'dVVP'dDVPP 4F%pVPWs4pVPV4K' VUu/uFqV9gK WV,bK up#uupi)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) rUrrrneeded_schemasparamdepsrrs &&&& r)"_extract_input_schema_dependencies0OpenAPIParser._extract_input_schema_dependenciesJs" E}}}88 T%%d+ L777"."="="D"D"F88U%%d+#G 1? 0>+BU #Dd# #   s 6C Ccn<V^8dQhRS[S[S[3,RS[S[S[3,RS[S[S[3,/#)r" responsesrr$)r%r&rr)r(rRs"r)r*rSnsC' ' \)*' #s(^'  c3h ' r+c V'd V'g/#\4pVP4FpVP'gKVPP4FpVPWR4pVP V4VP R4p\ V\4'gKNWr9gKVVPV4VPW',VVR7K K VUu/uFqV9gK WV,bK up#uupi)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)r) rrrrrr/rir&r) rUrrrrrrrrs &&& r)#_extract_output_schema_dependencies1OpenAPIParser._extract_output_schema_dependenciesns I#&5!((*H***"*"9"9"@"@"B88U%%d+,001MN k3//K4N"&&{355#0#"06#C +$1? 0>+BU #Dd# #   s +D8 Dc0<V^8dQhRS[S[,/#)r"r$)r'r)r(rRs"r)r*rSs[[tI[r+c > .p\VPR4'dVPP'g\P R4.#/p\VPR4'dVPP 'dVPP p\VR4'dVP 'dyVP P4FZwrE\WPP4'd'VPV4pVPV4W$&KGVPV4W$&K\ V'd?VP4F*wrE\V\4'gK\V4W$&K, VPPP4EF+wr\WP4'g(\P RV R \!V 4 R 24KH\V R 4'd V P"MRp .R&Op V EFp \%WR4p V 'gK\WP&4'gK7V P)4pVP+\%V R R4V 4pVP-\%V R R44pVP/\%V R R44p/p\V R4'd[V P0'dIV P0P4UUu/uF"wppVP3R4'gKVVbK$ pppVP5VVV4pVP7VV4p\9TT\%V RR4\%V RR4\%V RR4\%V R.4;'g.VVVVVVVP:R7 p\=VRR7wppVVnVVn VPCV4EK EK. \PKR$\MV4 R%24V# \d(p\P RT RT 24Rp?EKIRp?ii;iuuppi \d;p\P RT RT RT 24RRR//Tn/Tn Rp?LRp?ii;i \DdNpR\GT49dh\%T RR4p\PIRT RT R T R!T 2R"R#7Rp?EKRp?i\d=p\%T RR4p\PIRT RT R T R!T 2R"R#7Rp?EKRp?ii;i)'z*Parse the OpenAPI schema into HTTP routes.pathsz$OpenAPI schema has no paths defined.rfschemasz%Failed to extract schema definition 'rhNz%Skipping invalid path item for path 'z ' (type: )r requestBodyrrrzx- operationIdsummaryrtags) r\method operation_idr rr rrrrequest_schemasresponse_schemas extensionsrAF) convert_refsz)Failed to pre-calculate schema for route  rrQobject propertiesrrzFailed to process operation z (ID: z): TrzFinished parsing. Extracted z HTTP routes.)r/putpostdeleteoptionsheadpatchtrace)'rsr-rr3r_rfrrrirJrtrrr%rrPrQrrqrOupperrrrrrr0rrrrArflat_param_schema parameter_maprr@r&r>r4len)rUroutesschema_definitionsrfrrrrEpath_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)r=OpenAPIParser.parses "$t||W--T\\5G5G5G NNA BI  4<< . .4<<3J3J3J00Jz9--*2D2D2D$.$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<<AVAVAV-6,A,A,G,G,I*,IDAq#$<<#5!%1,I'*)-(O(O&-.) *.)Q)Q%.* !*!)#/)0M4)P$+Iy$$G(/ =$(O!(FB!?!E!E2'1):&/,9-;'1,0,@,@!"55T %-262K7BE32;E/ e,U!-1(Bj  3CK= NO G%CD6QCPv*T ) 5"NN"KL>YZ[cZddfgsft u !' ,b7E335E// 5& Jc$O" ' =) L :<.(SYZ_Y``cdlcmn%)%% ' =) L :<.(SYZ_Y``cdlcmn%)%s&?O<'O<A:Q?Q?6P1 P1 BQ?P7=Q?< P.P))P.1Q?7 Q<0Q72Q?7Q<<Q?? T AS TT 0TT) r-rArOrLrPrJrMrNrK)NN)N)__name__ __module__ __qualname____firstlineno____doc__rVr`rtrrrrrrrrrr=__static_attributes____classdictcell__)rRs@r)r5r5msf//.0055n@a a F@@D==.`#`#D11f" " H' ' R[[r+r5rGN)4r:typingrrrropenapi_pydanticrrrr r r r r openapi_pydantic.v3.v3_0r1r;r8r<r6r9r:r7pydanticrrfastmcp.utilities.loggingrmodelsrrrrrrrrrr6r3rrrrrrrr rGr5__all__r+r)rEsN..   ;>><>B<8/0 H  :w 3 )VY / \9l ; \9l ; ~{NC K; 7 \9l ; K; 7 3LlE    E T" r+