epj dZddlmZddlZddlZgdZddZdd Zdd ZddZ ddZ ddZ ddZ ddZ ddZd dZd dZddZd!d"dZdS)#uPre-import startup fast paths — THE canonical lightweight helpers. This module is imported by ``hermes_cli/main.py`` BEFORE its heavy import wall (config, argparse tree, logging, providers). Everything here must stay **stdlib-only and cheap** (os/sys file probes; no yaml, no hermes_cli.config, no argparse). A guard test (``test_startup_fast_import_weight``) subprocess- imports this module and fails if any heavy module sneaks into sys.modules. Why this module exists (the bug class it kills): version-printing kept being reimplemented as ``*_fast()`` copies at the top of main.py (Termux first, then globally), each duplicating canonical logic — project-root resolution, container detection, profile detection. The copies drifted: eb4040242 changed the canonical output and referenced ``PROJECT_ROOT`` inside the fast function, which doesn't exist yet on the fast path → the Termux fast path NameError'd on --version and nobody noticed. One implementation, imported by both the fast path and the module constants, makes that drift structurally impossible; the parity guard test would have caught eb4040242 the day it landed. ``hermes_cli/config.py``'s ``get_container_exec_info()`` reads the same ``.container-mode`` file; keep the file-format assumptions here and there in sync (this module deliberately only PROBES existence/typos cheaply and errs toward the slow path, which then does the authoritative parse). ) annotationsN) project_root_strensure_project_root_on_path is_termux_envis_termux_fast_version_argvis_global_fast_version_argv is_container_startup_environment active_profile_may_override_homecontainer_mode_may_be_activeread_openai_versionread_install_methodprint_fast_version_infotry_fast_versionreturnstrctjtjtjt tjS)uDRepo root as a str — the single source for main.py's PROJECT_ROOT.)ospathrealpathjoindirname__file__pardir>/home/thesage/.hermes/hermes-agent/hermes_cli/_startup_fast.pyrr/s8 7  BGLL)B)BBINN O OOrNonec*t}tjtj|fdt jDt jdd<t jd|dS)zCPut the project root at sys.path[0], deduping realpath-equivalents.cg|]F}|r@tjtj|kD|GSr)rrnormcaser).0entrynormalized_roots r z/ensure_project_root_on_path..8s[  7  BG,,U33 4 4 G G  H G GrNr)rrrr rsysinsert) project_rootr#s @rrr4s#%%Lg&&rw'7'7 'E'EFFOXCHQQQK HOOA|$$$$$rboolctjdd}ttjdpd|vp|dS)z3Tiny Termux check for pre-import startup shortcuts.PREFIXTERMUX_VERSIONzcom.termux/files/usrz/data/data/com.termux/)renvirongetr( startswith)prefixs rrrAs_ Z^^Hb ) )F  '(( 7 !V + 7   5 6 6  rargv list[str]c|dgdgdgfvS)N --version-Vversionrr1s rrrKs [MD6I;7 77rc|dgdgfvS)Nr4r5rr7s rrrOs [MD6* **rc:tjdstjdrdS tdd5}|}dddn #1swxYwYn#t $rYdSwxYwd |vpd |vpd |vS) zDTrue when we're already INSIDE a container (fast path is then safe).z /.dockerenvz/run/.containerenvTz/proc/1/cgrouputf-8encodingNFdockerpodmanz/lxc/)rrexistsopenreadOSError)handlecgroups rr r Ss w~~m$$7K(L(Lt "W 5 5 5 #[[]]F # # # # # # # # # # # # # # # uu v  HV!3 Hw&7HHs6BA4( B4A88B;A8<B B B hermes_rootc~tj|d} tj|rdt |d5}|}dddn #1swxYwYt|o|dkSn#ttf$rYnwxYwdS)zECheap probe: does an active non-default profile redirect HERMES_HOME?active_profiler:r;NdefaultF) rrrr?r@rAstripr(rBUnicodeDecodeError)rErGrCactives rr r _sW\\+/?@@N 7>>. ) ) 8nw777 /6,,.. / / / / / / / / / / / / / / /66Y#677 7 8 ' (     5s50B&'B9 B&B  B& B  B&&B:9B:ctjdd}|r|StjtjddS)N HERMES_HOMEr+~.hermes)rr-r.rIrr expanduser) hermes_homes r_resolved_homerRlsW*..3399;;K 7<<**3// ; ;;rcDtjddkrdStrdStjdd}|rtjtj|drdStjtj tj |}|dkot|Stjtj d d }t|rdStjtj|dS) uConservative probe for NixOS container-mode routing. False positives are fine (we fall through to the slow path, whose ``get_container_exec_info()`` does the authoritative check and routes into the container). False negatives are NOT fine — they'd print the host's version instead of the container's. Hence: any profile ambiguity → assume container mode may be active. HERMES_DEV1FrMr+z.container-modeTprofilesrNrO) rr-r.r rIrr?rbasenamernormpathr rP)rQ parent_name default_homes rr r ss; z~~l##s**u'))u*..3399;;K 7>>"',,{4EFF G G 4g&&rwrw7G7G 7T7T'U'UVV : % >0== 7<< 2 23 7 7CCL' 55t 7>>"',,|5FGG H HHr str | NonecDtjD]}|stj}tj|dd} t |d5}|D]}|}|ds,|d\}}}| ddd d }|pd ccd d d cS d d d n #1swxYwY#t$rYwxYwd S) zARead OpenAI SDK version without importing ``importlib.metadata``.openaiz _version.pyr:r; __version__=#rz"'N) r%rrgetcwdrr@rIr/ partitionsplitrB)base version_filerClinestripped_key_sepvalues rr r s 9;;Dw||D(MBB  lW555 )"))D#zz||H#..}==! (0(:(:3(?(?%D$!KKQ//288::@@GGE =D(( ) ) ) ) ) ) ) ) ) )) ) ) ) ) ) ) ) ) ) ) ) ) ) ) )    H  4s=DBD& D6 DD D D D DDcHtjtd} t |d5}|}dddn #1swxYwY|pdS#t$rYdSwxYw)uRead the installer's ``.install_method`` stamp, if present. Only the stamp (step 1 of ``config.detect_install_method``'s resolution order) — the managed/git/pip fallbacks need heavier imports and stay on the slow path. On the fast path home ambiguity is already excluded: ``container_mode_may_be_active()`` bails to the slow path whenever a non-default profile might redirect HERMES_HOME. z.install_methodr:r;N) rrrrRr@rArIlowerrB)stamprCmethods rr r s GLL))+< = =E %' * * * 3f[[]]((**0022F 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3~ tts4B9B8 BBB B B B! B!cddlm}m}td|d|dtdt t }|rtd|tdt jdt}t|rd |nd td dS) Nr)__release_date__r^zHermes Agent vz ()zInstall directory: zInstall method: zPython: z OpenAI SDK: zOpenAI SDK: Not installedz'Run 'hermes version' for update status.) hermes_clirqr^printrr r%r6rdr )rqr^install_methodopenai_versions rrrs88888888 =; = =*: = = =>>> 4 0 2 2 4 4555(**N3 111222 -S[&&((+ - -...(**N ^ \ ) ) ) )A\]]] 344444rlist[str] | Nonec"|tjdd}t}|r%tjddkrdS|rt |sdSn!t|sdStrdStdS)aHandle ``hermes --version`` before the heavy import wall. Termux keeps its historical contract (also accepts the ``version`` subcommand + the HERMES_TERMUX_DISABLE_FAST_CLI escape hatch). Everywhere else: only ``--version``/``-V`` (the ``version`` subcommand stays on the slow path for full output incl. update check), and never when container mode may need to route the command into the container. NraHERMES_TERMUX_DISABLE_FAST_CLIrUFT) r%r1rrr-r.rrr r)r1 is_termuxs rrrs |x|IRZ^^$DEELLu*400 5  ( . .u % ' 'u 4r)rr)rr)rr()r1r2rr()rErrr()rr[)N)r1rwrr()__doc__ __future__rrr%__all__rrrrrr r rRr r r rrrrrr~se2#"""""     PPPP % % % %8888++++ I I I I    <<<<IIII<($ 5 5 5 5 r