"""Tests for the /plan gateway slash command.""" from datetime import datetime from types import SimpleNamespace from unittest.mock import AsyncMock, MagicMock, patch import pytest from agent.skill_commands import scan_skill_commands from gateway.config import GatewayConfig, Platform, PlatformConfig from gateway.platforms.base import MessageEvent from gateway.session import SessionEntry, SessionSource def _make_runner(): from gateway.run import GatewayRunner runner = object.__new__(GatewayRunner) runner.config = GatewayConfig( platforms={Platform.TELEGRAM: PlatformConfig(enabled=True, token="***")} ) runner.adapters = {} runner._voice_mode = {} runner.hooks = SimpleNamespace(emit=AsyncMock(), loaded_hooks=False) runner.session_store = MagicMock() runner.session_store.get_or_create_session.return_value = SessionEntry( session_key="agent:main:telegram:dm:c1:u1", session_id="sess-1", created_at=datetime.now(), updated_at=datetime.now(), platform=Platform.TELEGRAM, chat_type="dm", ) runner.session_store.load_transcript.return_value = [] runner.session_store.has_any_sessions.return_value = True runner.session_store.append_to_transcript = MagicMock() runner.session_store.rewrite_transcript = MagicMock() runner._running_agents = {} runner._pending_messages = {} runner._pending_approvals = {} runner._session_db = None runner._reasoning_config = None runner._provider_routing = {} runner._fallback_model = None runner._show_reasoning = False runner._is_user_authorized = lambda _source: True runner._set_session_env = lambda _context: None runner._run_agent = AsyncMock( return_value={ "final_response": "planned", "messages": [], "tools": [], "history_offset": 0, "last_prompt_tokens": 0, } ) return runner def _make_event(text="/plan"): return MessageEvent( text=text, source=SessionSource( platform=Platform.TELEGRAM, user_id="u1", chat_id="c1", user_name="tester", chat_type="dm", ), message_id="m1", ) def _make_plan_skill(skills_dir): skill_dir = skills_dir / "plan" skill_dir.mkdir(parents=True, exist_ok=True) (skill_dir / "SKILL.md").write_text( """--- name: plan description: Plan mode skill. --- # Plan Use the current conversation context when no explicit instruction is provided. Save plans under the active workspace's .hermes/plans directory. """ ) class TestGatewayPlanCommand: @pytest.mark.asyncio async def test_plan_command_loads_skill_and_runs_agent(self, monkeypatch, tmp_path): import gateway.run as gateway_run runner = _make_runner() event = _make_event("/plan Add OAuth login") monkeypatch.setattr(gateway_run, "_resolve_runtime_agent_kwargs", lambda: {"api_key": "***"}) monkeypatch.setattr( "agent.model_metadata.get_model_context_length", lambda *_args, **_kwargs: 100_000, ) with patch("tools.skills_tool.SKILLS_DIR", tmp_path): _make_plan_skill(tmp_path) scan_skill_commands() result = await runner._handle_message(event) assert result == "planned" forwarded = runner._run_agent.call_args.kwargs["message"] assert "Plan mode skill" in forwarded assert "Add OAuth login" in forwarded assert ".hermes/plans" in forwarded assert str(tmp_path / "plans") not in forwarded assert "active workspace/backend cwd" in forwarded assert "Runtime note:" in forwarded @pytest.mark.asyncio async def test_plan_command_appears_in_help_output_via_skill_listing(self, tmp_path): runner = _make_runner() event = _make_event("/help") with patch("tools.skills_tool.SKILLS_DIR", tmp_path): _make_plan_skill(tmp_path) scan_skill_commands() result = await runner._handle_help_command(event) assert "/plan" in result