Files
hermes-agent/hermes_cli/auth_external_process.py
Siddharth Balyan 8054696ad4 fix(models): fingerprint the executable a process provider actually launches
The catalog fingerprint resolved the profile's default process_command even
when a process_command_env_vars override picked another executable. An
upgrade that repointed an override symlink changed neither the override text
nor the default binary, so the picker kept the old executable's model list.
The launch path and the fingerprint now share external_process_command, so
both select the same command. Answers Greptile r4511687631 on #151817.
2026-11-09 18:06:44 +05:30

58 lines
2.8 KiB
Python

"""Executable lookup and launch-env policy for ``external_process`` (ACP) providers.
A GUI/service launch (LaunchAgent, Desktop backend, Desktop over SSH) has a bare PATH, so the
profile's command resolves through PATH, then the user-local bin, then Claude Code's install
prefixes."""
from __future__ import annotations
import os
from typing import Optional
def external_process_command(profile) -> str:
"""The command a launch uses: the first set ``process_command_env_vars`` override, else the profile's
``process_command``. ``profile`` may be None."""
overrides = (os.getenv(var, "").strip() for var in (getattr(profile, "process_command_env_vars", ()) or ()))
return next((v for v in overrides if v), "") or str(getattr(profile, "process_command", "") or "")
def resolve_external_process_command(command: str) -> Optional[str]:
"""Absolute path of the provider CLI ``command``, or ``None`` when nothing executable matches."""
if not command:
return None
from hermes_platform.resolver import locate_command
from hermes_platform.resolver.known_dirs import user_local_bin
lookup = command
if os.sep in command or (os.altsep and os.altsep in command):
# An operator-configured relative path (./bin/agent) means the launch cwd, as it did
# under shutil.which; anchor it so the resolver's absolute-only explicit check accepts it.
lookup = os.path.abspath(os.path.expandvars(os.path.expanduser(command)))
found = locate_command(lookup, known_dirs=user_local_bin()).command
if found:
# Known dirs are written with "/" (%USERPROFILE%/.local/bin); normalize so a Windows hit
# reads as one native path in status and in the spawned argv.
return os.path.normpath(found[0])
from agent.anthropic_adapter import find_claude_code_cli
return find_claude_code_cli(command)
def external_process_launch_env_names() -> frozenset[str]:
"""Env names that choose an external-process provider's executable or argv, from every registered
profile's ``process_command_env_vars`` and ``process_args_env_var``: executable authority, so the
generic env writers (dashboard, MCP/connector installs, ``save_env_value``) must refuse them."""
from providers import list_providers
return frozenset(name for profile in list_providers() if profile.auth_type == "external_process"
for name in (*profile.process_command_env_vars, profile.process_args_env_var) if name)
def env_writer_launch_denylist() -> frozenset[str]:
""":func:`external_process_launch_env_names` plus every left-core row's ``launch_env``: a plugin that is
not loaded (absent, disabled, failed, quarantined) registers no profile to declare them."""
from hermes_cli.left_core_migration import launch_env_names
return external_process_launch_env_names() | launch_env_names()