+ jHj5 a0t$Rt^RIHt^RIt^RIt^RIHt^RIH t H t H t H t H t HtHt^RIHtHtHtHtHt]P,!]4tRRRR R R /tR ]R &RtRtRRRRRRRRR/RRRRRRRRR/RRRRRRR RR!//tR"]R#&R$tR%t] R&] ]!] 3,3,t"R'R(lt#R[R)R*llt$R+RR,R-R.RR/R0/R1R2llt%R[R3R4llt&R\R5R/R6R7lllt'R8R9lt(!R:R;]4t)RR=/R?R@llt*RARBlt+RCRDlt,RERFlt-RG]RHR/RIRJllt.RG]RKR/RLRMllt/RNROlt0]!RPRQ44t1RRR/RSRTllt2RURVlt3RW]0RXR0/RYRZllt4R#)]zShared helpers for the bundled ``image_gen`` provider plugins. Providers are loaded by path (``hermes_plugins.image_gen__``) and resolve this via the repo root on ``sys.path``; not a plugin itself (the scanner only looks at directories).) annotationsN) dataclass)AnyCallableDictIterableListOptionalTuple)ImageGenProvidererror_responsenormalize_reference_imagessave_b64_imagesave_url_image landscape 1536x1024square 1024x1024portrait 1024x1536dict[str, str] OPENAI_SIZESz gpt-image-2zgpt-image-2-mediumzgpt-image-2-lowdisplayzGPT Image 2 (Low)speedz~15s strengthszFast iteration, lowest costqualitylowzGPT Image 2 (Medium)z~40suBalanced — defaultmediumzgpt-image-2-highzGPT Image 2 (High)z~2minz,Highest fidelity, strongest prompt adherencehighdict[str, dict[str, Any]]GPT_IMAGE_2_TIERSz1Prompt is required and must be a non-empty stringz8openai Python package not installed (pip install openai).c V^8dQhRRRR/#)aspectstrreturn)formats">/home/ubuntu/.hermes/hermes-agent/plugins/image_gen/_common.py __annotate__r)2s<``) from config.yaml; ``{}`` on any failure.N image_genz image_gen.) load_configzCould not load %s config: %s)hermes_cli.configr4 isinstancedictr, Exceptionloggerdebug)r/labelr4cfgsectionexcs& r(load_image_gen_configr?7s;Kj,>E 1m*4S$*?*?#''+&T ?*4Wd*C*Cgkk#&G$Wd33w;;  3U@ s$A:B B B7B2,B72B7explicitinclude_top_levelTconfig passthroughFc<V^8dQhRRRRRRRRRRR R R R R R RR/ #)r"modelsrdefaultr$env_var config_keyr@r0rAboolrBzOptional[dict[str, Any]]rCr%ztuple[str, dict[str, Any]]r&)r's"r(r)r)GsZ$$ %$03$AD$RU$$7;$ %$;?$ $r*c\V\4'd<VP4V9d'VP4WP4,3#\PP V4pV'dW9d WV,3#Vf \ 4MTp V P V4p \V \4'dV P R4MR.p V'd!V PV P R44V F-p \V \4'gKW9gK#WV ,3u# V'd.\RW^,34R4p V 'd V RV RV RR/3#WV,3#)u.``(model_id, meta)`` from a fixed catalog; first *known* id wins (unknown ids fall through): explicit → ``env_var`` → ``image_gen..model`` → ``image_gen.model`` → ``default``. ``passthrough``: an unknown id from ``env_var`` or the provider-scoped ``image_gen..model`` is sent verbatim as the API model with no ``quality`` (OpenAI-compatible gateways serve their own image model names and reject unknown enum values, #97928). The shared top-level ``image_gen.model`` never passes through — it may hold another provider's id.Nmodelc3"TFEp\V\4'gKVP4'gK3VP4xKG R#5iN)r6r$strip).0cs& r( 'resolve_static_model..as5l*GQ:VWY\K]ybcbibibkyqwwyy*GsAAAr api_modelr) r6r$rNosenvironr,r?r7appendnext)rErFrGrHr@rArBrC env_overrider<scoped candidates candidatecustoms&&$$$$$$ r(resolve_static_modelr^Gs*(C  X^^%5%?~~(8!999::>>'*L .L111%+^  !C WWZ F)3FD)A)A&**W%tLJ#'''*+ i % %)*=Y// / lj r*c]tRt^t$RtR]R&R]R&/tR]R&RtR]R &RtR]R &Rt R ]R &/t R ]R&] RRl4t ] RRl4t RRltRRltRRltRtR#)StaticImageGenProvideraIdentity + picker surface from class attributes: ``provider_id``/``label``; fixed catalog via ``models`` (+ ``default_model_id``, ``price``, ``catalog_fields``); single-env-var auth via ``setup`` (kwargs for :func:`api_key_setup_schema`). Dynamic providers override methods.r$ provider_idr;rrENr0default_model_idrgztuple[str, ...]catalog_fieldsr1setupcV^8dQhRR/#r"r%r$r&)r's"r(r)#StaticImageGenProvider.__annotate__s  c r*c VP#rM)rselfs&r(ruStaticImageGenProvider.namesr*cV^8dQhRR/#rr&)r's"r(r)rscr*c VP#rM)r;rs&r( display_name#StaticImageGenProvider.display_names zzr*cV^8dQhRR/#)r"r%rjr&)r's"r(r)rsPP1Pr*c Z\VPVPVPR7#))rg)rsrErrgrs&r( list_models"StaticImageGenProvider.list_modelssDKK)<)   P%22r*rrKrSryc ,V^8dQhRRRRRRRRRR/#)r"providerr$r#rKryr%ErrorFnr&)r's"r(r)r)s0C#W^r*c&aaaaRVVVV3RllpV#)zPReturn ``fail(error, error_type, **override)`` pre-bound to this call's context.c(V^8dQhRRRRRRRR/#)r"errorr$ error_typeoverriderr%r1r&)r's"r(r)#error_factory..__annotate__s.LLCLSLcLnLr*cb<\SSSSR7pVPV4\RRVRV/VB#))rrKry aspect_ratiorrr&)r7updater )rrrkwargsr#rKryrs&&, r(failerror_factory..fails8xuVRXY hKEKjKFKKr*r&)rr#rKryrsffdd r( error_factoryrsLL Kr*c$V^8dQhRRRRRR/#)r"rr$r#r%r1r&)r's"r(r)r)s&PPCPPPr*c.\W4!\R4#)invalid_argument)rPROMPT_REQUIRED)rr#s&&r(prompt_required_errorrs  *?s &&$$$$$$$$ r(materialize_imagers  FD  S~c9:D@ @ $SuWbceiii KLN^_ __  S ?uEzRR R SsA A7 A2,A72A7rc 0V^8dQhRRRRRRRRRRR R/#) r"rzr$rr;rrrrr%r&)r's"r(r)r)s>     %( /=  2   r*c\\WR74# \d-pTe T!T4MTPRY T4TuRp?#Rp?ii;i)zUCache ``url`` locally; on failure warn (or call ``on_fail``) and return the bare URL.rNzC%s image URL %s could not be cached (%s); falling back to bare URL.)r$rr8warning)rzrr;rrr>s&$$$$ r(rrsL >#566    CL KK]_dkn o s A!A A Ac$V^8dQhRRRRRR/#)r"responserr>r8r%r$r&)r's"r(r)r)s&IISIyISIr*cVP4PR/4PRVPR,4# \d(TeTPR,u#\ T4u#i;i)zJ``error.message`` from an HTTP error body, else the first 300 chars of it.rmessage:Ni,N)jsonr,textr8r$)rr>s&&r(requests_error_messagerseI}}""7B/33Ix}}T?RSS I&.&:x}}T"HCHIsAA"A5' A54A5cd]tRt^t$RtR]R&R]R&R]R&^tR]R&RtR]R &R tR ]R &R t R #) HttpFailureuBOne failed ``post_json`` attempt as ``(error, error_type)``. ``kind`` ∈ http / timeout / unreachable (DNS failure or refused connection: nothing was sent) / connection (dropped after connecting) / request / invalid_json; ``message`` = HTTP error text or decode error; ``status`` / ``response`` are set for ``http`` only.r$kindrrintstatusrSrNrrr&) rrrrrrrrrrr&r*r(rrs5< I JOFCOGSHcr*rbase_urlc ,V^8dQhRRRRRRRRRR /#) r"usagerrKr$rrr0r%Noner&)r's"r(r)r)s7mmcmSmCm=mdhmr*cVV'gR#^RIHp^RIHpV!V!WR7RW#R7R#)a'Record a token-billed image call against the ambient session as task ``image_generation``. Token-metered image models (OpenRouter chat-image and Image API models, OpenAI ``gpt-image``) bill exactly like a chat completion, so they get a ``session_model_usage`` row through the same chokepoint as auxiliary calls. ``usage`` is the response's usage block (dict or SDK object). Per-image backends (FAL, xAI, Krea, ...) return no token usage and never call this; a body without tokens is a no-op inside ``record_aux_usage``, as is running outside a turn. N)SimpleNamespace)record_aux_usage)rKrimage_generation)rr)typesragent.aux_accountingr)rrKrrrrs&$$$ r(record_token_usagers' %5e13EPXmr*c V^8dQhRRRR/#)r"r>r8r%rIr&)r's"r(r)r)sII)IIr*c^RIHpHpHpVP'dVP^,MRp\ WA4'd VP MTp\ WSV34#)zTrue when the last connection attempt never connected, so no server accepted the request body (a redirect hop may have answered earlier, but a redirect accepts nothing).) MaxRetryErrorNameResolutionErrorNewConnectionErrorN)urllib3.exceptionsrrrargsr6reason)r>rrrcausers& r(_never_connectedrsHZY888CHHQKE'==U\\5F f3FG HHr* error_messagecatch_request_exceptionc8V^8dQhRRRRRRRRR RR R R R RR/#)r"rzr$headersrpayloadr1timeoutrr;rzCallable[[Any, Exception], str]rrIr%z+tuple[Optional[Any], Optional[HttpFailure]]r&)r's"r(r)r)sP$ $ $ ($ 3A$ LO$ X[$ 2$ "$ 1 $ r*c 2^RIp\V\4'd V^,MTpVPWW#R7p V P 4T P4R3# TP dKp T P p T e T PM^p T!Y4p R\RT RT RT 2RYT R73uRp ? #Rp ? iTPd"R\RT R \T4 R 2R43u#TPd3p \T 4'dR MR pR\Y R T 2R43uRp ? #Rp ? iTPd(p T'ghR\RT RT 2R43uRp ? #Rp ? ii;i \d*p R\RT RT 2R\!T 4R73uRp ? #Rp ? ii;i)uPOST ``payload`` → ``(json_body, None)`` or ``(None, failure)``. ``timeout`` goes to ``requests`` verbatim (message reports the read component); ``error_message(response, exc)`` extracts the backend-specific HTTP error text.N)rrrhttpz image generation failed (z): api_error)rrrrz image generation timed out (zs) unreachable connectionz connection error: connection_errorrequestz request failed: invalid_jsonz returned invalid JSON: invalid_response)r)requestsr6tuplepostraise_for_status HTTPErrorr status_coderTimeoutrConnectionErrorrRequestExceptionrr8r$)rzrrrr;rrr read_timeoutrr>resprrrs&$$$$$$ r( post_jsonrs!+GU!;!;71:L[==G=U!!#$ }}$$%   ;||%)%5!!1*[ ug7xs7)LkT;; ;   `[ % =c,>O=PPRSU^`` `  # #_ 0 5 5}<[0CC5'IK]^^^  $ $[& [ug5Fse,LkZZZ[  [ ug%=cUCEWadehai    sw#A E"E.?B3-E3EE'E6E7'D$E$E7E8EEE" F-F FFrM)r)5__conditional_annotations__r __future__rloggingrU dataclassesrtypingrrrrrr r agent.image_gen_providerr r r rr getLoggerrr9rrGPT_IMAGE_2_API_MODELGPT_IMAGE_2_DEFAULTr rrr7r$rr-r?r^rfrsr}rrrrrrrrrrrr)rs@r(rs@# !GGGbb   8 $!,[(KQ[]hi ni&*&25  )+8  'C6 0,*FK 3S#X& '<  $"$>B$(,$BG$@= "2-2>bPRP0`4:`:>`$ @F 59 I     m[_m&I$ 5K$ %*$ $ r*