+ lHjERt^RIt^RIt^RIt^RIt^RIHtHtHtH t H t ^RI H t ^RI Ht^RIHt^RIHt]P&!R4tRtR1t]^,^,^,t]3R R lltR R ltR RltRRltRRltRRRRRR/RRlltRRRR/RRlltRRRRR R/tRR/R!R"llt R#R$lt!^t"^t#R%R&lt$R'R(lt%R)R*lt&R+R,lt'R-R.lt(R2R/R0llt)R#)3zRendering of MCP tool-result content blocks into model-facing text: size capping, _meta filtering, image/audio caching to MEDIA tags, resource links and embedded resources.N)AnyDictListOptionalTuple)strip_unicode_tags) mcp_field)mcp_prefixed_tool_nametruncate_head_tailztools.mcp_toolic<V^8dQhR\R\R\/#)text max_charsreturn)strint)formats";/home/ubuntu/.hermes/hermes-agent/tools/mcp_tool_content.py __annotate__r s'CCCCCCY\Cc\WRR7#)z:Bound pathological MCP text before it propagates (#56059).z MCP RESULT)labelr )rrs&&r_truncate_mcp_text_resultr s d\ BBrc0V^8dQhR\R\/#)r keyr)rbool)rs"rrr%s s s3 s4 srcaVPR4pV^8:dR#VRVPR4o\;QJd(V3Rl\S44F 'gK R# R#!V3Rl\S444#)zTrue if an MCP ``_meta`` key uses a protocol-reserved prefix: a ``modelcontextprotocol`` or ``mcp`` label followed by at least one more label. A trailing one (``com.example.mcp/...``) is a vendor namespace. Ported from MoonshotAI/kimi-code#2600. /FN.c3l<"TF)wrVR9;'dV\S4^, 8xK+ R#5i)modelcontextprotocolN)r!mcp)len).0irlabelss& r ,_is_reserved_mcp_meta_key..0s5r`qT\TUu77OOAF a4HabcHd414LC f ;;$ gsA3 A3A3c$V^8dQhR\/#r0r)rs"rrr<sAASArc\T;'gR4PR^4^,P4P4#)zC``type/subtype`` of a MIME string, lower-cased, parameters dropped.;)rr*striplower) mime_types&r _base_mimerB<s7 yB  % %c1 -a 0 6 6 8 > > @@rc0V^8dQhR\R\/#)r rArr;)rs"rrrAs;;#;#;rcj\V4pVR9dR#\P!V4;'gR#)z>File extension for an MCP image MIME type (``.png`` fallback).z.jpgz.png> image/jpg image/jpeg)rB mimetypesguess_extension)rA normalizeds& r"_mcp_image_extension_for_mime_typerJAs1I&J00  $ $Z 0 : :F:rcap_what cap_suffixr= decode_failcV^8dQhR\R\R\\,R\R\R\\\,\3,/#)r whatrrKrLrMr)rrtuplebytes)rs"rrrIsM#c "%9<FKHUZO]`L`FarcV'd:\V4\8d&RRV R\V4^,^, RV R23#\P!V4pT'd,\T4\8dRRT R\T4 RT R23#TR3# \\ 3d&p\ PRYT4RT3uRp?#Rp?ii;i) zBase64-decode one block payload: ``(bytes, "")`` or ``(None, inline_marker)``. With ``cap_what`` the payload is rejected on b64 length BEFORE decoding and on decoded size after. Decode failures warn and return ``decode_fail`` ("" = drop the block).Nz[MCP z too large to cache: ~z bytes]zMCP %s decode failed (%s): %sz too large to cache: r=) r#_MCP_RESOURCE_MAX_B64_CHARSbase64 b64decode TypeError ValueErrorloggerwarning_MCP_RESOURCE_MAX_BYTES)datarOrrKrLrM raw_bytesexcs&&&$$$ r_decode_block_b64r_Is CI ;;uXJ&(*args, **kwargs)``: ``(path, "")`` or ``(None, marker)``. Fail-open so one bad block never kills the tool result: gateway deps missing (cron without gateway) → ``unavailable``; any other cache error → warning + ``failed``.Nr=u=MCP %s caching skipped — gateway.platforms.base unavailablezMCP %s cache failed: %s) gateway.platforms.base platformsbasegetattr ImportErrorrYdebug ExceptionrZ) rcrOrdr`raargskwargs_baser^s &&&$$*, r_write_block_cacherpZss ..u%t6v6:: ! TV`a[  0$<V|s'%A3A3A3A.(A3.A3z audio/wavz.wavz audio/x-wavz audio/wavec^V^8dQhR\R\R\\,R\/#)r kindrcrKr)rr)rs"rrrms0 4 4 4S 4PXY\P] 4il 4rc \VRR4p\\VRR44pVeVPV R24'gR#\ WQ R2WdR7wrxVfV#\ W! R2WV!V4R 7wrV fV#R V 2#) zCache an image/audio block and return a ``MEDIA:`` tag. "" (logging, not raising) when the block isn't ``kind`` media, the base64 is malformed, or the cache rejects the bytes: the caller falls through to any text blocks.r\NrAmimeTyperr=z blockrK)extzMEDIA:)rirBr startswithr_rp) blockrrrcext_forrKr\mimer]errpaths &&&&$ r_cache_mcp_media_blockr}ms 5&$ 'D i{J? @D |4??dV1:66&tvV_dVNI "6V6?DQXY]Q^_ID,33fTFO3rc$V^8dQhR\/#r0r;)rs"rrr|sppSprc&\VRR\4#)zVCache an ``ImageContent`` block and return a ``MEDIA:`` tag ("" on any failure).imagecache_image_from_bytes)r}rJrxs&r_cache_mcp_image_blockr|s !%2JLn oorcV^8dQhR\R\\\\\3,\\,3,,/#)r r|r)rrrPr1r)rs"rrrs:(d(d(d%S#XQT 8U2V)W(drc 6^RIHp^RIHp^RIHpHpHpHp^RI H p^RI H pH p Hp V!V4p V!V P44p V 'gR#V !W4wrpV'gV fR#/p\!V!4V4pV !V 4'dW8wdV P#RR7R#R#VP%V 4;_uu_4pVP&pRRR4V!WVVRVR 7pW8wdV P#RR7\)TP+R X^,4TP+R T^,44T8dR#\-T4T8dR#R R R RT//T!T;'gRR43# +'giL;i Y8wdT P#RR7ii;i)u``(image_url part, scale note)`` for one cached MCP image, sized like every other native embed (the result is re-sent each later turn: ``vision.embed_target_bytes``, 1568 px long edge, JPEG) and normalized to a provider-accepted format (BMP and friends → PNG). None when the file cannot be embedded safely. The note maps embedded coordinates back to the original image (a screenshot's pixels are the screen's).Path)Image)_EMBED_MAX_DIMENSION_MAX_BASE64_BYTES_build_scale_note_resize_image_for_vision)resolve_embed_target_bytes)"_detect_image_mime_type_from_bytes_normalize_to_supported_image _validate_raster_image_decodableNT) missing_ok)rAmax_base64_bytes max_dimension force_jpeg scale_out new_width new_heighttype image_urlurl)pathlibrPILrtools.vision_toolsrrrr!tools.vision_tools_history_budgetrtools.vision_tools_image_preprrr read_bytesminunlinkopensizemaxgetr#)r|rrrrrrrrrrsrcrzrIr{scaletargetrdimsrs& r_mcp_native_image_partrs >>LQQ t*C -cnn.> ?D 9#DJc j E +-/@ AF / ,J 7 7       .  ZZ # #u::D$&zTZ5IVZfkm       . 599[$q' *EIIlDG,LMPdd 3x& Kucl ;=Nu}}X\^b=c cc$ #       . s*>E=)E= E*E=* E: 5E==FcRV^8dQhR\R\\,R\/#)r r image_pathsr)rlistr)rs"rrrs%;";";"49;";"rc V'gV#^RIp^RIHpHp^RIHpV!4'gV#.RrvTR\pT'Ed\T4\8dTR\\T4, T\\T4, RrT U u.uF3qTPTP4P\T 43NK5 p p T FzwrT P!4pT'gK TwppT!TR ,R ,4'dTR T R 2, pKPTP#T4T'gKkTR T R T 2, pK| EKT'g\T'gT#\$P&!T4pTP)R4;'gR T 2TR&\$P*!TRR7#RpRRRRRRT/RRRTT,/.TORT/# \ d\PRRR7Tu#i;iuup i \ d\PRT RR7EKWi;i \,\.\03d Y,u#i;i)u*text* as-is, or the ``_multimodal`` envelope carrying the call's cached images when the active route takes images inside tool results — the same gate as ``vision_analyze`` and ``computer_use`` captures (``agent.image_input_mode``, an explicit ``auxiliary.vision`` backend, catalog vision, provider support). The text half keeps the ``MEDIA:`` paths so sharing and full-resolution reads still work. Any failure keeps the text: the paths already carry the images.N)#_should_use_native_vision_fast_path_vision_cpu_executor)repeat_refusalz2MCP native image gate failed, keeping MEDIA: pathsT)exc_infor=z#MCP native image prep failed for %srrz - MEDIA:zN: not attached; this image is already in context (vision.max_calls_per_image).z: resultF) ensure_asciiuRThe image(s) from this call are attached — inspect them with your native vision. _multimodalcontentrr text_summary) contextvarsrrrrrrlrYrk_MCP_NATIVE_IMAGE_CANDIDATESr#_MCP_NATIVE_IMAGE_MAXsubmit copy_contextrunrrappendjsonloadsrdumpsrWrXAttributeError)rrrrrrattachednotes candidateswavepjobsr|jobreadypartnotepayloadheaders&& r_mcp_result_with_native_imagesrs[  `D244K5 "e::;J *X)>>%&L'#>B"?w GGH ::gE: : bF 4 6QWZ_Q_8`lckl D ""W  ITX Y {  BDSW X ,:~6 <  sFG G 9G4G9-H$ !H$ $G10G19#H! H!$IIc$V^8dQhR\/#r0r;)rs"rrrs##S#rc$\VRRRRR7#)zVCache an ``AudioContent`` block and return a ``MEDIA:`` tag ("" on any failure).audiocache_audio_from_bytesc|\PV4;'g!\P!V4;'gR#)z.ogg) _WAV_MIME_EXTrrGrH)rzs&r(_cache_mcp_audio_block..s.]&&t,YY 0I0I$0OYYSYYrzaudio resourceru)r}rs&r_cache_mcp_audio_blockrs ! w0Y! ##rc<V^8dQhR\R\R\/#)r urirArr;)rs"rrrs!rc ^RIp^RIHp^RIHpHpRpV'd=T!T!V!\ V44P;'gR44PpVPRRV4P4p\V4^8dkVPR4wrxp V'dF^\V 4u;8d^ 8:d.MM*VR^\V 4, ^, R,V ,MVR,pV'dVR 9d/\P !\#V44;'gRp R V 2pV# \\3dLi;i) zSafe display filename from the URI's last path segment, used only as a name hint: ``cache_document_from_bytes`` re-sanitizes and prefixes it, so remote path components can't steer the cache location.Nr)urlparseunquoter=z[\x00-\x1f\x7f]r:NNz.binresource>r..)rerr urllib.parserrrr|namerXrWsubr?r# rpartitionrGrHrB) rrA_rerrrrstemdotrvs && r_mcp_resource_filenamers. D  S 2 7 7 = =2>?DDD 77%r4 0 6 6 8D 4y3-39<SXASQSASt(cCHnq()C/#5Y]^bYc 4;&'' 9(=>HH&# KI&   s%D3D33EEc0V^8dQhR\R\/#)r block_typerr;)rs"rrrsNNNNrcRV 2.p\VRRR4pV'dVPRV 24\VRR4;'g\\VRR4RR4pV'dVPRV 24RF;p\WR4p\V\4'gK'VPR V 24M \VR R4pV'd+\V\ 4'dVPR V 24R R P V4 R2#)uInline notice for an unsupported MCP content block (kimi-code#3227): silently dropping it leaves the model unaware content went missing. Carries whatever handles the block exposes — mime type, uri, size, name — so the agent can fetch or reason about the missing content.ztype=rArtNz mimeType=rruri=zsize=rzname=z)[MCP content dropped: unsupported block (, z)])r sizeInBytes)rrrir3rrjoin)rxrdetailsrzr size_attrrrs&& r _render_mcp_dropped_block_noticerszl#$G UKT :D 4&)* % % _ _ D1QSXZ^)_C cU|$, u. dC NNU4&> *  - 5&$ 'D 4%%tf~& 6tyy7I6J" MMrc0V^8dQhR\R\/#)r server_namerr;)rs"rrr%s'{'{3'{'{rc \VRR4pVR8Xg,\VR4'd\VR4'gVR8wd\VRR4pV'gR#\VRR4;'gRp\VR R R4;'gRpR V 2V'dR V 2MR,V'dR V 2MR,pV'd \VR4MRpRV RV R2#\VRR4pVfR#\VRR4p V e\ \ V 44#\VRR4p V fR#\ \VRR4;'gR4p\ \VR R R4;'gR4p\ T RT;'gTRRV 2RT;'gT R2R7wrV fV #T;'gRp \RRRT \W54R\V 4 RV R2RT;'gT R2R7wrVfV #RV R V R!\V 4 R"2#)#uRender a ``ResourceLink`` or ``EmbeddedResource`` block as text: embedded text → the text; embedded blob → decoded (size-capped) into the document cache with a path marker; link → the URI plus a pointer at the server's read_resource tool (no fetch here — links are only readable via the originating session). "" for non-resource blocks; failures are reported inline rather than silently dropped.rr= resource_linkrrrNrrArtrz, name=z , mimeType= read_resourcez#the MCP server's read_resource toolz[MCP resource link: u — fetch it with rSblobzembedded resourcez, uri=z-[MCP embedded resource could not be decoded: )rKrLrMz unknown typecache_document_from_bytesz![MCP embedded resource received (z bytes, z1) but document cache unavailable in this process]z,[MCP embedded resource could not be cached: )r`raz[MCP resource saved to z (ru5 bytes) — read it with read_file or terminal tools]) rihasattrrr rrr_rprr#)rxrrrrrzrreaderrrrr]r{rrr|s&& r_render_mcp_resource_blockr%s3 +J_$)>)>wuV`GaGafptzfzeUD)ufb)//R Z<BB,dGD6"2C_cUYTZG[iklIT' _EZ%gY.A&KKuj$/H 8VT *D !#d),, 8VT *D | ghr*00b 1C y; B?EE2 FD& !4;;39L[abeafYgCDKKC=PQRTNI  ! !>D"#%8*iQghkQr7I7GxPTvVGH=dkkc]!LNID | $TF"TF"S^4DDy zzri )r=)*__doc__rUrloggingrGtypingrrrrrtools.ansi_striprtools.mcp_tool_commonrtools.mcp_tool_schemar tools.tool_output_truncater getLoggerrY_MCP_HARD_RESULT_CAP_CHARSr[rTrr.r9rBrJr_rprr}rrrrrrrrrrrr s 33/+89   + ,'+59Q>B;UC sA ;PT(*?A" *, <>  fmV\6R  4`d 4p !(dV;"|#2N,'{'{r