mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-07-31 19:16:29 +00:00
5b751dc0ad
Cleans F401 unused imports and F841 dead local assignments across root *.py, agent/, hermes_cli/, tools/, gateway/, cron/, tui_gateway/ (tests/, plugins/, skills/ excluded). Intentionally KEPT (false positives / test-patch surfaces): - agent/transports/__init__.py package re-exports - cli.py browser_connect re-exports (DEFAULT_BROWSER_CDP_URL area, used by tests/cli/test_cli_browser_connect.py) - hermes_cli/main.py _prompt_auth_credentials_choice / _model_flow_bedrock_api_key (accessed via main_mod attr in tests) - gateway/run.py aliased replay_cleanup + whatsapp_identity re-exports and _PORT_BINDING_PLATFORM_VALUES (test-referenced) - hermes_cli/web_server.py get_running_pid (tests monkeypatch it) and _OAUTH_TOKEN_URL availability probe - hermes_cli/config.py get_process_hermes_home re-export (noqa'd F811 chain) and yaml availability-probe import - hermes_cli/nous_subscription.py managed_nous_tools_enabled (tests patch hermes_cli.nous_subscription.managed_nous_tools_enabled) - try/except ImportError availability probes (env_loader, tts_tool, mcp_tool, web_server anthropic OAuth block) - tools/web_tools.py noqa F401 re-exports - hermes_cli/setup_whatsapp_cloud.py:263 'proceed' skipped: possible missing-guard bug, flagged for separate review - unused function parameters (signature changes out of scope) Side-effect RHS calls preserved where only the binding was dead (e.g. web_server proc = _spawn_hermes_action -> bare call).
70 lines
2.6 KiB
Python
70 lines
2.6 KiB
Python
#!/usr/bin/env python3
|
|
"""Close a read-only agent terminal tab in the Hermes desktop GUI.
|
|
|
|
Each ``terminal(background=true)`` process is mirrored as a read-only tab in the
|
|
desktop's terminal pane. This tool lets the agent drop a tab it no longer needs
|
|
to show — WITHOUT killing the process (use ``process(action='kill')`` for that).
|
|
The output keeps buffering and the user can reopen the tab from the status stack.
|
|
|
|
It routes through the process registry's ``on_close`` sink, which the desktop
|
|
gateway wires to emit a ``terminal.close`` event the renderer handles. Like
|
|
``read_terminal`` it is gated on ``HERMES_DESKTOP`` so it never appears outside
|
|
the GUI.
|
|
"""
|
|
|
|
import json
|
|
|
|
from utils import env_var_enabled
|
|
|
|
from tools.process_registry import process_registry
|
|
from tools.registry import registry, tool_error
|
|
|
|
|
|
def close_terminal_tool(process_id: str) -> str:
|
|
"""Ask the desktop GUI to close a background process's read-only tab."""
|
|
pid = (process_id or "").strip()
|
|
if not pid:
|
|
return tool_error("process_id is required (the background process whose tab to close).")
|
|
|
|
return json.dumps(process_registry.request_close_terminal(pid), ensure_ascii=False)
|
|
|
|
|
|
def check_close_terminal_requirements() -> bool:
|
|
"""Desktop GUI only — HERMES_DESKTOP is set on the gateway the app spawns."""
|
|
return env_var_enabled("HERMES_DESKTOP")
|
|
|
|
|
|
CLOSE_TERMINAL_SCHEMA = {
|
|
"name": "close_terminal",
|
|
"description": (
|
|
"Close the read-only terminal tab for one of your background processes in "
|
|
"the Hermes desktop GUI (the tabs mirroring terminal(background=true) runs). "
|
|
"This does NOT kill the process — it only drops the tab/view; the output "
|
|
"keeps buffering and the user can reopen it from the status stack. Use it "
|
|
"to tidy up when a background process's live terminal is no longer worth "
|
|
"showing. To actually stop the process, use process(action='kill') instead."
|
|
),
|
|
"parameters": {
|
|
"type": "object",
|
|
"properties": {
|
|
"process_id": {
|
|
"type": "string",
|
|
"description": (
|
|
"The background process's session id (from terminal(background=true) "
|
|
"output or process(action='list')) whose tab should be closed."
|
|
),
|
|
},
|
|
},
|
|
"required": ["process_id"],
|
|
},
|
|
}
|
|
|
|
|
|
registry.register(
|
|
name="close_terminal",
|
|
toolset="terminal",
|
|
schema=CLOSE_TERMINAL_SCHEMA,
|
|
handler=lambda args, **kw: close_terminal_tool(process_id=args.get("process_id", "")),
|
|
check_fn=check_close_terminal_requirements,
|
|
emoji="🖥️",
|
|
)
|