The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
"""A user terminal backend under ``plugins.isolation: host``: the plugin's environment object cannot cross
the host boundary (its methods would run outside the Hermes process's interrupt, activity and terminal-scope
state), so creating it refuses with the setting to change before the host starts a sandbox nobody can use
or clean up. Real plugin, real host process, real loader against a temp HERMES_HOME.
"""
from __future__ import annotations
import hermes_yaml as yaml
import pytest
from hermes_cli import plugins as plugins_mod
from hermes_cli.plugins import PluginManager
BACKEND_PLUGIN = '''
from pathlib import Path
from agent.terminal_env_provider import TerminalEnvironmentProvider
MARKER = Path(__file__).with_name("created")
class Env:
def execute(self, command, **kw):
return {"output": command, "returncode": 0}
def cleanup(self):
pass
class Box(TerminalEnvironmentProvider):
@property
def name(self):
return "hostbox"
def is_available(self):
return True
def create_environment(self, *, cwd, timeout, task_id="default", image=None, container_config=None, **kw):
MARKER.write_text("sandbox started")
return Env()
def register(ctx):
ctx.register_terminal_environment_provider(Box())
'''
def _load(tmp_path, monkeypatch, isolation):
home = tmp_path / ".hermes"
plugin_dir = home / "plugins" / "hostbox"
plugin_dir.mkdir(parents=True)
(plugin_dir / "plugin.yaml").write_text(yaml.safe_dump({"name": "hostbox", "version": "1.0"}), encoding="utf-8")
(plugin_dir / "__init__.py").write_text(BACKEND_PLUGIN, encoding="utf-8")
(home / "config.yaml").write_text(yaml.safe_dump(
{"plugins": {"enabled": ["hostbox"], "isolation": isolation}, "terminal": {"backend": "hostbox"}}),
encoding="utf-8")
empty_bundled = tmp_path / "bundled"
empty_bundled.mkdir()
monkeypatch.setenv("HOME", str(tmp_path / "os-home"))
monkeypatch.setenv("HERMES_HOME", str(home))
monkeypatch.setattr(plugins_mod, "get_bundled_plugins_dir", lambda: empty_bundled)
manager = PluginManager()
manager.discover_and_load()
assert manager._plugins["hostbox"].error is None
return manager, plugin_dir / "created"
def test_a_hosted_terminal_backend_refuses_with_the_isolation_setting(tmp_path, monkeypatch):
from tools.terminal_tool_backends import _create_environment
manager, marker = _load(tmp_path, monkeypatch, "host")
try:
with pytest.raises(ValueError, match=r"plugins\.isolation: in_process"):
_create_environment("hostbox", image="", cwd="/", timeout=10)
assert not marker.exists() # no sandbox started in the host
finally:
manager.unload()
manager._plugin_host().shutdown()
def test_the_same_backend_in_process_runs_commands(tmp_path, monkeypatch):
from tools.terminal_tool_backends import _create_environment
manager, marker = _load(tmp_path, monkeypatch, "in_process")
try:
env = _create_environment("hostbox", image="", cwd="/", timeout=10)
assert env.execute("echo hi") == {"output": "echo hi", "returncode": 0}
assert marker.exists()
finally:
manager.unload()