Bug Report

Summary: When the current working directory contains a Python package named utils/ (i.e., a directory with utils/__init__.py), the Hermes TUI fails to launch because Python resolves bare imports like from utils import base_url_host_matches to the local utils/ package instead of the installed hermes_agent/utils.py module.

Steps to Reproduce

1. Create a directory with a utils/ subdirectory that is a Python package:

   mkdir -p test_cwd/utils
   echo "" > test_cwd/utils/__init__.py

2. cd test_cwd
3. Run hermes --tui

Expected Behavior

The TUI should launch normally, importing base_url_host_matches from the installed hermes_agent.utils module.

Actual Behavior

The TUI fails to launch with an import error because Python finds the local utils/ directory (which does not define base_url_host_matches) instead of the installed hermes_agent.utils module.

Root Cause

The hermes-agent codebase uses bare imports (e.g., from utils import base_url_host_matches) instead of absolute imports (e.g., from hermes_agent.utils import base_url_host_matches). When Python executes in a directory containing a utils/ package, the local directory is on sys.path and shadows the installed package.

Affected Files (non-exhaustive)

The following files in the hermes-agent codebase use from utils import ... and are affected:

Proposed Fix

Replace all bare from utils import ... imports with absolute imports:

# Before:
from utils import base_url_host_matches

# After:
from hermes_agent.utils import base_url_host_matches

This is a straightforward find-and-replace across the codebase. The hermes_agent package namespace is already installed and available at runtime.

Environment

• OS: Linux (containerized)
• hermes-agent version: 0.11.0
• Python: 3.12+
• Working directory structure: Contains utils/__init__.py (Python package)