߲j|UdZddlmZddlZddlZddlZddlZddlZddlZddl m Z ddl m Z m Z mZmZmZddlmZmZmZmZmZmZmZddlmZmZmZmZej<eZ dZ!d Z"e!e"fZ#e!de"d iZ$d d d dZ%dZ&dZ'e!ddde"dddiZ(dZ)dZ*dZ+eZ,dZ-dZ.dZ/iZ0de1d<dZ2dZ3dZ4d Z5d!d!d!d"d"d#Z6dd$Z7e7d%d&e2d'd d()e7d*d+e2d,d d()e7d-d.d/e5d0d1d2d34e7d5d6d7e5d8d1d2d34e7d9d:e3d d ;e7dd?d@dAd d)e7dBdCe4d'd1d d De7dEdFe4d'd1d d De7dGdHdIdAd1dJdKDdL Z8dMe1dN<e7dOdOd!d d3;Z9e:hdPZ;dQdRdSdTZe:e!e"hZ?d^Z@d_ZAd`dadbfdcdcddffZBdedfdgdhZCddiZDddjZEddkZFddlZGddmZHddnZI ddoZJddpZKddqZLddrZMddsZNddtZO dduZPddv ddwZQ ddxZRddyZSdddzZTdd{ZUdd|ZV dd}ZWGd~deZXddZYddZZy)uOpenRouter-compatible image generation backend (OpenRouter + Nous Portal). Both speak the OpenAI-style ``/chat/completions`` image protocol (``modalities: ["image","text"]``, references as ``image_url`` parts, output in ``choices[0].message.images[].image_url.url``); only ``(base_url, api_key)`` differs, via :func:`hermes_cli.runtime_provider.resolve_runtime_provider`. OpenRouter alone also has the Dedicated Image API (``POST /images/generations``, own catalog, exact ratios, up to 16 references) — see :func:`_select_surface`. ) annotationsN)Path)AnyDictListOptionalTuple)DEFAULT_ASPECT_RATIOImageGenProvidererror_responseresolve_aspect_ratiosave_b64_imagesave_url_imagesuccess_response) error_factoryload_image_gen_config post_jsonrecord_token_usagezopenai/gpt-5.4-image-2zgoogle/gemini-3-pro-image1:116:99:16)square landscapeportraitgr@zOpenAI GPT-5.4 Image 2z=Highest fidelity; best prompt adherence; slower on OpenRouterdisplay strengthszGemini 3 Pro Imagez2Fast, reliable fallback with good layout adherence)zopenrouter/autog$@OPENROUTER_IMAGE_API_g4@g @z8Dict[Tuple[str, Optional[str]], Tuple[float, frozenset]]_CATALOG_CACHE)r1:41:82:33:23:44:14:34:55:48:1rr21:9)rr(r&rrr%r$auto)rr(r%rr)r$r)r-lowmediumhighF)quality background output_format compressionseedc $||dtddi|S)zLCurated Image API model entry; unspecified knobs default to "not supported".r resolutionsr1) _NO_KNOBS)rrspecs J/home/ubuntu/.hermes/hermes-agent/plugins/image_gen/openrouter/__init__.py_image_api_modelr<Ps Y _) _]TV _Z^ __z0Nano Banana 2 Lite (Gemini 3.1 Flash Lite Image)z;Cheap and fast; 14 exact aspect ratios; 14 reference images)1K) aspect_ratiosr8max_nmax_refsz&Nano Banana 2 (Gemini 3.1 Flash Image)z:Same ratios as Lite plus resolution control (512/1K/2K/4K))512r>2K4KzOpenAI GPT Image 2zFBest editing fidelity; up to 16 references; strongest prompt adherence) rr%r$r(r&rrr,r-)r-opaqueT )r@r2r3r5rArBzOpenAI GPT Image 1 Miniz=The only model here with background=transparent (cut-out PNG))rr%r$r-)r- transparentrFzMicrosoft MAI-Image-2.5z5Standard ratios; a good second opinion next to Gemini)r@rArBzMicrosoft MAI-Image-2.5 Proz.Reach for it when gpt-image-2 misses the briefzGrok Imagine (Image Quality)uAPhotoreal; widest exotic-ratio set (9:19.5, 20:9, 2:1 …); 1K/2K)rr&r(rrr$r%9:19.519.5:99:2020:91:22:1r-)r>rDz Krea 2 Mediumz4Realistic, expressive styles; deterministic via seed)r@r8r6rArBzKrea 2 Medium Turbou?Cheapest here — bulk content, cards, thumbnails; seed supportzQwen Image 3 Proz?Precise small text and detail rendering; n up to 6; 1K/2K; seed) rrNr"rOr$r%r&r'r(r)r*rr) z"google/gemini-3.1-flash-lite-imagezgoogle/gemini-3.1-flash-imagezopenai/gpt-image-2zopenai/gpt-image-1-minizmicrosoft/mai-image-2.5zmicrosoft/mai-image-2.5-prozx-ai/grok-imagine-image-qualityzkrea/krea-2-mediumzkrea/krea-2-medium-turbozqwen/qwen-image-3-proDict[str, Dict[str, Any]]_IMAGE_API_MODELS>r-rrNr"r#rOr$r%r&r'r(r)r*r+rrMr,rrL9:21rKrJ) rr%r(r*r,rOrKrMr'r+) rr$r&r)rUrNrJrLr"r#)r)rrrzDict[str, Tuple[str, ...]]_ASPECT_PREFERENCESpngjpgwebpgifsvg) image/pngz image/jpegz image/jpgz image/webpz image/gifz image/svg+xml> ) resolutionr2r3r4r6n))rgr8)r2N)r3N)r4Noutput_compressionr5c.tdtd|S)Nrd)maxminvs r;rpsC3sA;4Gr=r6c|SNr1rns r;rprpsefr=zapplication/jsonz,https://github.com/NousResearch/hermes-agentz Hermes Agent)z Content-Typez HTTP-RefererzX-Titlect|xsdj}|sy|jdr|St|}ddlm}|| |j }tj|jdxsd}d|d tj|jd S#t$r!}tjd||Yd}~yd}~wwxYw) zUURLs pass through; local files inline as base64 data URIs (``None`` when unreadable).rTN)zhttp://zhttps://data:r)raise_if_read_blockedz%could not read reference image %s: %sr\rtz;base64,ascii)strstrip startswithragent.file_safetyru read_bytesOSErrorloggerdebug mimetypes guess_typenamebase64 b64encodedecode)refpathrurawexcmimes r;_to_image_url_partrs ciR.   C  ~~67 9D7#oo    *1 - <D 4&!1!1#!6!=!=g!F G HH  z%_access_error_hint..s-^S-^s)z no endpointsz no allowedznot a valid modelz data policyz can't reach image model 'z' (u)) — enable OpenAI image access in your z account, or set =.)rylowerany_FALLBACK_MODEL)rmodel_idenv_varstatuserr_msggatedr.s @r;_access_error_hintrs   y ) =b   !C o % ^-^\-^*^E  )-hZs6(C 'y(9'!OCTTU WXr=c~ddl}|j|||rdd|ini|}|jg}t|j dD]h}t |t r|jdnd}t |ts7|jsH|j|j|fj|S)z_``(model_id, entry)`` pairs from ``GET {base_url}{path}``'s ``data[]``; raises on HTTP failure.rN AuthorizationBearer )headerstimeoutdataid) requestsrraise_for_statusrjsonrrrwrxr) base_urlrapi_keyrrresponserentryrs r; _get_catalogrs|| *TFwo 7J%K\^hoH ,.C(--/622&0&=599T?4 h $)9 JJ(%0 12 Jr=c g}t|||tD]\}}t|d} |r-|jtsd| j dxsgvrA|j |i} |j || j d|j dxs|| j d|| j dxsgd|S) zPicker rows from ``GET {base_url}{path}``; raises on failure. ``image_output_only`` keeps image-output models minus router pseudo-models; curated ``meta`` wins for known ids. architectureroutput_modalitiesrrrinput_modalities)rrrr)r _LIVE_TIMEOUTrry_EXCLUDED_MODEL_PREFIXESrr) rrrmetagenericimage_output_onlyrrrarchknowns r;_fetch_catalogrs !#C'$O  %~.     8 9WTXXViMjMpnp=q 2& yyEIIf,=,IJ;8 $); < B      Jr=cddlm}|||f}tj|}|r&t j |dz t kr|dSt} t|d|tdf}|Dchc]\}}| }}}t|} t j | ft|<| Scc}}w#t$r!} tjd|| Yd} ~ Ud} ~ wwxYw)uModel ids from ``GET {base_url}/images/models``, cached per (base URL, key). Any failure caches an empty set (→ chat-completions): guessing "images" would 404 a working chat setup.r)fingerprint_secret_valuer/images/modelsg>@z)image API catalog probe failed for %s: %sN)agent.credential_persistencerr!rtime monotonic_CATALOG_TTL_SECONDSsetr_IMAGE_API_CONNECT_TIMEOUT Exceptionr}r~ frozenset) rrr cache_keycachedidscatalogr_entryrresolveds r;_fetch_image_api_catalogrsF3G<=I    *F 4>>#fQi/3GGayuCQx)97E_aeDfg078,Hfx88~H!%!18 B1+B11 C:CCc6tj|tS)zECatalog metadata for *model_id*, or permissive defaults when unknown.)rSr_UNKNOWN_IMAGE_API_MODELrs r;_image_api_model_metar's  +C DDr=c|sytdd|}t|tr>|jj dvr|jj S|t vry|t vs|t||vryy)a ``"images"`` or ``"chat"``: config/env ``surface`` forces it; curated ids are offline and deterministic; unknown ids consult the cached live catalog (a positive probe must route there or a model the live picker offered would 404; offline they stay on chat).chatsurfaceN>rrr)_image_api_settingrrwrxr_CHAT_ONLY_MODELSrSr)rrr config_keyforceds r;_select_surfacer,sy   4 #7#7#9=O#O||~##%%$$$$4LXW^4_(_ r=cl|"t|tr|jr|Stjj t |jdj}|r|Stt|j |}t|tr|jxsdS|S)u]Knob: call kwarg → ``OPENROUTER_IMAGE_API_`` env → scoped config; blanks are unset.NrT) rrwrxosenvironr_IMAGE_API_ENV_PREFIXupperr_load_image_gen_config)rexplicitr env_valuers r;rr<sZ#%>x~~GW "7!8GLRRTI +-z : > >t DE&0&  %9,iEMdDdL &ug.! "3 5 6   33;*$%?%E2FG  qGHI G qaw&MdiiX_N`Maaklm Lr=c t|}g}||d}td|jd|} t||| |} | r| |d<tD]-\} } t | |j| |||| } | s)| || </t D]`\}}}tt||j||} | /|j|r || ||<L|jd|dbttd|jd|}|Y|d kDrTt|jd xsd }||kDr|jd |d |d td t|||d<|rxt|jdxsd}|r|d|ng}t|t|kDr |jt|d|d|r|Dcgc] }dd|id c}|d<||fScc}w)a``/images/generations`` body: ``(payload, notes)``. Every knob is filtered against what the model declares: the endpoint silently *ignores* unknown parameters, which would let a caller believe ``background=transparent`` took effect on a model without it.modelprompt aspect_ratioaspect_ratio_exactrNrrrhrrAz'n=z' exceeds this model's cap of z ; clampedrBrz4 reference image(s) supplied but this model accepts z; extras droppedrrtyperinput_references) rrrr_IMAGE_API_ENUMSr _IMAGE_API_INTSrrrrlrmlen)rrsemantic_aspect referencesrkwargsrrr forced_ratioratio enum_namerrrgateclampcountrArBusablers r;_build_image_api_payloadr#s ! *DE(0FCG%nfjjAU6VXbcL $_dL% PE "'/' 8 6::i+@$ TYdlm !&GI '-NdE.tVZZ5EzRS =  88D>!%LGDM LL1TF"KL MN *3 3L ME UQYDHHW%*+ 5= LL3ug%CE7)T U1c%/0 txx +0q1*2IX& z?S[ ( LLz?#$#*$46 7 gm*n`cKuVYl+[*nG& ' E>+os G!c ||S |j}t|tr|j dnd}t|t r |jr|jSt|ts|rtj|ddS|S|j d}|j ddk(rt|t r tj|}t|tr|ngDcgc]Y}t|trGd jd |j d xsgDxsd d |j dxsd[}}dj|ddxs|ddSt|t r#|jr|jddStj|ddS#t$rt|ddxsdddxs|cYSwxYw#t$r|ddcYSwxYwcc}w)zOne-line error from ``{"error": {"message"}}`` (routing/auth) or the ZodError shape ``{"error": {"name": "ZodError", "message": ""}}`` (validation).NtextrTi,errorrrZodErrorrc32K|]}t|ywrrrw)rps r;rz+_extract_image_api_error..sB1ABrrequestz: invalidz; i) rrgetattrrrrrwrxdumpsloadsrr )rfallbackbodyr&rissuesissuepartss r;_extract_image_api_errorr6sG}}",D$!7DHHW TE%%++-{{} eT ")-tzz$%;8;ii "G yyJ&:gs+C !ZZ(F %/vt$<&" TY[_I`xxB6):)@bBBOiPPRyy#0y1 3  yy%6#6'3GMMO}}t$$ ::e Tc ""- G&"-3Tc:FhFG !4C=  ! s*F< G#6AG7.s#Pt2<Ps"$)r rs r; _model_slugrBs 77PxP PPr=c n|jd}t|tr?|jr/tt ||t |jdS|jd}t|tr4|jr$tt |j|Sy)zNCache one ``data[]`` entry; ``None`` without b64/URL. Raises on write failure.b64_jsonr;)prefix extensionrrEN)rrrwrxrr<r)rrEb64rs r;_save_image_api_entryrIs ))J C#s >#fuyyYeOf@ghii ))E C#s >#))+f=>> r=cd|jdd}|jtDcic] }||vs|||c}t|dkDr|dd|d<|r!t|jdxsg|d<|r||d <t |d }t |jd t tfr|d |d <t |jd t r|d |d <|Scc}w)zLSuccess ``extra`` for an Image API result (knobs sent, extra images, usage).zimages/generationsr)endpointexact_aspect_ratiorNadditional_imagesrreference_images_usedrusagecostcost_usd total_tokens)rupdate_IMAGE_API_EXTRA_KEYSrrrrr)rsaved usable_refsrr2extrarrOs r;_image_api_extrarXs*>U\U`U`aoUpqE LL/DWw#ws|#WX 5zA~%*12Y!"),W[[9K-L-RPR)S%& g T7 #E%))F#c5\2!&Mj%))N+S1 %n 5n LXs C#C#c2eZdZdZdd ddZeddZeddZddZddZ dd Z dd Z dd Z dd Z dd ZddZddZd d!dZd d"dZ d#dZ d$dZefddd d%dZy)&OpenRouterCompatImageProviderzOne instance per backend (OpenRouter, Nous Portal); they differ only in the runtime provider supplying ``(base_url, api_key)``, the config namespace, and Image API support.F)supports_image_apic||_||_||_||_||_||_d|_d|_||_yrr) _name_display _runtime_name _config_key_model_env_var _setup_schema_live_models_cache_image_api_models_cache_supports_image_api)self provider_name display_name runtime_namer model_env_var setup_schemar[s r;__init__z&OpenRouterCompatImageProvider.__init__sJ# $ )%+)378<$#5 r=c|jSrr)r]rfs r;rz"OpenRouterCompatImageProvider.names zzr=c|jSrr)r^rns r;rhz*OpenRouterCompatImageProvider.display_name s }}r=cddlm}||j}t|j dxsdj t|j dxsdj j dfS)uO``(api_key, base_url)`` — either may be ``""``; raises on resolution failure.r)resolve_runtime_provider) requestedrrTr/)hermes_cli.runtime_providerrqr_rwrrxrstrip)rfrqruntimes r; _credentialsz*OpenRouterCompatImageProvider._credentialssiH*T5G5GH  I&," - 3 3 5s7;;z;R;XVX7Y7_7_7a7h7hil7m  r=c t|jdS#t$r+}tj d|j |Yd}~yd}~wwxYw)Nrz %s runtime resolution failed: %sF)rrwrr}r~r])rfrs r; is_availablez*OpenRouterCompatImageProvider.is_availablesH ))+A./ /  LL;TZZ M s A!A  Act}|jr@|jd}|tvr%t t|j dxs|}ddg|dS)NrrBr%r) modalitiesmax_reference_images)_MAX_REFERENCE_IMAGESre_resolve_model_chainrSrr)rfrBrs r; capabilitiesz*OpenRouterCompatImageProvider.capabilities s\(  # #00215H,,0:>>zJVhW%w/RRr=ci}|jr!|jDcic]}|d| }}|jD]}|j|d||rt |j dSt jDcgc] \}}d|i| }}}|jr*|jdtjD|Scc}wcc}}w)uLive catalog: OpenRouter = ``GET /images/models`` ∪ chat-completions image models (new releases selectable); Nous Portal = chat-completions only. Offline: default chain + snapshot.rc>tj|dd|dfS)Nr)_MODEL_PRIORITYr)ms r;rpz;OpenRouterCompatImageProvider.list_models..2s%/:M:MaPTgWX:Y[\]a[b9cr=)rc3@K|]\}}||d|dddyw)rrz (Image API))rrrNr1)rrrs r;rz.5s8A"Hd DOTR]M^L__kJlmAs) re_image_api_live_models _live_models setdefaultsortedvalues_KNOWN_MODEL_METAitemsextendrS)rfmergedrrrmodelss r; list_modelsz)OpenRouterCompatImageProvider.list_models)s-/  # #6:6Q6Q6STUeDk5(TFT&&( 2E   eDk5 1 2 &--//cd dARAXAXAZ[~x4*T*[[  # # MMA&7&=&=&?A A U \s CCc nt||}|&tj|dz tkr|dSg} |j \}}|r t ||fi|}t|||tjf|S#t $r.}tjd|j||g}Yd}~Ud}~wwxYw)zMCached (per TTL) live catalog rows for this backend; ``[]`` when unreachable.Nrrz%s live %s unavailable: %s) r.rr_LIVE_CACHE_TTLrwrrr}r~r]setattr) rfattrlabelfetchrrrrrs r;_cached_catalogz-OpenRouterCompatImageProvider._cached_catalog:st$  $.."2VAY">"P!9 ')  $ 1 1 3 GX''CUC dVT^^%567   LL5tzz5# NF s"A== B4$B//B4c8|jdddtddS)NrdzImage API catalogrz.Image API model (from live OpenRouter catalog)Frrrr)rrSrns r;rz4OpenRouterCompatImageProvider._image_api_live_modelsJs.## %':AQXiDX]$_ _r=c8|jdddtddS)Nrczimage model catalogz/modelsz1Image-output model (from live OpenRouter catalog)Tr)rrrns r;rz*OpenRouterCompatImageProvider._live_modelsOs-## "7iN_G[_$a ar=ctSrr) DEFAULT_MODELrns r; default_modelz+OpenRouterCompatImageProvider.default_modelTsr=cH|jrt|jSdSrr)rbrrns r;get_setup_schemaz.OpenRouterCompatImageProvider.get_setup_schemaXs +/+=+=tD&&'G4Gr=Nc*|j|dS)Nr)r~)rfrs r;_resolve_modelz,OpenRouterCompatImageProvider._resolve_model[s((2155r=c|tjj|jfD]6}t |t s|j s%|j gcSt}t||jjd|jdfD]6}t |t s|j s%|j gcSttS)u``model`` kwarg → ``*_IMAGE_MODEL`` env → ``image_gen..model`` → ``image_gen.model`` → default chain. Only the bare default chain carries a fallback.r) rrrrarrwrxrrr`r_DEFAULT_MODEL_CHAIN)rfrrcfgs r;r~z2OpenRouterCompatImageProvider._resolve_model_chain^s#BJJNN43F3F$GH +I)S)ioo.?!)** +%&"3(8(89==gFPWHXY +I)S)ioo.?!)** +())r=ct|j|||d-d.fd }g} g} |D]/} t| } | r| n| j| xs t | 1 | r | s|ddj | zdzdSt|||| |j| \}}| r$|jd d dj | t}td |jd |j} |td t|}t'|d||t)t*||f|j,dd\}}||j.dk7r,||j0|j2|j.d k(S|j4|j6}}t"j1d|j||||dvr||j,d|d|dS|dk(r|d|d|dddS||j0d|t8vSt;t=|d ||j|!t?|d"Dcgc]}tA|tBs|}}|s||j,d#|d$d%dS|jd&tE| fd'|DDcgc]}|s| }}|s||j,d)d%StG|d ||||j| rd*nd+tI||| ||,S#t $r} |d| dcYd} ~ Sd} ~ wwxYw#tt f$r%t"j%d|j|Y9wxYwcc}wcc}w#t $r} |d(| dcYd} ~ Sd} ~ wwxYw)/zOne ``POST {base_url}/images/generations`` attempt; a chain-retryable failure carries a private ``_retryable`` flag that :meth:`generate` strips.rc(||}|rd|d<|S)NT _retryabler1)r& error_type retryabler base_fails r;_failzDOpenRouterCompatImageProvider._generate_via_image_api.._failrs!  3H)-&Or=z Could not load reference image: io_errorNz=Could not read the reference image(s) requested for editing: r z2. Refusing to silently fall back to text-to-image.)rrrrrrrz'dropped unreadable reference image(s): rg?z-%s: ignoring non-numeric image API timeout %rz/images/generationsc,t|t|Srr)r6rw)resprs r;rpzGOpenRouterCompatImageProvider._generate_via_image_api..s,DT3s8,Tr=T)rrrr error_messagecatch_request_exceptionhttp)rz-%s image API generation failed (%s) on %s: %s)irz rejected the API key (z): auth_errorrfzModel 'uj' does not exist on the OpenRouter Image API (its catalog is separate from chat-completions — check GET z/images/models). model_access api_errorrOrproviderrrz returned no image data for 'z'.empty_responser?c36K|]}t|ywrr)rI)rerEs r;rzHOpenRouterCompatImageProvider._generate_via_image_api..s Sa!6q&!A Ss Could not save generated image: z+ response carried neither b64_json nor url.rr%)rrrrrmodalityrW)F)r&rwrrwrrreturnDict[str, Any])%rr]rrrwrr r#r`insert_REQUEST_TIMEOUTrrrlr TypeErrorrr}r~rrmrr^kindr&rrr_IMAGE_API_FALLBACK_STATUSESrrrrrrBrrX)rfrrrrrrrrrV unreadablerpartrrrr configuredr2failurerrrentriesr*rUrrEs @@r;_generate_via_image_apiz5OpenRouterCompatImageProvider._generate_via_image_apijs "$**oXV\]  "$ "  O! O)#. $*<,>',,ZcJcdd%nngooGF LLH$**V\^fho p# .EfXSQXPYZ\hii}hZ(#*$46#d 44  vIe?ef f 8D'2(TZZbjk&tV4L 1d8K1LL==/!>xjKM]im JJt|j|||}|ddgd|dgdtj|did}t |d ||t |j \} } | | jd k7r2| jd k(rdnd } || j| j| fS| j| j} } tjd|j| || t|j ||j| | }|r ||ddfS|| jdd fStt!| d||j|t#| }|s||j d|dddfS|d} |j%dr6d|vr|j'dddnd}t)||jd}nt+||jd}t/t1|||||j"d fS#t,$r}|d |d!d fcYd }~Sd }~wwxYw)#zOne ``/chat/completions`` attempt: ``(result, retry_reason)``; reason set when the chain may continue with the fallback model.rrr%user)rolecontentrr)rr{messages image_configz/chat/completions)rrrrNrrz timed outz"%s image gen failed (%d) on %s: %sr unavailablerrOrz& returned no image. Ensure the model 'z' supports image output.rzreturned no imagerrt,rrT_genrGrr)rrrrr)rr]_ASPECT_RATIOSrrrr^rr&rrrr}rrarrrryr:rrrrrw)rfrraspectrrrfailrresultrreasonrrhintrfirstrH saved_pathrs r;_generate_via_chatz0OpenRouterCompatImageProvider._generate_via_chatsH TZZxO"F+"(W=>+^-?-?-NO #  $j) *GWVf--!  ||v%(/ (AtGMM7+=+=>FF%nngooGF LL=tzz6S[]d e%dmmXt?R?RTZ\cdDD.1=@@ {3T9 9 8FG4Htzzdlm (==/!GzQij ## #q  T(03u ekk#q)!,"+C4::,d8KL +ETZZL:MN  j/&v`d`j`j   T:3%@*MtS S Ts5A!G;; H HHH)rreference_image_urlsc t|j|} |j\}}|r|s$|d|jd|jddS|j |j d} t|} |j dxsgD cgc] } t| } } |r| jt|| jd |xsgDd |d g}| dtD]&} t| }|s|jd d |id(dd|it}d}t| D]\}}d}|jrt!||||j"}|dk(r/|j%||| | |||}|j'ddrdnd}n|j)||| |||\}}|j ds||t+| dz k(r|cSt,j/d|j||| |dz|}|xs/t1|jdd|j| r| dnd|| S#t$r#} |d|jd| dcYd} ~ Sd} ~ wwxYwcc} w) NzCould not resolve z credentials: missing_api_keyzNo z credentials found. Configure u( in `hermes tools` → Image Generation.rreference_imagesc32K|]}t|ywrrr))rrs r;rz9OpenRouterCompatImageProvider.generate..sIs#c(Ir+r%)rr%rrrrrrr)rrrrrrrrFzfailed on the image API)rrrrrrsuccessrz)%s model %s %s; retrying with fallback %sz; image generation failed after trying all candidate models.rrT)r&rrrrr)rr]rwrr^r~rr rwrrr}r_ATTRIBUTION_HEADERS enumeratererr`rpoprrr}infor )rfrrrrrrrrr model_chainrrrrrr last_errorirroutcomers r;generatez&OpenRouterCompatImageProvider.generates TZZ6 d $ 1 1 3 GXhdmm_%!]]O+SU!# # // 70CD %l3*0**5G*H*NBO3c#hO O    c)n -I.B.HbII28&)I(J445 RC%c*D 5$-PQ R#ggY$7P;OP/3 $[1 !KAxG'')(HgtGWGWX("66%ff)HgV\7^7>kk,PU6V2\`"&"9"9%fVW%w#:#8{{9%1K@PST@T;T KK;TZZSY[fghklgl[m !J' !*^^]]O#^_"TZZ%0+b/bV\^ ^Y d,T]]O>#OQbc c dPs#H5I$5 I!>II!I!)rgrwrhrwrirwrrwrjrwrkOptional[Dict[str, Any]]r[rrNone)rrw)rzTuple[str, str])rr)rr)rList[Dict[str, Any]])rrwrrwrrrr)r Optional[str])rrrr)rrrrw)rrrz list[str])rrwrrwrrwr List[str]rrwrDict[str, str]rrrr)rrwrrwrrwrrrrwrrrz$Tuple[Dict[str, Any], Optional[str]]) rrwrrwrrrzOptional[List[str]]rrrr)__name__ __module__ __qualname____doc__rlpropertyrrhrwryrrrrrrrrr~rrr rr1r=r;rZrZs` `e 6 # 636 6FI 6WZ 6 6*B 6X\ 6  6 S" _ a H6 *RNRN(+RN>ARNOXRNRN .RN8FRN RNh//(+/58/CW// ./ ./d0D7^#'UY7^7^),7^ 7^?R7^7^  7^r=rZc\tddddddddddd d d gd  tddddddgS)N openrouter OpenRouterOPENROUTER_IMAGE_MODELTzOpenRouter (image)paidzdGemini Flash Image, gpt-image-2, Krea 2, Qwen Image 3 & more via OpenRouter; uses OPENROUTER_API_KEYOPENROUTER_API_KEYzOpenRouter API keyzhttps://openrouter.ai/keys)rrr)rbadgetagenv_vars)rgrhrirrjr[rknousz Nous PortalNOUS_IMAGE_MODEL)rgrhrirrjrk)rZr1r=r;_build_providersr)s`%&\P\#3K`d,}/;OXt   & }6^d,4 A r=cDtD]}|j|y)z:Register the OpenRouter + Nous Portal image gen providers.N)rregister_image_gen_provider)ctxrs r;registerr?s"$&2 ''12r=)rrwrrwr:rrr)rrwrr)rrrrwrr)rrrrwrz List[Any])rrrr) rrwrrwrrwrrrrwrr) rrwrrwrrwrrrz List[Tuple[str, Dict[str, Any]]])rrwrrwrrwrrRrrwrrrr)rrwrrwrr)rrwrr) rrwrrwrrwrrwrrw)rrwrrrrwrr)rrrz Optional[int]) rrwrrrrrrrr)rrwrrrrrrwrrrrrr)rrwrrwrrwrrrrwrrrz Tuple[Dict[str, Any], List[str]])rrr1rwrrw)rW)r;rr1rwrrw)rrwrrw)rrrErwrr) rrrUrrVrrrr2rrr)rz#List[OpenRouterCompatImageProvider])rrrr)[r __future__rrrloggingrrrpathlibrtypingrrrrr agent.image_gen_providerr r r r rrrplugins.image_gen._commonrrrr getLoggerrr}rrrrrr}rrrrrrrrrr!__annotations___GEMINI_RATIOS _MAI_RATIOS _KREA_RATIOS_OPENAI_QUALITYr9r<rSrrrrVr9rrrTrrrrrrrrrrrrrrrrr r#r6r<rBrIrXrZrrr1r=r;rs#  33&&&ji   8 $) -%7 !_a8"FK+T'I 0 .0!KMHMJ B 3"rRWaf g `+;:E$'R+Q&60D$2KST_a&c+PY,>DXZeg  0!G3,M[_2   0!#Z!Q 8$4%'W!Q$8(8&K!A (7+O"d!VWY!1`"d!VW!Y.]s t1qBQ,0,,^,B"AXZ[$%^\3/e%vdi ))[\}o>?]e=*GH6SY[fJg 'B I(4 4  X  *-5NY\.(E  H ;;';1>;GP;;6# $2@CLU&**!*47*EN*\_* *&*Z#@ Q  $-