`gj6(dZddlmZddlZddlZddlZddlZddlmZddl m Z m Z m Z ejeZeej"Zd dZd dZd dZGd d Zy)uContext engine plugin discovery. Scans ``plugins/context_engine//`` directories for context engine plugins. Each subdirectory must contain ``__init__.py`` with a class implementing the ContextEngine ABC. Context engines are separate from the general plugin system — they live in the repo and are always available without user installation. Only ONE can be active at a time, selected via ``context.engine`` in config.yaml. The default engine is ``"compressor"`` (the built-in ContextCompressor). Usage: from plugins.context_engine import discover_context_engines, load_context_engine available = discover_context_engines() # [(name, desc, available), ...] engine = load_context_engine("lcm") # ContextEngine instance ) annotationsN)Path)ListOptionalTuplecg}tjs|SttjD]}|jr|jj dr/|dz }|j sEd}|dz }|j rB ddl}t|d5}|j|xsi}dddjd d}d } t|} | d }nt| d r| j}|j|j||f|S#1swYlxYw#t$rYhwxYw#t$rd }YJwxYw) uScan plugins/context_engine/ for available engines. Returns list of (name, description, is_available) tuples. Does NOT import the engines — just reads plugin.yaml for metadata and does a lightweight availability check. )_. __init__.pyz plugin.yamlrNz utf-8-sig)encoding descriptionTF is_available)_CONTEXT_ENGINE_PLUGINS_DIRis_dirsortediterdirname startswithexistsyamlopen safe_loadget Exception_load_engine_from_dirhasattrrappend) resultschild init_filedesc yaml_filerfmeta availableengines R/root/.hermes/venv/lib/python3.12/site-packages/plugins/context_engine/__init__.pydiscover_context_enginesr)!sXG & - - /3;;=>6||~!6!6z!B M) ! M)     )k:3a>>!,2D3xx r2   *51F~! 0"//1   D)45=6@ N'33   I s<D1$D%:D1,E%D. *D11 D=<D= E Ect|z }|jstjd|ty t |}|r|Stj d|y#t $r!}tj d||Yd}~yd}~wwxYw)zuLoad and return a ContextEngine instance by name. Returns None if the engine is not found or fails to load. z#Context engine '%s' not found in %sNz7Context engine '%s' loaded but no engine instance foundz&Failed to load context engine '%s': %s)rrloggerdebugrwarningr)r engine_dirr'es r(load_context_enginer0Os} -t3J     :DB]^&z2 MPRVW ?qIsAA B&BBc|j}d|}|dz }|jsy|tjvrtj|}n,dD]}|tjvst t j }|dk(r |j }|dz }|jsVtjj|t|t|g}|stjj|} | tj|< |jj| tjj|t|t|g}|sytjj|}|tj|<|jdD]} | jdk(r| j } |d| } | tjvs9tjj| t| } | setjj| }|tj| < | jj| |jj|t)|d r7t+| } |j-||j.r |j.S ddlm}t5|D];}t7||d}t9|t:s!t=||s.||us3 |cSy#t$rYwxYw#t$r"}t"j%d | |Yd}~d}~wwxYw#t$rA}t"j%d ||tjj'|dYd}~yd}~wwxYw#t$r"}t"j%d ||Yd}~d}~wwxYw#t$rYwxYw)uImport an engine module and extract the ContextEngine instance. The module must have either: - A register(ctx) function (plugin-style) — we simulate a ctx - A top-level class that extends ContextEngine — we instantiate it zplugins.context_engine.r N)pluginszplugins.context_enginer2)submodule_search_locationsz*.pyr zFailed to load submodule %s: %szFailed to exec_module %s: %sregister) engine_namezregister() failed for %s: %sr) ContextEngine)rrsysmodulesr__file__parent importlibutilspec_from_file_locationstrmodule_from_specloader exec_modulerglobstemr+r,popr_EngineCollectorr4r'agent.context_enginer6dirgetattr isinstancetype issubclass)r.r module_namer!modr: parent_path parent_initspec parent_modsub_filesub_name full_sub_namesub_specsub_modr/ collectorr6 attr_nameattrs r(rrdsm ??D+D62K]*I    ckk!kk+&< !FS[[("8n33 Y&"-"4"4K)M9 %%'$>>AAK 047 4D3EBD%.^^%D%DT%J .8 F+! KK33J? !(~~55 Y(+J'86 nn--d3#& K #/ ZH}} -}}H*m1XJ7MCKK/$>>AA!3x='nn==hGG18CKK .Z 33G< Z"  KK # #C (sJ$6  B LL # ''' 3X sIt, tT "z$ 'F - v  y )! !:%Z %F WXYYZ   LL7a H KKOOK .  B LL7q A A B  slLL M (NO LL M 'MM  N7NN O"N??O OOcTeZdZdZd d dZdZ d d dZdZdZdZ dZ y )rEaiFake plugin context that captures register_context_engine calls. Plugin context engines using the standard ``register(ctx)`` pattern may also call ``ctx.register_command(...)`` to expose slash commands (e.g. ``/lcm``). Forward those to the global plugin command registry so they behave identically to commands registered by normal plugins. c6d|_|xsd|_g|_y)Ncontext_engine)r' _engine_name_registered_commands)selfr5s r(__init__z_EngineCollector.__init__s ';+;/1!c||_yN)r')r_r's r(register_context_enginez(_EngineCollector.register_context_engines  rac |xsdjjjdjdd}|s!tj d|j y ddlm}||"tj d |j |y dd l m }|}||jvr"tj d |j |y||xsd d |j |xsdjd|j|<|jj|tjd|j |y#t$rYwxYw#t$r,} tjd|j || Yd} ~ yd} ~ wwxYw)z.Forward to the global plugin command registry.r / -zCContext engine '%s' tried to register a command with an empty name.Nr)resolve_commandzfContext engine '%s' tried to register command '/%s' which conflicts with a built-in command. Skipping.)get_plugin_managerzfContext engine '%s' tried to register command '/%s' which is already registered by a plugin. Skipping.zContext engine commandzcontext-engine:)handlerrplugin args_hintz+Context engine '%s' registered command: /%sz.Context engine '%s' could not register /%s: %s)lowerstriplstripreplacer+r-r]hermes_cli.commandsrirhermes_cli.pluginsrj_plugin_commandsr^rr,) r_rrkrrmcleanrirjmanagerexcs r(register_commandz!_EngineCollector.register_commands""$**,33C8@@cJ NNU!!    ;u%19%%u  2  =(*G000C%%u "*F.F+D,=,=+>?'o2446 /G $ $U +  % % , ,U 3 LL=!!5 -   4  LL@!!5#   s1&/E )r r )rr>rr>rmr>returnNone) __name__ __module__ __qualname____doc__r`rdrxr~rrrrzrar(rErEsY2  88 8  8  8v    rarE)rzList[Tuple[str, str, bool]])rr>rOptional['ContextEngine'])r.rrr)r __future__rr;importlib.utilloggingr7pathlibrtypingrrr getLoggerrr+r9r:rr)r0rrErzrar(rsd$# ((   8 $"8n33+\*`FV V ra