hermes - 💡(How to fix) Fix TUI bundled entry.js fails on Node.js v18: Cannot use import statement outside a module

Bug Description

When running hermes --tui with pip-installed Hermes (wheel distribution), the TUI crashes immediately:

SyntaxError: Cannot use import statement outside a module
    at internalCompileFunction (node:internal/vm:73:18)
    ...
    at node:internal/main/run_main_module:28:49

This happens because tui_dist/entry.js uses ES Module syntax (import { createRequire }...) but is invoked without telling Node.js it's an ESM file. There's no package.json with "type": "module" in the tui_dist directory, so Node.js treats .js as CommonJS.

Reproduction Steps

1. Install Hermes via pip: pip install hermes-agent
2. Run: hermes --tui
3. Observe SyntaxError crash

Affected: WSL Ubuntu 24.04, Node.js v18.19.1, Hermes Agent v0.15.2

Root Cause

In hermes_cli/main.py::_make_tui_argv(), two code paths construct the node argv without --input-type=module:

Line ~1380 (external dir case):

return [node, "--expose-gc", str(p / "dist" / "entry.js")], p

Line ~1386 (bundled wheel case):

return [node, "--expose-gc", str(bundled)], bundled.parent

Both should include "--input-type=module" to tell Node.js to treat the .js file as an ES module.

Proposed Fix

Add "--input-type=module" to both node argv lists:

- return [node, "--expose-gc", str(p / "dist" / "entry.js")], p
+ return [node, "--expose-gc", "--input-type=module", str(p / "dist" / "entry.js")], p

- return [node, "--expose-gc", str(bundled)], bundled.parent
+ return [node, "--expose-gc", "--input-type=module", str(bundled)], bundled.parent

Alternatively, ship a package.json with {"type": "module"} alongside entry.js in the wheel bundle. The flag approach is preferred since it works regardless of whether a package.json exists.

Workaround

Users can manually add --input-type=module or create a package.json in their tui_dist directory:

echo '{"type":"module"}' > $(python -c "import hermes_cli; import os; print(os.path.dirname(hermes_cli.__file__))")/tui_dist/package.json