+ lHj@NRt^RIHt^RIt^RIt^RIHt^RIHt^RI H t H t ^RI H t ]P!R4tRR R R R R R RRRRRRR/t]!0R,m4tRRltR-tRRltRRltRRltRRltRR ltR!R"ltR#R$lt^dtR%t]]3R&R'lltR(R)ltR.R*R+llt R#)/aCImage format detection, normalization and region cropping for vision tools. Everything here runs BEFORE an image is base64-embedded: a vision tool result is baked into immutable history and re-sent every turn, so an unsupported media type or corrupt bytes would wedge the session with a non-retryable 400 on every resume. ) annotationsN)BytesIO)Path)AnyOptional)get_hermes_dirztools.vision_toolsz.jpg image/jpegz.jpeg.png image/pngz.gif image/gifz.bmp image/bmpz.webp image/webp.svg image/svg+xmlc V^8dQhRRRR/#urlstrreturn Optional[str])formats"B/home/ubuntu/.hermes/hermes-agent/tools/vision_tools_image_prep.py __annotate__r#s R RS R] Rc4VPR4^,P4pVPR4'gR#V\R4RP R^4^,P 4;'gRpVR8XdRMRV 2pV\ 9dR#T#) z``image/`` of a ``data:image/...`` URL the inline-image wire paths reject (``image/jpg`` counts as JPEG); None for accepted rasters and for non-data URLs (the provider owns remote-URL validation).,z data:image/N;unknownjpgrzimage/) partitionlower startswithlensplitstrip _ANTHROPIC_SUPPORTED_MEDIA_TYPES)rheadersubtype media_types& r#unsupported_inline_image_media_typer+#s]]3  " ( ( *F   ] + +S'()//Q7:@@BOOiG!(E!1y7IJ!AA4QzQrc V^8dQhRRRR/#)r image_pathrrrr)rs"rrr4sNNTNcNrc^\PVPP4R4#)z7MIME type from file extension (defaults to image/jpeg).r)_EXTENSION_MIME_TYPESgetsuffixr")r-s&r_determine_mime_typer24s$ $ $Z%6%6%<%<%> MMrc V^8dQhRRRR/#)rdatabytesrrr)rs"rrr9s..U.}.rcrVR,pVPR4'dF^RIHpTP \ T44;_uu_4pTP 4RRR4R#\F wrEVPV4'gKVu# \V4^ 8dVR,R8XdVR,R 8XdR #\V4^ 8dVR ,R 8XdVR,p\PVR,R 4pV^8d^M\V\V44pV0\^V^, ^4U u0uF qW^,kK up ,p V 0Rm,'dR#V 0Rm,'dR#R# \dR#i;i +'giR#;i \dR#i;iuup i)uMagic-byte MIME sniff (authoritative; no extension trust). ``None`` for anything without a recognized header — including SVG, which has none (the resolver sniffs ``av01avifavis>heicheimheisheixhevchevxmif1msf1)r#PILr9 ImportErroropenrverify Exception_MAGIC_MIME_TYPESr$int from_bytesminrange) r4r(r9imagemagicmimemajorbox_sizelimitibrandss & r"_detect_image_mime_type_from_bytesr]9s}#YF -..  ! GDM**e +)    U # #K) 6{bVBZ72vd|w7N 6{bVC[G3t  >>&*e4mXs6{)CU2uqy!5LM5L1UO5LMM / / /     K  +*  *NsFE<"F" FF"8F4< F  F  F F"F"" F10F1cV^8dQhRR/#)rr frozensetr)rs"rrrjs , , ,rc^RIHp^RIHpHpT!\ V!R4;'gR4\ V!R4;'gR44'dV#\# \ d \#i;i)uFormats the ACTIVE main model's server can decode. The managed llama-server decodes with stb_image — no WebP — and an undecodable image part fails SILENTLY (the model confabulates), so the set is narrowed there and normalization converts those formats to PNG.)_runtime_main_value)ACCEPTED_IMAGE_MIMESis_managed_providerproviderbase_url)agent.auxiliary_clientra%hermes_cli.local_runtime.capabilitiesrbrcrrOr')_vrbrcs r_supported_media_typesrjjsk Dc s2j>#7#7R8#bn>R>RPR:S T T' ' U ,+   ++ s"#AAAA A-,A-c V^8dQhRRRR/#)rpathrrboolr)rs"rrrxs555$5rclVP4;'dVP4P^8#))existsstatst_size)rls&r_nonempty_filersxs' ;;= 4 4TYY[00144rc$V^8dQhRRRRRR/#)rsvg_pathrout_pathrrmr)rs"rrr|s!DDTrc ^RIpVP\V4\V4R7\V4# \dMi;i^RIHp^RIHpT!\T44pTe)TPT\T4RR7\T4#M \dMi;i^RI p^RI pRR\T4\T4.R \T4R R T 2.3FjpTPT^,4'gK#TPTR R ^TPR 7\T4'dR #KZ \dKhi;i R#)u_Best-effort SVG → PNG via cairosvg, svglib+reportlab, rsvg-convert, inkscape (all soft deps).N)rwrite_to)svg2rlg)renderPMPNG)fmtz rsvg-convertz-oinkscapez--export-type=pngz--export-filename=T)checkcapture_outputtimeoutstdinF)cairosvgsvg2pngrrsrO svglib.svglibryreportlab.graphicsrz drawToFileshutil subprocesswhichrunDEVNULL) rurvrryrzdrawingrrcmds && r_rasterize_svg_to_pngr|s@ S]S]Ch''     )/#h-(     XE  B!(+ +      s8}c(m< S]$7;MhZ9XY[ <<A   s$tRWaWiWij!(++,  [ s436 AAAB B B 91D// D>=D>c V^8dQhRRRR/#rr)rs"rrrs rc  ^RIp^RIHp^RIHpVP R4wrEpRVP 49dVPV4MV!V4P4p^RI H pH p T!RR4p T R \P!4 2, p T PR 4T PR 4rT P!T4\#Y4'g;Y3F0pT!\$4;_uu_4TP'4RRR4K2 R#R TP)T P+44P-R 4,Y3F0pT!\$4;_uu_4TP'4RRR4K2 # \dR#i;i +'giK;i +'giKl;i Y3FDpT!\$4;_uu_4TP'4RRR4K2 +'giKC;i i;i)uN``data:image/svg+xml[;base64],...`` → ``data:image/png;base64,...`` through the same soft-dependency rasterizers vision_analyze uses; None when the payload does not decode or no rasterizer is available. Request-path callers decide the fallback (Responses backends 400 on SVG source, so the caller must never forward the SVG itself).N)suppress)unquoterz;base64)_secure_cache_dir_write_private_bytes cache/visiontemp_vision_imagesinline_rr zdata:image/png;base64,ascii)base64 contextlibr urllib.parserr!r" b64decodeencoderOtools.vision_toolsrruuiduuid4 with_suffix write_bytesrOSErrorunlink b64encode read_bytesdecode)rrrrr(_payloadrawrrout_dirstemrupng_pathrls& rrasterize_svg_data_urlrs #$s+Fw+4 +Ffw'GT[L\LcLcLeK0DEG wtzz|n- -D))&143C3CF3KhS!$X88(D'"" #")(&*:*:8;N;N;P*Q*X*XY`*aa(D'"" #") #"""""(D'"" #""")sSz1pillow-heif unavailable; relying on Pillow for %sr8RGBAr{rz'Failed to normalize %s image to PNG: %sz Image format z is not supported by the vision API and could not be converted to PNG (install Pillow for raster conversion). Convert it to PNG or JPEG and try again.)NNuThis is an SVG, which vision models cannot read directly, and no SVG rasterizer is installed (tried cairosvg, svglib, rsvg-convert, inkscape). Convert the SVG to PNG first — e.g. open it in a browser and screenshot it — then re-run vision_analyze on the PNG.)r?r>)RGBrL)NNzThis is a HEIC/HEIF image (common for iPhone photos), which vision models cannot read directly, and no HEIF decoder is available. Install one (`pip install pillow-heif`) and re-run vision_analyze, or convert the image to PNG/JPEG first.)NNuThis is an AVIF image, which vision models cannot read directly, and no AV1 decoder is available. Upgrade Pillow (>= 11.3 bundles AVIF support) or install a pillow-heif build with an AV1 codec, then re-run vision_analyze — or convert the image to PNG/JPEG first.)rjrrrrr pillow_heifregister_heif_openerrOloggerdebugrKr9rMmodeconvertsaverswarning) r-rrrrvr _PILImage_img_excs && r_normalize_to_supported_imagers .00$..40DEG:djjl^488H'  6 6[$. .L L44 ]   , , .,* ^^J ' '4yy 44||F+ IIhuI -( ( # #[$. . $$   ()@ A BB5 ] LLLm \ ]( ' ,@-V L (K K L (, , ),sT*C=?D76D$D7=!D! D!$ D4 /D77 E>E9 E>&E9.E>9E>ic(V^8dQhRRRRRRRR/#)rr-r max_framesrQ max_pixelsrrr)rs"rrrs2!!!!!BO!rc ^RIHpHpTP T4;_uu_4pTP 4RRR4TP T4;_uu_4p^p\ TPT4^R7FswrxYq8dRT RT R2uuuRRR4#YhPTP,,p Y8dRT RT R T R 2uuuRRR4#TP4T pKu RRR4R# \dR#i;i +'giL;i +'giR#;i \dp R T 2uRp ? #Rp ? ii;i) aReturn an error unless Pillow can fully decode every frame. Header sniffing and ``Image.open`` only inspect containers: a timed-out download can look like a valid PNG with a truncated pixel stream. Without Pillow the image passes unvalidated rather than rejecting everything.)r9 ImageSequenceN)startz+Image validation rejected animation: frame z exceeds the maximum z validated frames.zOImage validation rejected animation: aggregate decoded pixel count would reach z at frame z, exceeding the maximum .z"Image could not be fully decoded: ) rKr9rrLrMrN enumerateIteratorwidthheightloadrO) r-rrr_PILImageSequencerUvalidated_pixels frame_numberframenext_validated_pixelsexcs &&& r _validate_raster_image_decodablersBN: ^^J ' '5 LLN( ^^J ' '5 '01B1K1KE1RZ['\# ,!!-.C%,&8:; ( ')9;;;U(U%(533H2I'.(@%,a)*( ' #8 (](& 1 ( ' ' '&  :3C599:szC6D/D!D/4D D/6D D/D,D/6 DD D D/ D, &D/,D// E :E>E E c$V^8dQhRRRRRR/#)rr-r max_dimensionrQrrmr)rs"rrrs!   c d rc^RIHpVPV4;_uu_4p\VP4V8uuRRR4# +'giR#;i \ dR#i;i)uTrue if the longest side exceeds ``max_dimension`` px (Anthropic's 8000px per-side cap is independent of bytes). False without Pillow or on unreadable files — a missing soft dependency must never break the embed path.r8NF)rKr9rMmaxsizerO)r-rrrs&& r_image_exceeds_dimensionrsK* ^^J ' '4tyy>M1( ' ' ' s-AA A A AA A'&A'c(V^8dQhRRRRRRRR/#) rr-rregionr offset_outzOptional[dict]rrr)rs"rrr+s,';';';!';/=';8';rc^RIHp\T\\ 34'dK\ T4^8Xd;\;QJdRT4F 'dK RM RM !RT44'gR#TPT4;_uu_4pTPwrVRT4wrxrR\YxY3YV3^,44wrrY8:gY8:d)RRRT R T R T R T R T R T R T R T R 23uuRRR4#TPYY34pTe!TPYY, Y, R7TPTP R\P !4P"R, R24pTP$R9dTP'R4pTP)TRR7TRR3uuRRR4# \dRu#i;i +'giR#;i \*dpRRRT 23uRp?#Rp?ii;i)uCrop to ``region`` = [x1, y1, x2, y2] (original-image pixels), BEFORE downscaling so the crop gets the full resolution budget. Coordinates clamp to the image bounds; a zero-area/inverted region is rejected with an error naming the real dimensions. Returns ``(cropped_temp_path, mime, None)`` — caller owns cleanup — or ``(None, None, error)``. Ported from QwenLM/qwen-code zoom-image.ts (Apache-2.0).r8Nc3"TF8p\V\\34;'d\V\4'*xK: R#5iN) isinstancerQfloatrm.0vs& r %_crop_image_region..:s3\U[PQJq3,/KK 1d8K4KKU[s !AAFTc38"TFp\V4xK R#5ir)rQrs& rrrAs5fc!fffsc3P"TFwr\^\W44xK R#5i)roN)rrS)rrbs& rrrBs"!k@j#aQ"3"3@js$&zInvalid region [z, zG]: crops to zero area after clamping to the image bounds. The image is xu+ px — pick x1r r rr ))sr))sGIF87asGIF89ar )sBMr r)!__doc__ __future__rloggingriorpathlibrtypingrrhermes_constantsr getLoggerrr/r_r'r+rPr2r]rjrsrrr!_VISION_MAX_VALIDATED_FRAME_COUNT&_VISION_MAX_VALIDATED_AGGREGATE_PIXELSrrrrrrrs#  +   / 0 L \ K K K \ O$--c#d  R N .b ,5@8:B~%(!)4& 8<!H ';';r