"z,clean_schema_for_display..0s4! ! ! /3q!A'**! ! ! itemsadditionalPropertiesT) isinstancedictcopypopr!r)r cleanedfields_to_removefields rrr st FD11 kkmmG&" G   KK   w! ! 7>|7L7R7R7T7T! ! !  |$ & KK % % %'3GG4DEEw ! KK (( g45t < < .F.///G* + ++ , 4 4  Nr info descriptionc|}|dx}rwt|tra|dr$|dd}d||d<n|dst d|dny|d x}r9d|vrt||d <nKd |D|d <n)|d x}rt||d <d D]C}t||gD]\}} t| |||<D|d x} r't| tst| |d <|d|r|ds||d<|S)a Replace openapi $ref with jsonschema $defs recursively. Examples: - {"type": "object", "properties": {"$ref": "#/components/schemas/..."}} - {"type": "object", "additionalProperties": {"$ref": "#/components/schemas/..."}, "properties": {...}} - {"$ref": "#/components/schemas/..."} - {"items": {"$ref": "#/components/schemas/..."}} - {"anyOf": [{"$ref": "#/components/schemas/..."}]} - {"allOf": [{"$ref": "#/components/schemas/..."}]} - {"oneOf": [{"$ref": "#/components/schemas/..."}]} Args: info: dict[str, Any] description: str | None Returns: dict[str, Any] $refz#/components/schemas//#/$defs/z#/z/External or non-local reference not supported: z. FastMCP only supports local schema references starting with '#/'. Please include all schema definitions within the OpenAPI document.rc4i|]\}}|t|Sr)_replace_ref_with_defs)r prop_name prop_schemas rrz*_replace_ref_with_defs..ps7$$$*I{1+>>$$$r r!)r r rr"r+) r%getr#str startswithsplit ValueErrorr2r! enumeratebool) r*r+r ref_path schema_namer item_schemasectioniitemr"s rr2r2Js.,YY[[F::f%%%x> h $ $ ""#:;; &nnS11"5 !9K!9!9v((..  ZhZZZ zz,// / > Z  #9*#E#EF< $$.8.>.>.@.@$$$F<  7++ +>0==w.>> GR!8!899 > >GAt!7!=!=F7OA   >%zz*@AAA.55 -C$..F) * xx {++,FJJ}4M4M, +} Mr c0d|vsd|vsd|vr|St|dtr d|dvr|Sd|vrN|d}t|tr0|dvr|dkrJd|vrF|}gd }i}|D]}||vr||||<|ddig|d<|S|d krJd |vrF|}gd }i}|D]}||vr||||<|ddig|d<|Si}|}gd }|D]}||vr||||<|ddig|d<|Sgd }i}|}|D]}||vr||||<|ddig|d<|S|S) z Make an optional parameter schema nullable to allow None values. For optional parameters, we need to allow null values in addition to the specified type to handle cases where None is passed for optional parameters. r rr typenull)arrayobjectrEr!)defaultr+titleexamplerFr)r#r5listr6r%r&)r original_type array_schematop_level_fieldsnullable_schemar) object_schemaoriginal_schemas r!_make_optional_parameter_nullablerQs}&Gv--F1B1B &**V$$d++&.0H0H v mS ) )7 ' 333!G++60A0A#);;==L'U'U'U$&(O"2MM L005A5E5Ee5L5LOE20N/OOG,**"h..<63I3I$*KKMMM'U'U'U$&(O"2NN M115B5F5Fu5M5MOE20=?O/POG,**')O&,kkmmO'U'U'U$!1PP O335D5H5H5O5OOE20?&&AQ/ROG,**$R#Q#Q "$"(++---LLE//1@1D1DU1K1K.,;ff=M+N(&& Mr Troute convert_refsc0 !"i}g}i}ttttd}i}|jD]'}||j|j(|jrj|jjr]tt|jj}|r t|jj|} n|jj|} |jj r$| ds|jj | d<d| vrt| dtri} g} | dD]U} t| tr>d| vr| | dd| vr| | dV| | d<| rt!!fd| D| d<| dd| di}t} |D]}| |t|}| |z}|jD]}|j|vr|jd|j}|jr|||j|jd ||<|rt|j|j }n?|j}|j r| ds |j |d<| dd }d |jd }|r |d ||d<n||d<|||<|jr||j|j|jd ||j<|rt|j|j }n?|j}|j r| ds |j |d<|||j<|jr0|jjr#d| vr1|s/| |d<|jjr|dddd |d<n|r]|D]\}}|||<d|d ||<|jjr)|| dgn| dd}ddl}|dd|}|r|drd}| ||<|jjr||d|d ||<d||d}|j}|r|r|}|D],\}}t|trt|||<-t" "fd  |"rrd}|sKt?"}t"D]}||vr ||t?"|k}|K"fd|D|d<n||d<||fS)a Combines parameter and request body schemas into a single schema. Handles parameter name collisions by adding location suffixes. Also returns parameter mapping for request director. Args: route: HTTPRoute object Returns: Tuple of (combined schema dictionary, parameter mapping) Parameter mapping format: {'flat_arg_name': {'location': 'path', 'openapi_name': 'id'}} )pathqueryheadercookier+r rrequiredcFg|]}|v||Sr)add)rxseens r z3_combine_schemas_and_map_params..s3+++qDyyDHHQKKyAyyyr N__)location openapi_name(z parameter) r-bodyrHrz [^a-zA-Z0-9_]_ body_datarF)rCrrYct|trd|vrft|dtrK|d}|dr.|dd|D] }|dSt|tr|D]}|dSdS)z%Recursively find all $ref references.r-r0r.r/N)r#r$r6r7r[r8valuesrJ)valuerefrrAfind_refs_in_value used_refss rrlz;_combine_schemas_and_map_params..find_refs_in_valueseT** 1:eFmS+I+I#Fm>>*55>%MM#))C..*<==="\\^^..**1----..t,,1 %11**400001111r Fc$i|] \}}|v || Srr)rname def_schemarms rrz3_combine_schemas_and_map_params..s4###(jy((*(((r $defs) set parametersr`r[ro request_bodycontent_schemanextiterr2r+r5r#rJr$updateextendr&rikeysrYappendschema_r% capitalizer!lowerresubisdigitrequest_schemaslen)#rRrSrrY parameter_mapparam_names_by_location body_propsparam content_type body_schema merged_propsmerged_required sub_schemaall_non_body_paramslocation_paramsbody_param_namescolliding_params suffixed_name param_schema original_desc location_descr3r4 param_namerresult schema_defsall_defsror collected_all initial_countrlr]rms# @@@r_combine_schemas_and_map_paramsrs JHM%%%%  J!@@/33EJ???? '7e0?'7D!3!BCCDD   J0"1,?KK ,;LIK   ) H+//-2P2P H).);)GK & k ! !jW1Et&L&L !L O)'2 G G j$//G#z11$++J|,DEEE!Z//'..z*/EFFF)5K % uu++++.+++ J' OOGT * * * __\266 %%299;;44""?3333:??,,--*-==!5252 :) ) )$z==U^==M~ / ..."N % ,,M- (  D5emUEVWW $}1133 $D\-=-=m-L-LD272CL/(,,]B??MH 9 9 ; ;HHHM <1>.P.P.P.P ]++.; ]+ )5J} % %~ , +++"N % ))M%* %  D5emUEVWW $}1133 $D\-=-=m-L-LD272CL/ &2Juz " " &Ye0?&Y [  "-Jv !* ('''17$P$PM& ! !  Y*4*:*:*<*<  & ;(3 9%!'$-,, i(( !* A  B ? ?@@@%&99??AAJ III 0#zBBJ )A!6!6!8!8 )( %0Jz "!* , +++5;Z(X(XM* % F 'K-* , *"''))H ( 0 0 D D ffd++D%;F%C%CHTNI 1 1 1 1 1 1  z * * *  % 'D$' NNM $Y??8++..x~>>>$' NNm$CM (D####,4NN,<,<###w*F7O =  r c*t|\}}|S)a@ Combines parameter and request body schemas into a single schema. Handles parameter name collisions by adding location suffixes. This is a backward compatibility wrapper around _combine_schemas_and_map_params. Args: route: HTTPRoute object Returns: Combined schema dictionary )r)rRr rfs r_combine_schemasrs066IFA Mr responsesschema_definitionsopenapi_versionc|sdSgd}d}|D]}||vr ||}n|3|D]\}}|dr|}n||jsdSgd}d}|D]} | |jvr|j| }n|R|jrKtt |j} |j| }t d| |rt|tsdSt|} d| vrS|rQ| d} | dr4| dd } | |vrt|| } |r'|d rd d l m }|| |} | d dkr dd| idgdd}|} |r|}|D],\}}t|trt|||<-|rT|d r?d d l m }t|D]}||||||<|| d<| S)a Extract output schema from OpenAPI responses for use as MCP tool output schema. This function finds the first successful response (200, 201, 202, 204) with a JSON-compatible content type and extracts its schema. If the schema is not an object type, it wraps it to comply with MCP requirements. Args: responses: Dictionary of ResponseInfo objects keyed by status code schema_definitions: Optional schema definitions to include in the output schema openapi_version: OpenAPI version string, used to optimize nullable field handling Returns: dict: MCP-compliant output schema with potential wrapping, or None if no suitable schema found N)2002012022042)zapplication/jsonzapplication/vnd.api+jsonzapplication/hal+jsonzapplication/ld+jsonz text/jsonz/Using non-JSON content type for output schema: r-r0r.r/z3.0r)%convert_openapi_schema_to_json_schemarCrFrT)rCrrYzx-fastmcp-wrap-resultrq)r!r7rurvrwloggerdebugr#r$r2r8json_schema_converterrr5r%rJrz)rrr success_codes response_info status_code resp_infojson_compatible_typesr rfirst_content_type output_schemar<r=rwrapped_schemaprocessed_defsrodef_names r$extract_output_schema_from_responsesrsf( t100MM$ ) # #%k2M E $ &/oo&7&7   "K%%c**  )  M$@tF- =7 7 7"1,?F E 8 ~-6~!$}'C"D"DEE-.@A R>P R R    FD11t+622M#5 (   z * * X"..--b1K000 67I+7V W W  ?55e<< PPPPPP== ?    H,,#]3! %)    ' 0+0022*0022 F FLD&&$'' F'=f'E'Et$  99%@@  T T T T T T !4!4!6!677  +P+P"8,o,,x(("0 g r )rrrQrr)N)T)NN)__doc__typingrfastmcp.utilities.loggingrmodelsrrr__name__rrr$r6r2rQr;tuplerrr__all__rr rrs(;;0000007777777777 H  ;Z$%6;:;L;;;;~5966 sCx.6'*Tz6 #s(^6666rKd38nKc3hKKKK`h!h! h!h! 4S>4T#s(^ 34 45h!h!h!h!VI$sCx.&15"&zzC%&zS#X-z4Zz #s(^d zzzz|   r