Ki< >dZddlZddlZddlmZddlmZmZmZeje Z dde de ded e e zfd Zd ede d ee e ffd Zd edzd efdZddeded e fdZ dde de edzdedzd e fdZ dde dee efde edzdedzd e f dZgdZy)z6Parameter formatting functions for OpenAPI operations.N)Any) JsonSchema ParameterInfoRequestBodyInfovaluesparameter_nameis_query_parameterreturnc td|Drdjd|DS g}|D]}}t|trQg}|j D]\}}|j |d||j dj|d|j t |dj|S#t$r}|rdnd} tjd| d |d ||r|cYd }~St |jd d jdd jdd jdd } | cYd }~Sd }~wwxYw)aj Format an array parameter according to OpenAPI specifications. Args: values: List of values to format parameter_name: Name of the parameter (for error messages) is_query_parameter: If True, can return list for explode=True behavior Returns: String (comma-separated) or list (for query params with explode=True) c3fK|])}t|ttztztz+ywN) isinstancestrintfloatbool).0items p/home/jay/workspace/scripts/.codegraph-venv/lib/python3.12/site-packages/fastmcp/utilities/openapi/formatters.py z)format_array_parameter..s% I$:dC#I-4 5 Is/1,c32K|]}t|ywr)r)rvs rrz)format_array_parameter..s/1A/s:.querypathzFailed to format complex array z parameter 'z': N[]'") alljoinrdictitemsappendr Exceptionloggerwarningreplace) rr r formatted_partsr item_partskre param_type str_values rformat_array_parameterr3 sI I& IIxx////  2D$%  JJL2DAq%%1QCj12&&sxx ';<&&s4y1 2xx((  2W -j\nEUUXYZX[ \  MF b!b!b!b!  %s+BC E 'E 1E7A E E E param_valuect|ts&tjd|dt |iSi}|j D]\}}|d|d}t |||<|S)a Format a dictionary parameter for deep-object style serialization. According to OpenAPI 3.0 spec, deepObject style with explode=true serializes object properties as separate query parameters with bracket notation. For example, `{"id": "123", "type": "user"}` becomes `param[id]=123¶m[type]=user`. Args: param_value: Dictionary value to format parameter_name: Name of the parameter Returns: Dictionary with bracketed parameter names as keys zDeep-object style parameter 'z' expected dict, got rr!)rr&r*r+typer'r)r4r resultkeyvalue bracketed_keys rformat_deep_object_parameterr;Bs& k4 (+N+;;PQUVaQbPc d  F!'')+ U)*!C52 #E }+ Mschemac^|rt|tsyd|vr|dSd|vr t|dtr |dr|ddSd|vr t|dtr |dr|ddSd|vr|dS|jd}|dk(ri}|jd i}t|trvt |jd g}t|j d d }|D]}||vst ||||<|D]}||vs||vs t ||||<|r|Sd diS|dk(r6|jd}t|trt |} | | gSgSdgS|dk(r0|jd} | dk(ry| dk(ry| dk(ry| dk(ry| dk(ryy|dk(ry|d k(ry!|d"k(ry#|d$k(ry y%)&zy Generate a simple example value from a JSON schema dictionary. Very basic implementation focusing on types. unknowndefaultenumrexamplesexampler6object propertiesrequiredNr8r9arrayr' example_itemstringformatz date-timez2024-01-01T12:00:00Zdatez 2024-01-01emailzuser@example.comuuidz$123e4567-e89b-12d3-a456-426614174000bytez ZXhhbXBsZQ==integerrnumberg?booleanTnull unknown_type)rr&listgetsetkeysgenerate_example_from_schema) r= schema_typer7rErequired_propsprops_to_include prop_namereq_prop items_schema item_example format_types rrYrYds= FD1Fi   Jvf~t<f~a   f vj)4 0 : j!!$$Fi  **V$KhZZ b1 j$ ' J!; E2 E  jj* + %) &  ' !% & 9 & !  !    !   r<dataindentch tj||}d|dS#t$r d|dcYSwxYw)z8Formats Python data as a JSON string block for Markdown.rcz```json z ```z!``` Could not serialize to JSON: )jsondumps TypeError)rbrcjson_strs rformat_json_for_descriptionrjsG@::d628*E** @3D6??@s 11base_description parameters request_bodyc|g}|rq|Dcgc]!}|jdk(s|js |#}}|rC|jd|D]-}|jd|jd|j/dj |Scc}w)a Formats a simple description for MCP objects (tools, resources, prompts). Excludes response details, examples, and verbose status codes. Args: base_description (str): The initial description to be formatted. parameters (list[ParameterInfo] | None, optional): A list of parameter information. request_body (RequestBodyInfo | None, optional): Information about the request body. Returns: str: The formatted description string with minimal details. r **Path Parameters:** - ****:  )location descriptionr(namer%)rkrlrm desc_partsp path_paramsparams rformat_simple_descriptionrzs"##J",WQ f0DqW W    8 9$ P!!F5::,d5;L;L:M"NO P 99Z  XsB BB responsesc 0 |g}|r|Dcgc]}|jdk(s|}}|r^d}|j||D]F}|jrdnd} d|jd| d|jxsd} |j| H|Dcgc]}|jd k(s|} }| r^d }|j|| D]F}|jrdnd} d|jd| d|jxsd} |j| H|r6|jr)d } |j| |jrdnd} |jd |j| |j rd |j vrd nt t|j d} | r|j j| i}t|tr}d|vry|jd|djD]R\}}t|tsd|vs||jdgv}|rdnd}|jd|d|d|dTr200201202204c3,K|] }|vs| ywr)rsr{s rrz4format_description_with_responses..5sJQ1 >qJs Tz (Success)z - Content-Type: ``r6rHr'z" - **Response Item Properties:**z - **rqz - **Response Properties:**rTz - **Example:**re)rsr(rFrurtcontent_schemanextiterrVrr&r'sortedrYrjr%)rkr{rlrmrvrwrx param_sectionryrequired_marker param_desc query_paramsreq_body_section media_typer=r] prop_schemarFreq_markresponse_sectionadded_response_section success_codessuccess_statusresponses_to_process status_code resp_info status_markerr_rCs ` r!format_description_with_responsesrs0##J",EQ f0DqE E 6M   m ,$ .38>>-r%ejj\O3DBuGXGXGm\mFno !!*- . $.Gaw1FG G 7M   m ,% .38>>-r%ejj\O3DBuGXGXGm\mFno !!*- .  002*++7+@+@-bB|7788IJK  & &&)D)DD#$|::;TB  %4488RHfd+ 0F%%&CD282F2L2L2N . ;&{D9 - <'0FJJz24N'NH8@}bH&--"( 2hZr+mB\A] ^ /!&5 J-JDQ )0&,-A&B>  "K)!!"23)-&,7>,ILrM    R b9N9N9cRc8de  ''*Y-E-EE'd9#;#;$0L$@ * 1 12W X>J$0?""'%' !*$:I{)3;(E,9[,H(2(9(9.8 4 TaHbGc,d)* !**V3&--.NO:@:N:T:T:V& 6 ;$.{D$A(5(D$.$5$5*4YKtKP]D^C_(`%& &">v"F"n49L&--.BC&-- ;GA Ny> @ 99Z  yFHsRR RR)r3r;rrjrzrY)F)r)NN)__doc__rfloggingtypingrmodelsrrr getLogger__name__r*rUrrr3r&r;rYrrjrzr__all__rr<rrs_< >>   8 $CH3 3"%3;?34Z3l'* #s(^DPd):PsPf@c@3@s@.2+/!!]#d*!"D(! !L.2+/ Y!Y! SY! ]#d* Y! "D( Y! Y!z r<