§ لىُiممَ¼—UdZddlmZddlZddlZddlmZmZmZddl m Z eje¦«Z iZded<ej¦«Zdd„Zdd„Zdd„Zdd„Zdd„ZdS)uع Image Generation Provider Registry ================================== Central map of registered providers. Populated by plugins at import-time via ``PluginContext.register_image_gen_provider()``; consumed by the ``image_generate`` tool to dispatch each call to the active backend. Active selection ---------------- The active provider is chosen by ``image_gen.provider`` in ``config.yaml``. If unset, :func:`get_active_provider` applies fallback logic: 1. If exactly one provider is registered, use it. 2. Otherwise if a provider named ``fal`` is registered, use it (legacy default â€” matches pre-plugin behavior). 3. Otherwise return ``None`` (the tool surfaces a helpful error pointing the user at ``hermes tools``). é)عannotationsN)عDictعListعOptional)عImageGenProviderzDict[str, ImageGenProvider]ع _providersعproviderrعreturnعNonecَ<—t|t¦«s$tdt|¦«j›‌¦«‚|j}t|t¦«r| ¦«std¦«‚t5t |¦«}|t|<ddd¦«n#1swxYwY|پ0t d|t|¦«j¦«dSt d|t|¦«j¦«dS)uعRegister an image generation provider. Re-registration (same ``name``) overwrites the previous entry and logs a debug message â€” this makes hot-reload scenarios (tests, dev loops) behave predictably. z>register_provider() expects an ImageGenProvider instance, got z3Image gen provider .name must be a non-empty stringNz.Image gen provider '%s' re-registered (was %r)z'Registered image gen provider '%s' (%s))ع isinstancerع TypeErrorعtypeع__name__عnameعstrعstripع ValueErrorع_lockrعgetعloggerعdebug)r rعexistings ْ=/home/ubuntu/.hermes/hermes-agent/agent/image_gen_registry.pyعregister_providerr$sJ€ُگhص 0ر1ش1ً فً -فک‘>”>ش*ً -ً -ٌ ô ً ًŒ=€Dفگd‌Cر ش ًP¨¯ ھ ©¬ًPفذNرOشOذOف ً$ً$ف—>’> $ر'ش'ˆط#چ گ4رً$ً$ً$ٌ$ô$ً$ً$ً$ً$ً$ً$ًّّّ$ً$ً$ً$ًذفڈٹذEہtحTذRZة^ج^شMdرeشeذeذeذeهڈٹذ>ہإdب8ءnؤnشF]ر^ش^ذ^ذ^ذ^sآ%B1آ1B5آ8B5ْList[ImageGenProvider]cَ°—t5tt ¦«¦«}ddd¦«n#1swxYwYt |d„¬¦«S)z0Return all registered providers, sorted by name.Ncَ—|jS)N©r)عps rْz list_providers..@s€ q¤v€َ)عkey)rعlistrعvaluesعsorted)عitemss rعlist_providersr(<sچ€ه ً*ً*ف•Z×&ز&ر(ش(ر)ش)ˆً*ً*ً*ٌ*ô*ً*ً*ً*ً*ً*ً*ًّّّ*ً*ً*ً*هگ%ذ-ذ-ذ.ر.ش.ذ.s ˆ';»?ء?rrْOptional[ImageGenProvider]cَت—t|t¦«sdSt5t | ¦«¦«cddd¦«S#1swxYwYdS)z5Return the provider registered under *name*, or None.N)r rrrrrrs rعget_providerr+Csڑ€هگd‌Cر ش ًطˆtف ً,ً,فڈ~ٹ~کdںjڑj™lœlر+ش+ً,ً,ً,ً,ٌ,ô,ً,ً,ً,ً,ً,ً,ًّّّ,ً,ً,ً,ً,ً,sں,AءAءAcَ$—d} ddlm}|¦«}t|t¦«r| d¦«nd}t|t¦«rR| d¦«}t|t ¦«r(| ¦«r| ¦«}n2#t$r%}t d|¦«Yd}~nd}~wwxYwt5tt¦«}ddd¦«n#1swxYwY|r4| |¦«}|پ|St d|¦«t|¦«dkr.tt| ¦«¦«¦«Sd |vr|d SdS) zˆResolve the currently-active provider. Reads ``image_gen.provider`` from config.yaml; falls back per the module docstring. Nr)عload_configع image_genr z1Could not read image_gen.provider from config: %szCimage_gen.provider='%s' configured but not registered; falling backéعfal)عhermes_cli.configr-r عdictrrrع Exceptionrrrrعlenعnextعiterr%)ع configuredr-عcfgعsectionعrawعexcعsnapshotr s rعget_active_providerr=Ksه€ً!%€Jً Oط1ذ1ذ1ذ1ذ1ذ1àˆk‰mŒmˆف*4°S½$ر*?ش*?ذIگ#—'’'ک+ر&ش&ذ&ہTˆفگg‌tر$ش$ً )ط—+’+کjر)ش)ˆCفک#‌sر#ش#ً )¨¯ ھ ©¬ً )ط ںYڑY™[œ[گ ّّفًOًOًOفڈٹذHب#رNشNذNذNذNذNذNذNًّّّّOُّّّ ً$ً$ف‌ ر#ش#ˆً$ً$ً$ٌ$ô$ً$ً$ً$ً$ً$ً$ًّّّ$ً$ً$ً$ًً ط—<’< ر+ش+ˆطذطˆOفڈٹطQطٌ ô ً ُˆ8پ}„}کزذف•Dکںڑر*ش*ر+ش+ر,ش,ذ,ً گذذطکŒذàˆ4s*„B#B(آ( Cآ2CأCأ!DؤDؤ Dcَx—t5t ¦«ddd¦«dS#1swxYwYdS)z"Clear the registry. **Test-only.**N)rrعclear©r"rع_reset_for_testsrAus~€ه ًًف×زرشذًًًٌôًًًًًًًًًًًًًّّّsˆ/¯3¶3)r rr r)r r)rrr r))r r))r r)ع__doc__ع __future__rعloggingع threadingعtypingrrrعagent.image_gen_providerrع getLoggerrrrع__annotations__عLockrrr(r+r=rAr@r"rْrKsًًًًً(#ذ"ذ"ذ"ذ"ذ"à€€€طذذذط'ذ'ذ'ذ'ذ'ذ'ذ'ذ'ذ'ذ'à5ذ5ذ5ذ5ذ5ذ5à ˆش ک8ر $ش $€ً+-€ ذ,ذ,ذ,ر,طˆ Œرش€ً_ً_ً_ً_ً0/ً/ً/ً/ً,ً,ً,ً,ً'ً'ً'ً'ًTًًًًًr"