+ iHj xa0t$Rt^RIHt^RIt^RIt^RIHt^RIH t H t H t H t H t ^RIHt^RIHt]P$!]4tR2tR]R &Rt!R R ]4tR R ltRRlt]P6 R2tRRRR/RRlltRRRRRRRRRR/tRRRR R!R3/R"R#lltR$R%R&R/R'R(llt R)R*R+R,R-R,R.R,R/]/R0R1llt!R#)4aImage generation provider ABC. Providers register via ``PluginContext.register_image_gen_provider()`` (from ``/plugins/image_gen//`` or ``~/.hermes/plugins/image_gen//``); the one selected by ``image_gen.provider`` services every ``image_generate`` call. One tool covers text-to-image and editing: ``image_url`` / ``reference_image_urls`` route to the provider's edit endpoint, otherwise text-to-image. Mirrors ``agent/video_gen_provider.py``. Response dicts come from :func:`success_response` / :func:`error_response` (``success, image, model, prompt, aspect_ratio, modality, provider`` + ``error, error_type`` on failure). ) annotationsN)Path)AnyDictListOptionalTuple)provider_media)CatalogProviderBase landscapeztuple[str, ...]VALID_ASPECT_RATIOScb]tRt^tRtRRlt]P]3RRRR/RRlll4t R t R#) ImageGenProviderzAbstract base class for an image generation backend. Subclasses implement :attr:`name` and :meth:`generate`; ``list_models`` entries may add ``speed`` / ``strengths`` / ``price`` for the picker.cV^8dQhRR/#)returndict[str, Any])formats"=/home/ubuntu/.hermes/hermes-agent/agent/image_gen_provider.py __annotate__ImageGenProvider.__annotate__#s C Cn Cc RR.R^/#)al``modalities`` (``"text"`` and/or ``"image"``) and ``max_reference_images``; optionally ``supports_upscale`` (bool), ``creative_controls`` (names from the tool's creative-control vocabulary: ``creativity``, ``intensity``, ``complexity``, ``movement``, ``thinking``, ``resolution``) and ``source_image_role`` (``"style"`` when image inputs set the look and are not edited). Surfaced in the dynamic tool schema so the model knows when ``image_url`` / ``upscale`` / each control is honored, and only declared controls are passed to :meth:`generate`; the text-only default keeps non-overriding providers backward compatible. modalitiestextmax_reference_imagesr)selfs&r capabilitiesImageGenProvider.capabilities#svh(>BBr image_urlNreference_image_urlsc 0V^8dQhRRRRRRRRRR R R /#) rpromptstr aspect_ratior Optional[str]r!Optional[list[str]]kwargsrrrr)rs"rrr/sN W W W W ! W 2 W W  Wrc R#)aGenerate an image, or edit ``image_url`` (``reference_image_urls`` are extra style/composition refs, clamped to ``max_reference_images``); any source image routes to the edit endpoint. Return :func:`success_response` / :func:`error_response`. Unknown ``kwargs`` MUST be ignored (forward compat); ``upscale`` (bool) is a post-generation high-res pass, reported as ``upscaled: True`` in ``extra``.Nr)rr#r%r r!r(s&&&$$,rgenerateImageGenProvider.generate.srr) __name__ __module__ __qualname____firstlineno____doc__rabcabstractmethodDEFAULT_ASPECT_RATIOr*__static_attributes__rrrrrsD= C 1 W $( W 59 W Wrrc V^8dQhRRRR/#)rvaluer&rr$r)rs"rrr?sCC C#Crc\V\4'dVP4P4MRpV\9dV#\ #)zClamp to :data:`VALID_ASPECT_RATIOS`; invalid values coerce to landscape so the tool surface forgives agent mistakes instead of rejecting them.) isinstancer$striplowerr r3)r6vs& rresolve_aspect_ratior=?s:",E3!7!7 RA((1B.BBrc V^8dQhRRRR/#)rr6rrr'r)rs"rrrFs^^c^.A^rc.\V\4'dV.p\V\\34'gR#VUu.uFCp\V\4'gKVP 4'gK3VP 4NKE up;'gR#uupi)zCoerce a str or list into a clean list of non-blank strings; ``None`` when nothing usable remains so providers treat "no refs" as one sentinel.N)r9r$listtupler:)r6items& rnormalize_reference_imagesrCFsh% edE] + +%* UUTjs.CL LDJJLU U ] ]Y]] UsBB1Bz/imagesprefiximage extensionpngc(V^8dQhRRRRRRRR/#)rb64_datar$rDrFrrr)rs"rrrSs/hhShShshW[hrc<\P!\WVR7#)zXDecode base64 image data into ``$HERMES_HOME/cache/generated/images/``; return the path.)rDrF)r save_b64_GENERATED_IMAGE_KIND)rIrDrFs&$$rsave_b64_imagerMSs  " "#8(]f ggrz image/pngz image/jpegjpgz image/jpgz image/webpwebpz image/gifgiftimeoutgN@ max_bytesc ,V^8dQhRRRRRRRRRR /#) rurlr$rDrQfloatrRintrrr)rs"rrr]s4     16 JM   rcP\P!\WW#R\RRRRR7 #)zDownload an (often ephemeral) image URL into ``$HERMES_HOME/cache/generated/images/``. Raises on network / HTTP / oversize / empty errors so callers can fall back to the bare URL.rGImagez3Image at {url} returned 0 bytes; refusing to cache.) rDrQrR chunk_size content_typesurl_extensionsdefault_extensionlabel empty_errori)rGrNjpegrOrP)r save_urlrL_URL_IMAGE_CONTENT_TYPES)rTrDrQrRs&$$$rsave_url_imagerb]s0  " "s7,Drs$ # 33 3   8 $(K_J"W*WBC^*::;7Ch7hUh  e[%vWbdi & 9= P` '+( '      -  r