(Gj4dZddlZddlmZmZddlmZmZmZm Z ej e Z eGddZ GddZeZdS) a Platform Adapter Registry Allows platform adapters (built-in and plugin) to self-register so the gateway can discover and instantiate them without hardcoded if/elif chains. Built-in adapters continue to use the existing if/elif in _create_adapter() for now. Plugin adapters register here via PluginContext.register_platform() and are looked up first -- if nothing is found the gateway falls through to the legacy code path. Usage (plugin side): from gateway.platform_registry import platform_registry, PlatformEntry platform_registry.register(PlatformEntry( name="irc", label="IRC", adapter_factory=lambda cfg: IRCAdapter(cfg), check_fn=check_requirements, validate_config=lambda cfg: bool(cfg.extra.get("server")), required_env=["IRC_SERVER"], install_hint="pip install irc", )) Usage (gateway side): adapter = platform_registry.create_adapter("irc", platform_config) N) dataclassfield)Any AwaitableCallableOptionalcBeZdZUdZeed<eed<eegefed<egefed<dZ e eegefed<dZ e eegefed<e e Ze ed <d Zeed <dZe egdfed <dZeed<d Zeed<d Zeed<d Zeed<dZeed<dZeed<dZeed<dZeed<d Zeed<dZe ege efed<dZe eeege efed<d Zeed<dZe ede efed <dS)! PlatformEntryz3Metadata and factory for a single platform adapter.namelabeladapter_factorycheck_fnNvalidate_config is_connected)default_factory required_env install_hintsetup_fnpluginsource plugin_nameallowed_users_env allow_all_envrmax_message_lengthFpii_safeu🔌emojiTallow_update_command platform_hintenv_enablement_fnapply_yaml_config_fncron_deliver_env_var.standalone_sender_fn)!__name__ __module__ __qualname____doc__str__annotations__rrboolrrrrlistrrrrrrrrintrrrrr dictr!r"r#r?/home/rurouni/.hermes/hermes-agent/gateway/platform_registry.pyr r &s%== III JJJ seSj))))r4x    8 F  FHHHHH    NN;           s - A AA cp|jsdSt|jD]}||dS)aFRun every pending deferred loader. Used by the iterate-all accessors (``all_entries``/``plugin_entries``), which are only called by paths that genuinely need every adapter: gateway startup, ``hermes setup``/``gateway status``, channel directory. CLI chat never iterates the full set. N)r8r+rGr:r s r0 _resolve_allzPlatformRegistry._resolve_allsK~  F((  D MM$      r/entrycH|j|jd|j|jvr>|j|j}td|j|j|j||j|j<td|j|jdS)zRegister a platform adapter entry. If an entry with the same name exists, it is replaced (last writer wins -- this lets plugins override built-in adapters if desired). Nz,Platform '%s' re-registered (was %s, now %s)z$Registered platform adapter: %s (%s))r8rBr r7rDinfordebug)r:rKprevs r0registerzPlatformRegistry.registers 5:t,,, : & &=,D KK>       %* ej! ;UZVVVVVr/cr|j|d|j|dduS)z5Remove a platform entry. Returns True if it existed.N)r8rBr7rIs r0 unregisterzPlatformRegistry.unregisters7 4&&&}  t,,D88r/cr||jvr|||j|S)z!Look up a platform entry by name.)r7rGgetrIs r0rTzPlatformRegistry.gets7 t} $ $ MM$   }  &&&r/cv|t|jS)z'Return all registered platform entries.)rJr+r7valuesr9s r0 all_entrieszPlatformRegistry.all_entriess0 DM((**+++r/cp|d|jDS)z/Return only plugin-registered platform entries.c(g|]}|jdk |S)r)r).0rFs r0 z3PlatformRegistry.plugin_entries.. s$JJJaQX5I5I5I5I5Ir/)rJr7rVr9s r0plugin_entrieszPlatformRegistry.plugin_entries s6 JJ4=//11JJJJr/c&||jvp||jvSr5r6rIs r0 is_registeredzPlatformRegistry.is_registereds t}$>(>>r/configc||jvr|||j|}|dS|s7|jr d|jdnd}t d|j|dS|jr ||s"t d|jdSn9#t$r,}t d|j|Yd}~dSd}~wwxYw | |}|S#t$r.}t d|j|d Yd}~dSd}~wwxYw) aCreate an adapter instance for the given platform name. Returns None if: - No entry registered for *name* - check_fn() returns False (missing deps) - validate_config() returns False (misconfigured) - The factory raises an exception Nz ()rz$Platform '%s' requirements not met%sz&Platform '%s' config validation failedz)Platform '%s' config validation error: %sz.Failed to create adapter for platform '%s': %sTr@) r7rGrTrrrDrEr rrCr error)r:r r_rKhintrFadapters r0create_adapterzPlatformRegistry.create_adapters t} $ $ MM$    !!$'' =4~~ 161CK-*----D NN6     4  , ,,V44 NN@  4     ?K ttttt   ++F33GN    LL@      44444 s05C C>!C99C>D E##E  E)r3N)r$r%r&r'r;r(rr>rGrJr rPr*rRrrTr+rWr\r^rrer.r/r0r2r2s ;;;;$ &c &8BH3E &$ & & & & S T         WmWWWWW&9s9t9999 '' 7'''' ,T-0,,,, K] 3KKKK ?#?$????2322 222222r/r2)r'logging dataclassesrrtypingrrrr getLoggerr$rDr r2platform_registryr.r/r0rks<((((((((555555555555  8 $ $ xJxJxJxJxJxJxJ xJvffffffffT%$&&r/