mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-04-25 00:51:20 +00:00
4b16341975
Rewrite all import statements, patch() targets, sys.modules keys, importlib.import_module() strings, and subprocess -m references to use hermes_agent.* paths. Strip sys.path.insert hacks from production code (rely on editable install). Update COMPONENT_PREFIXES for logger filtering. Fix 3 hardcoded getLogger() calls to use __name__. Update transport and tool registry discovery paths. Update plugin module path strings. Add legacy process-name patterns for gateway PID detection. Add main() to skills_sync for console_script entry point. Fix _get_bundled_dir() path traversal after move. Part of #14182, #14183
233 lines
7.9 KiB
Python
233 lines
7.9 KiB
Python
"""Tests for toolsets.py — toolset resolution, validation, and composition."""
|
|
|
|
from hermes_agent.tools.registry import ToolRegistry
|
|
from hermes_agent.tools.toolsets import (
|
|
TOOLSETS,
|
|
get_toolset,
|
|
resolve_toolset,
|
|
resolve_multiple_toolsets,
|
|
get_all_toolsets,
|
|
get_toolset_names,
|
|
validate_toolset,
|
|
create_custom_toolset,
|
|
get_toolset_info,
|
|
)
|
|
|
|
|
|
def _dummy_handler(args, **kwargs):
|
|
return "{}"
|
|
|
|
|
|
def _make_schema(name: str, description: str = "test tool"):
|
|
return {
|
|
"name": name,
|
|
"description": description,
|
|
"parameters": {"type": "object", "properties": {}},
|
|
}
|
|
|
|
|
|
class TestGetToolset:
|
|
def test_known_toolset(self):
|
|
ts = get_toolset("web")
|
|
assert ts is not None
|
|
assert "web_search" in ts["tools"]
|
|
|
|
def test_unknown_returns_none(self):
|
|
assert get_toolset("nonexistent") is None
|
|
|
|
|
|
class TestResolveToolset:
|
|
def test_leaf_toolset(self):
|
|
tools = resolve_toolset("web")
|
|
assert set(tools) == {"web_search", "web_extract"}
|
|
|
|
def test_composite_toolset(self):
|
|
tools = resolve_toolset("debugging")
|
|
assert "terminal" in tools
|
|
assert "web_search" in tools
|
|
assert "web_extract" in tools
|
|
|
|
def test_cycle_detection(self):
|
|
# Create a cycle: A includes B, B includes A
|
|
TOOLSETS["_cycle_a"] = {"description": "test", "tools": ["t1"], "includes": ["_cycle_b"]}
|
|
TOOLSETS["_cycle_b"] = {"description": "test", "tools": ["t2"], "includes": ["_cycle_a"]}
|
|
try:
|
|
tools = resolve_toolset("_cycle_a")
|
|
# Should not infinite loop — cycle is detected
|
|
assert "t1" in tools
|
|
assert "t2" in tools
|
|
finally:
|
|
del TOOLSETS["_cycle_a"]
|
|
del TOOLSETS["_cycle_b"]
|
|
|
|
def test_unknown_toolset_returns_empty(self):
|
|
assert resolve_toolset("nonexistent") == []
|
|
|
|
def test_plugin_toolset_uses_registry_snapshot(self, monkeypatch):
|
|
reg = ToolRegistry()
|
|
reg.register(
|
|
name="plugin_b",
|
|
toolset="plugin_example",
|
|
schema=_make_schema("plugin_b", "B"),
|
|
handler=_dummy_handler,
|
|
)
|
|
reg.register(
|
|
name="plugin_a",
|
|
toolset="plugin_example",
|
|
schema=_make_schema("plugin_a", "A"),
|
|
handler=_dummy_handler,
|
|
)
|
|
|
|
monkeypatch.setattr("hermes_agent.tools.registry.registry", reg)
|
|
|
|
assert resolve_toolset("plugin_example") == ["plugin_a", "plugin_b"]
|
|
|
|
def test_all_alias(self):
|
|
tools = resolve_toolset("all")
|
|
assert len(tools) > 10 # Should resolve all tools from all toolsets
|
|
|
|
def test_star_alias(self):
|
|
tools = resolve_toolset("*")
|
|
assert len(tools) > 10
|
|
|
|
|
|
class TestResolveMultipleToolsets:
|
|
def test_combines_and_deduplicates(self):
|
|
tools = resolve_multiple_toolsets(["web", "terminal"])
|
|
assert "web_search" in tools
|
|
assert "web_extract" in tools
|
|
assert "terminal" in tools
|
|
# No duplicates
|
|
assert len(tools) == len(set(tools))
|
|
|
|
def test_empty_list(self):
|
|
assert resolve_multiple_toolsets([]) == []
|
|
|
|
|
|
class TestValidateToolset:
|
|
def test_valid(self):
|
|
assert validate_toolset("web") is True
|
|
assert validate_toolset("terminal") is True
|
|
|
|
def test_all_alias_valid(self):
|
|
assert validate_toolset("all") is True
|
|
assert validate_toolset("*") is True
|
|
|
|
def test_invalid(self):
|
|
assert validate_toolset("nonexistent") is False
|
|
|
|
def test_mcp_alias_uses_live_registry(self, monkeypatch):
|
|
reg = ToolRegistry()
|
|
reg.register(
|
|
name="mcp_dynserver_ping",
|
|
toolset="mcp-dynserver",
|
|
schema=_make_schema("mcp_dynserver_ping", "Ping"),
|
|
handler=_dummy_handler,
|
|
)
|
|
reg.register_toolset_alias("dynserver", "mcp-dynserver")
|
|
|
|
monkeypatch.setattr("hermes_agent.tools.registry.registry", reg)
|
|
|
|
assert validate_toolset("dynserver") is True
|
|
assert validate_toolset("mcp-dynserver") is True
|
|
assert "mcp_dynserver_ping" in resolve_toolset("dynserver")
|
|
|
|
|
|
class TestGetToolsetInfo:
|
|
def test_leaf(self):
|
|
info = get_toolset_info("web")
|
|
assert info["name"] == "web"
|
|
assert info["is_composite"] is False
|
|
assert info["tool_count"] == 2
|
|
|
|
def test_composite(self):
|
|
info = get_toolset_info("debugging")
|
|
assert info["is_composite"] is True
|
|
assert info["tool_count"] > len(info["direct_tools"])
|
|
|
|
def test_unknown_returns_none(self):
|
|
assert get_toolset_info("nonexistent") is None
|
|
|
|
|
|
class TestCreateCustomToolset:
|
|
def test_runtime_creation(self):
|
|
create_custom_toolset(
|
|
name="_test_custom",
|
|
description="Test toolset",
|
|
tools=["web_search"],
|
|
includes=["terminal"],
|
|
)
|
|
try:
|
|
tools = resolve_toolset("_test_custom")
|
|
assert "web_search" in tools
|
|
assert "terminal" in tools
|
|
assert validate_toolset("_test_custom") is True
|
|
finally:
|
|
del TOOLSETS["_test_custom"]
|
|
|
|
|
|
class TestRegistryOwnedToolsets:
|
|
def test_registry_membership_is_live(self, monkeypatch):
|
|
reg = ToolRegistry()
|
|
reg.register(
|
|
name="test_live_toolset_tool",
|
|
toolset="test-live-toolset",
|
|
schema=_make_schema("test_live_toolset_tool", "Live"),
|
|
handler=_dummy_handler,
|
|
)
|
|
|
|
monkeypatch.setattr("hermes_agent.tools.registry.registry", reg)
|
|
|
|
assert validate_toolset("test-live-toolset") is True
|
|
assert get_toolset("test-live-toolset")["tools"] == ["test_live_toolset_tool"]
|
|
assert resolve_toolset("test-live-toolset") == ["test_live_toolset_tool"]
|
|
|
|
|
|
class TestToolsetConsistency:
|
|
"""Verify structural integrity of the built-in TOOLSETS dict."""
|
|
|
|
def test_all_toolsets_have_required_keys(self):
|
|
for name, ts in TOOLSETS.items():
|
|
assert "description" in ts, f"{name} missing description"
|
|
assert "tools" in ts, f"{name} missing tools"
|
|
assert "includes" in ts, f"{name} missing includes"
|
|
|
|
def test_all_includes_reference_existing_toolsets(self):
|
|
for name, ts in TOOLSETS.items():
|
|
for inc in ts["includes"]:
|
|
assert inc in TOOLSETS, f"{name} includes unknown toolset '{inc}'"
|
|
|
|
def test_hermes_platforms_share_core_tools(self):
|
|
"""All hermes-* platform toolsets share the same core tools.
|
|
|
|
Platform-specific additions (e.g. ``discord_server`` on
|
|
hermes-discord, gated on DISCORD_BOT_TOKEN) are allowed on top —
|
|
the invariant is that the core set is identical across platforms.
|
|
"""
|
|
platforms = ["hermes-cli", "hermes-telegram", "hermes-discord", "hermes-whatsapp", "hermes-slack", "hermes-signal", "hermes-homeassistant"]
|
|
tool_sets = [set(TOOLSETS[p]["tools"]) for p in platforms]
|
|
# All platforms must contain the shared core; platform-specific
|
|
# extras are OK (subset check, not equality).
|
|
core = set.intersection(*tool_sets)
|
|
for name, ts in zip(platforms, tool_sets):
|
|
assert core.issubset(ts), f"{name} is missing core tools: {core - ts}"
|
|
# Sanity: the shared core must be non-trivial (i.e. we didn't
|
|
# silently let a platform diverge so far that nothing is shared).
|
|
assert len(core) > 20, f"Suspiciously small shared core: {len(core)} tools"
|
|
|
|
|
|
class TestPluginToolsets:
|
|
def test_get_all_toolsets_includes_plugin_toolset(self, monkeypatch):
|
|
reg = ToolRegistry()
|
|
reg.register(
|
|
name="plugin_tool",
|
|
toolset="plugin_bundle",
|
|
schema=_make_schema("plugin_tool", "Plugin tool"),
|
|
handler=_dummy_handler,
|
|
)
|
|
|
|
monkeypatch.setattr("hermes_agent.tools.registry.registry", reg)
|
|
|
|
all_toolsets = get_all_toolsets()
|
|
assert "plugin_bundle" in all_toolsets
|
|
assert all_toolsets["plugin_bundle"]["tools"] == ["plugin_tool"]
|