sj)dZddlmZddlZddlZgdZddZdd Zd d Zd!dZ d!dZ d dZ d"dZ ddZ d dZd#dZd#dZddd$dZd%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__pardirz/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|dgdgfvSNz --versionz-Vrr1s rrrK [MD6* **rc|dgdgfvSr4rr5s rrrOr6rc: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_profiler9r:NdefaultF) rrrr>r?r@stripr(rAUnicodeDecodeError)rDrFrBactives 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.rHrr expanduser) hermes_homes r_resolved_homerQlsW*..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_DEV1FrLr+z.container-modeTprofilesrMrN) rr-r.r rHrr>rbasenamernormpathr rO)rP 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.pyr9r: __version__=#rz"'N) r%rrgetcwdrr?rHr/ partitionsplitrA)base version_filerBlinestripped_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_methodr9r:N) rrrrQr?r@rHlowerrA)stamprBmethods 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!T) check_updatesroc  ddlm}t|n.#t$r!ddlm}m}td|d|dYnwxYwtdt ddlm }dd l m }||t}n#t$rt}YnwxYw|rtd |td tjdt!}t|rd |nd |sdS ddlm}m} ddl m} | } | |krtd| ddS| r3| dkr-| dkrdnd} td| d| d| ddS| dkrtddSdS#t$rYdSwxYw)uQTHE canonical ``hermes --version`` output (also used by /version). The static lines print instantly from stdlib-only probes; everything heavier (upstream SHA in the version line, authoritative install-method detection, the update-status check) is lazy-imported AFTER the first line is already on screen, so perceived latency stays instant while the output carries the full information that used to require the (removed) ``hermes version`` subcommand. Every lazy block degrades gracefully — a broken/heavy import can never take the basic version output down. r)format_banner_version_label)__release_date__r]zHermes Agent vz ()zInstall directory: )Path)detect_install_methodzInstall method: zPython: z OpenAI SDK: zOpenAI SDK: Not installedN)UPDATE_AVAILABLE_NO_COUNTcheck_for_updates)recommended_update_commanduUpdate available — run ''r`commitcommitszUpdate available:  u behind — run 'z Up to date)hermes_cli.bannerrqprint Exception hermes_clirrr]rpathlibrthermes_cli.configrur r%versionrcr rvrwrx) rorqrrr]rtruinstall_methodopenai_versionrvrwrxbehind commits_words rrrsCAAAAAA ))++,,,, CCC<<<<<<<< A{AA.>AAABBBBBC  4 0 2 2 4 4555 /      ;;;;;;..tt4D4F4F/G/GHH ///,../3 111222 -S[&&((+ - -...(**N ^ \ ) ) ) )A\]]]   RRRRRRRR@@@@@@""$$ . . . N/I/I/K/KNNN O O O O O   '-{{88 L 8V88l882244888     q[[ ,     [      s? (A  A -,BB54B5)9F2$3F2F22 G?Glist[str] | Nonec"|tjdd}t}|r%tjddkrdS|rt |sdSn!t|sdStrdStdS)ucHandle ``hermes --version`` before the heavy import wall. Only ``--version``/``-V`` (the ``version`` subcommand was removed — ``--version`` now carries the full output incl. update status), and never when container mode may need to route the command into the container. Termux keeps the HERMES_TERMUX_DISABLE_FAST_CLI escape hatch. Nr`HERMES_TERMUX_DISABLE_FAST_CLIrTFT) r%r1rrr-r.rrr r)r1 is_termuxs rrrs |x|IRZ^^$DEELLu*400 5  ( . .u % ' 'u 4r)rr)rr)rr()r1r2rr()rDrrr()rrZ)ror(rr)N)r1rrr()__doc__ __future__rrr%__all__rrrrrr r rQr r r rrrrrrs{2#"""""     PPPP % % % %++++++++ I I I I    <<<<IIII<($6:C C C C C C Lr