chore: prune unused imports and duplicate import redefinitions

Remove unused imports (F401) and duplicate/shadowed import
redefinitions (F811) across the codebase using ruff's safe
autofixes. No behavioral changes -- imports only.

- ~1400 safe autofixes applied across 644 files (net -1072 lines)
- __init__.py re-exports preserved (excluded from F401 removal so
  public re-export surfaces stay intact)
- Re-exports that are imported or monkeypatched by tests but look
  unused in their defining module are kept with explicit # noqa:
  F401 (gateway/run.py load_dotenv; run_agent re-exports from
  agent.message_sanitization, agent.context_compressor,
  agent.retry_utils, agent.prompt_builder, agent.process_bootstrap,
  agent.codex_responses_adapter)
- Unsafe F841 (unused-variable) fixes deliberately skipped -- those
  can change behavior when the RHS has side effects
- ruff lints remain disabled in pyproject.toml (only PLW1514 is
  selected); this is a one-time cleanup, not a config change

Verification:
- python -m compileall: clean
- pytest --collect-only: all 27161 tests collect (zero import errors)
- core entry points import clean (run_agent, model_tools, cli,
  toolsets, hermes_state, batch_runner, gateway)
- static scan: every name any test imports directly from an edited
  module still resolves

tests/acp/test_approval_isolation.py

@@ -13,11 +13,8 @@ Both fixed together by:
    threads don't collide.
 """
 
-import os
 import threading
-from unittest.mock import MagicMock
 
-import pytest
 
 
 class TestThreadLocalApprovalCallback:

tests/acp/test_events.py

@@ -9,7 +9,7 @@ from unittest.mock import AsyncMock, MagicMock, patch
 import pytest
 
 import acp
-from acp.schema import AgentPlanUpdate, ToolCallStart, ToolCallProgress, AgentThoughtChunk, AgentMessageChunk
+from acp.schema import AgentPlanUpdate
 
 from acp_adapter.events import (
     _build_plan_update_from_todo_result,

tests/acp/test_mcp_e2e.py

@@ -7,9 +7,6 @@ Exercises the full flow through the ACP server layer:
     session_update events arrive at the mock client
 """
 
-import asyncio
-from collections import deque
-from types import SimpleNamespace
 from unittest.mock import AsyncMock, MagicMock, patch
 
 import pytest

tests/acp/test_server.py

@@ -18,7 +18,6 @@ from acp.schema import (
     AvailableCommandsUpdate,
     Implementation,
     InitializeResponse,
-    ListSessionsResponse,
     LoadSessionResponse,
     NewSessionResponse,
     PromptResponse,
@@ -33,7 +32,6 @@ from acp.schema import (
     TextContentBlock,
     ToolCallProgress,
     ToolCallStart,
-    Usage,
     UsageUpdate,
     UserMessageChunk,
 )

tests/acp/test_tools.py

@@ -1,6 +1,5 @@
 """Tests for acp_adapter.tools — tool kind mapping and ACP content building."""
 
-import pytest
 
 from acp_adapter.edit_approval import EditProposal
 from acp_adapter.tools import (

tests/agent/lsp/test_backend_gate.py

@@ -8,8 +8,6 @@ syntax check exactly as if LSP were disabled.
 """
 from __future__ import annotations
 
-import os
-import sys
 from unittest.mock import MagicMock
 
 import pytest

tests/agent/lsp/test_broken_set.py

@@ -14,15 +14,12 @@ This module verifies:
 """
 from __future__ import annotations
 
-import os
-import sys
 from pathlib import Path
-from unittest.mock import MagicMock, patch
+from unittest.mock import patch
 
 import pytest
 
 from agent.lsp.manager import LSPService
-from agent.lsp.servers import SERVERS, ServerContext, ServerDef, SpawnSpec
 from agent.lsp.workspace import clear_cache
 
 

tests/agent/lsp/test_diagnostics_field.py

@@ -6,12 +6,8 @@ having LSP output prepended to the lint string.
 """
 from __future__ import annotations
 
-import os
-import sys
-import tempfile
-from unittest.mock import MagicMock, patch
+from unittest.mock import patch
 
-import pytest
 
 from tools.environments.local import LocalEnvironment
 from tools.file_operations import (

tests/agent/lsp/test_lifecycle.py

@@ -7,7 +7,7 @@ pyright/gopls/etc. are still alive on the host.
 from __future__ import annotations
 
 import atexit
-from unittest.mock import MagicMock, patch
+from unittest.mock import MagicMock
 
 import pytest
 

tests/agent/lsp/test_reporter.py

@@ -2,7 +2,6 @@
 from __future__ import annotations
 
 from agent.lsp.reporter import (
-    DEFAULT_SEVERITIES,
     MAX_PER_FILE,
     format_diagnostic,
     report_for_file,

tests/agent/lsp/test_service.py

@@ -7,7 +7,6 @@ on.
 """
 from __future__ import annotations
 
-import os
 import sys
 from pathlib import Path
 
@@ -19,7 +18,6 @@ from agent.lsp.servers import (
     ServerContext,
     ServerDef,
     SpawnSpec,
-    find_server_for_file,
 )
 
 

tests/agent/test_anthropic_keychain.py

@@ -1,10 +1,8 @@
 """Tests for Bug #12905 fixes in agent/anthropic_adapter.py — macOS Keychain support."""
 
 import json
-import platform
 from unittest.mock import patch, MagicMock
 
-import pytest
 
 from agent.anthropic_adapter import (
     _read_claude_code_credentials_from_keychain,

tests/agent/test_anthropic_mcp_prefix_strip.py

@@ -8,11 +8,9 @@ name in the tool registry.
 
 from __future__ import annotations
 
-import json
 from types import SimpleNamespace
 from unittest.mock import patch
 
-import pytest
 
 
 # ---------------------------------------------------------------------------

tests/agent/test_anthropic_oauth_pkce.py

@@ -15,7 +15,6 @@ History:
 
 from __future__ import annotations
 
-import io
 import json
 from typing import Any, Dict
 from urllib.parse import parse_qs, urlparse

tests/agent/test_async_utils.py

@@ -8,7 +8,6 @@ import warnings
 from concurrent.futures import Future
 from unittest.mock import patch
 
-import pytest
 
 from agent.async_utils import safe_schedule_threadsafe
 

tests/agent/test_auxiliary_client.py

@@ -2,9 +2,7 @@
 
 import json
 import logging
-import os
 import time
-from pathlib import Path
 from types import SimpleNamespace
 from unittest.mock import patch, MagicMock, AsyncMock
 
@@ -609,7 +607,7 @@ class TestExpiredCodexFallback:
         monkeypatch.setenv("ANTHROPIC_TOKEN", "sk-ant-oat01-test-fallback")
         with patch("agent.anthropic_adapter.build_anthropic_client") as mock_build:
             mock_build.return_value = MagicMock()
-            from agent.auxiliary_client import _resolve_auto, AnthropicAuxiliaryClient
+            from agent.auxiliary_client import _resolve_auto
             client, model = _resolve_auto()
             # Should NOT be Codex, should be Anthropic (or another available provider)
             assert not isinstance(client, type(None)), "Should find a provider after expired Codex"
@@ -696,7 +694,7 @@ class TestExpiredCodexFallback:
              patch("agent.anthropic_adapter.build_anthropic_client") as mock_build, \
              patch("agent.auxiliary_client._select_pool_entry", return_value=(False, None)):
             mock_build.return_value = MagicMock()
-            from agent.auxiliary_client import _try_anthropic, AnthropicAuxiliaryClient
+            from agent.auxiliary_client import _try_anthropic
             client, model = _try_anthropic()
             assert client is not None, "Should resolve token"
             adapter = client.chat.completions
@@ -751,7 +749,7 @@ class TestExpiredCodexFallback:
         monkeypatch.delenv("ANTHROPIC_TOKEN", raising=False)
         with patch("agent.anthropic_adapter.build_anthropic_client") as mock_build:
             mock_build.return_value = MagicMock()
-            from agent.auxiliary_client import _try_anthropic, AnthropicAuxiliaryClient
+            from agent.auxiliary_client import _try_anthropic
             client, model = _try_anthropic()
             assert client is not None
             adapter = client.chat.completions

tests/agent/test_auxiliary_client_azure_foundry.py

@@ -27,7 +27,6 @@ from __future__ import annotations
 
 import sys
 from types import SimpleNamespace
-from unittest.mock import MagicMock, patch
 
 import pytest
 

tests/agent/test_auxiliary_config_bridge.py

@@ -4,14 +4,11 @@ are properly mapped to environment variables by both CLI and gateway loaders.
 Also tests the vision_tools and browser_tool model override env vars.
 """
 
-import json
 import os
 import sys
 from pathlib import Path
 from unittest.mock import patch, MagicMock
 
-import pytest
-import yaml
 
 sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", ".."))
 

tests/agent/test_auxiliary_main_first.py

@@ -15,7 +15,6 @@ from __future__ import annotations
 
 from unittest.mock import MagicMock, patch
 
-import pytest
 
 
 # ── Text aux tasks — _resolve_auto ──────────────────────────────────────────

tests/agent/test_auxiliary_named_custom_providers.py

@@ -1,6 +1,5 @@
 """Tests for named custom provider and 'main' alias resolution in auxiliary_client."""
 
-import os
 from unittest.mock import patch, MagicMock
 
 import pytest

tests/agent/test_azure_identity_adapter.py

@@ -23,7 +23,6 @@ import sys
 from collections.abc import Callable
 from types import SimpleNamespace
 from typing import cast
-from unittest.mock import MagicMock, patch
 
 import pytest
 

tests/agent/test_bedrock_adapter.py

@@ -10,11 +10,9 @@ Covers:
 """
 
 import json
-import os
-import time
 from contextlib import contextmanager
-from types import ModuleType, SimpleNamespace
-from unittest.mock import MagicMock, patch, PropertyMock
+from types import ModuleType
+from unittest.mock import MagicMock, patch
 
 import pytest
 
@@ -129,7 +127,7 @@ class TestResolveBedrocRegion:
 
     def test_defaults_to_us_east_1(self):
         from agent.bedrock_adapter import resolve_bedrock_region
-        from unittest.mock import patch, MagicMock
+        from unittest.mock import MagicMock
         mock_session = MagicMock()
         mock_session.get_config_variable.return_value = None
         with _mock_botocore_session(return_value=mock_session):
@@ -137,7 +135,7 @@ class TestResolveBedrocRegion:
 
     def test_falls_back_to_botocore_profile_region(self):
         from agent.bedrock_adapter import resolve_bedrock_region
-        from unittest.mock import patch, MagicMock
+        from unittest.mock import MagicMock
         mock_session = MagicMock()
         mock_session.get_config_variable.return_value = "eu-central-1"
         with _mock_botocore_session(return_value=mock_session):
@@ -145,7 +143,6 @@ class TestResolveBedrocRegion:
 
     def test_botocore_failure_falls_back_to_us_east_1(self):
         from agent.bedrock_adapter import resolve_bedrock_region
-        from unittest.mock import patch
         with _mock_botocore_session(side_effect=Exception("no botocore")):
             assert resolve_bedrock_region({}) == "us-east-1"
 

tests/agent/test_bedrock_integration.py

@@ -9,7 +9,6 @@ Note: Tests that import ``hermes_cli.auth`` or ``hermes_cli.runtime_provider``
 require Python 3.10+ due to ``str | None`` type syntax in the import chain.
 """
 
-import os
 from unittest.mock import MagicMock, patch
 
 import pytest
@@ -93,7 +92,6 @@ class TestResolveProvider:
 
     def test_explicit_bedrock_resolves(self, monkeypatch):
         """When user explicitly requests 'bedrock', it should resolve."""
-        from hermes_cli.auth import PROVIDER_REGISTRY
         # bedrock is in the registry, so resolve_provider should return it
         from hermes_cli.auth import resolve_provider
         result = resolve_provider("bedrock")

tests/agent/test_codex_cloudflare_headers.py

@@ -29,7 +29,6 @@ import base64
 import json
 from unittest.mock import MagicMock, patch
 
-import pytest
 
 
 # ---------------------------------------------------------------------------

tests/agent/test_compressor_image_tokens.py

@@ -8,7 +8,6 @@ creative workflows that iterate on images across many turns.
 
 from __future__ import annotations
 
-import pytest
 
 from agent.context_compressor import (
     _CHARS_PER_TOKEN,

tests/agent/test_context_engine.py

@@ -232,7 +232,7 @@ class TestPluginContextEngineSlot:
         assert mgr._context_engine is None
 
     def test_get_plugin_context_engine(self):
-        from hermes_cli.plugins import PluginManager, PluginContext, PluginManifest, get_plugin_context_engine, _plugin_manager
+        from hermes_cli.plugins import PluginManager, get_plugin_context_engine
         import hermes_cli.plugins as plugins_mod
 
         # Inject a test manager

tests/agent/test_context_engine_host_contract.py

@@ -28,7 +28,6 @@ from __future__ import annotations
 
 from unittest.mock import MagicMock
 
-import pytest
 
 from run_agent import AIAgent
 

tests/agent/test_crossloop_client_cache.py

@@ -10,9 +10,7 @@ so it can run without optional dependencies like firecrawl.
 
 import asyncio
 import threading
-from concurrent.futures import ThreadPoolExecutor
 from unittest.mock import patch, MagicMock
-from types import SimpleNamespace
 
 import pytest
 
@@ -32,7 +30,6 @@ def _stub_resolve_provider_client(provider, model, async_mode, **kw):
 @pytest.fixture(autouse=True)
 def _clean_client_cache():
     """Clear the client cache before each test."""
-    import importlib
     # We need to patch before importing
     with patch.dict("sys.modules", {}):
         pass
@@ -48,7 +45,7 @@ class TestCrossLoopCacheIsolation:
 
     def test_same_loop_reuses_client(self):
         """Within a single event loop, the same client should be returned."""
-        from agent.auxiliary_client import _get_cached_client, _client_cache
+        from agent.auxiliary_client import _get_cached_client
 
         loop = asyncio.new_event_loop()
         asyncio.set_event_loop(loop)

tests/agent/test_curator.py

@@ -7,7 +7,6 @@ tests run fully offline and the curator module doesn't need real credentials.
 from __future__ import annotations
 
 import importlib
-import json
 from datetime import datetime, timedelta, timezone
 from pathlib import Path
 

tests/agent/test_curator_reports.py

@@ -7,8 +7,7 @@ the standard log dir, not inside the user's ``skills/`` data directory.
 from __future__ import annotations
 
 import json
-import os
-from datetime import datetime, timezone, timedelta
+from datetime import datetime, timezone
 from pathlib import Path
 
 import pytest

tests/agent/test_display.py

@@ -1,9 +1,8 @@
 """Tests for agent/display.py — build_tool_preview() and inline diff previews."""
 
-import os
 import json
 import pytest
-from unittest.mock import MagicMock, patch
+from unittest.mock import MagicMock
 
 from agent.display import (
     build_tool_preview,

tests/agent/test_display_todo_progress.py

@@ -5,7 +5,6 @@ todo tool call paths: read, create (merge=False), update (merge=True).
 """
 
 import json
-import pytest
 from agent.display import get_cute_tool_message
 
 

tests/agent/test_display_tool_failure.py

@@ -7,7 +7,6 @@ not a generic "[error]".
 """
 
 import json
-import pytest
 
 from agent.display import (
     _detect_tool_failure,

tests/agent/test_external_skills.py

@@ -2,7 +2,6 @@
 
 import json
 import os
-from pathlib import Path
 from unittest.mock import patch
 
 import pytest

tests/agent/test_external_skills_dirs_cache.py

@@ -11,7 +11,6 @@ cache invalidates when config.yaml's mtime changes.
 from __future__ import annotations
 
 import os
-import time
 from pathlib import Path
 from unittest.mock import patch
 

tests/agent/test_file_safety.py

@@ -4,8 +4,6 @@ Run with:  python -m pytest tests/agent/test_file_safety.py -v
 """
 
 import os
-import tempfile
-from pathlib import Path
 from unittest.mock import patch
 
 import pytest

tests/agent/test_file_safety_cross_profile.py

@@ -12,7 +12,6 @@ afterwards that the second path belonged to a different profile.
 """
 from __future__ import annotations
 
-import os
 from pathlib import Path
 
 import pytest

tests/agent/test_gemini_cloudcode.py

@@ -18,8 +18,6 @@ import json
 import stat
 import time
 from pathlib import Path
-from types import SimpleNamespace
-from unittest.mock import MagicMock, patch
 
 import pytest
 

tests/agent/test_gemini_free_tier_gate.py

@@ -3,7 +3,6 @@ from __future__ import annotations
 
 from unittest.mock import MagicMock, patch
 
-import pytest
 
 from agent.gemini_native_adapter import (
     gemini_http_error,

tests/agent/test_image_routing.py

@@ -6,7 +6,6 @@ import base64
 from pathlib import Path
 from unittest.mock import patch
 
-import pytest
 
 from agent.image_routing import (
     _coerce_capability_bool,

tests/agent/test_insights.py

@@ -2,7 +2,6 @@
 
 import time
 import pytest
-from pathlib import Path
 
 from hermes_state import SessionDB
 from agent.insights import (
@@ -11,7 +10,6 @@ from agent.insights import (
     _format_duration,
     _bar_chart,
     _has_known_pricing,
-    _DEFAULT_PRICING,
 )
 
 
@@ -596,7 +594,6 @@ class TestEdgeCases:
 
     def test_tool_usage_from_tool_calls_json(self, db):
         """Tool usage should be extracted from tool_calls JSON when tool_name is NULL."""
-        import json as _json
         db.create_session(session_id="s1", source="cli", model="test")
         # Assistant message with tool_calls (this is what CLI produces)
         db.append_message("s1", role="assistant", content="Let me search",

tests/agent/test_memory_provider.py

@@ -2,7 +2,7 @@
 
 import json
 import pytest
-from unittest.mock import MagicMock, patch
+from unittest.mock import MagicMock
 
 from agent.memory_provider import MemoryProvider
 from agent.memory_manager import MemoryManager
@@ -462,7 +462,7 @@ class TestUserInstalledProviderDiscovery:
 
     def test_discover_finds_user_plugins(self, tmp_path, monkeypatch):
         """discover_memory_providers() includes user-installed plugins."""
-        from plugins.memory import discover_memory_providers, _get_user_plugins_dir
+        from plugins.memory import discover_memory_providers
         self._make_user_memory_plugin(tmp_path, "myexternal")
         monkeypatch.setattr(
             "plugins.memory._get_user_plugins_dir",

tests/agent/test_memory_session_switch.py

@@ -7,7 +7,6 @@ state in initialize() (Hindsight, and any plugin that stores session_id
 for scoped writes) keep writing into the old session's record.
 """
 
-import json
 
 import pytest
 

tests/agent/test_memory_user_id.py

@@ -6,7 +6,6 @@ so each gateway user gets their own memory bucket instead of sharing a static on
 
 import json
 import os
-import pytest
 from unittest.mock import MagicMock, patch
 
 from agent.memory_provider import MemoryProvider

tests/agent/test_model_metadata.py

@@ -10,13 +10,9 @@ Coverage levels:
   Persistent cache       — save/load, corruption, update, provider isolation
 """
 
-import os
 import time
-import tempfile
 
-import pytest
 import yaml
-from pathlib import Path
 from unittest.mock import patch, MagicMock
 
 from agent.model_metadata import (

tests/agent/test_model_metadata_local_ctx.py

@@ -6,12 +6,10 @@ All tests use synthetic inputs — no filesystem or live server required.
 
 import sys
 import os
-import json
 from unittest.mock import MagicMock, patch
 
 sys.path.insert(0, os.path.join(os.path.dirname(__file__), ".."))
 
-import pytest
 
 
 # ---------------------------------------------------------------------------
@@ -562,7 +560,7 @@ class TestGetModelContextLengthLocalFallback:
 
     def test_non_local_endpoint_does_not_query_local_server(self):
         """For non-local endpoints, _query_local_context_length is not called."""
-        from agent.model_metadata import get_model_context_length, CONTEXT_PROBE_TIERS
+        from agent.model_metadata import get_model_context_length
 
         with patch("agent.model_metadata.get_cached_context_length", return_value=None), \
              patch("agent.model_metadata.fetch_endpoint_model_metadata", return_value={}), \

tests/agent/test_models_dev.py

@@ -1,8 +1,6 @@
 """Tests for agent.models_dev — models.dev registry integration."""
-import json
 from unittest.mock import patch, MagicMock
 
-import pytest
 from agent.models_dev import (
     PROVIDER_TO_MODELS_DEV,
     _extract_context,

tests/agent/test_non_stream_stale_timeout.py

@@ -11,10 +11,8 @@ Covers:
 
 from __future__ import annotations
 
-import os
 from pathlib import Path
 
-import pytest
 
 
 def _write_config(tmp_path: Path, body: str) -> None:

tests/agent/test_onboarding.py

@@ -3,7 +3,6 @@
 from __future__ import annotations
 
 import yaml
-import pytest
 
 from agent.onboarding import (
     BUSY_INPUT_FLAG,

tests/agent/test_plugin_llm.py

@@ -10,7 +10,6 @@ from __future__ import annotations
 
 import asyncio
 import base64
-import json
 from types import SimpleNamespace
 from typing import Any
 from unittest.mock import MagicMock

tests/agent/test_prompt_builder.py

@@ -18,7 +18,6 @@ from agent.prompt_builder import (
     build_skills_system_prompt,
     build_nous_subscription_prompt,
     build_context_files_prompt,
-    build_environment_hints,
     CONTEXT_FILE_MAX_CHARS,
     DEFAULT_AGENT_IDENTITY,
     TOOL_USE_ENFORCEMENT_GUIDANCE,

tests/agent/test_prompt_caching.py

@@ -1,7 +1,5 @@
 """Tests for agent/prompt_caching.py — Anthropic cache control injection."""
 
-import copy
-import pytest
 
 from agent.prompt_caching import (
     _apply_cache_marker,

tests/agent/test_rate_limit_tracker.py

@@ -189,14 +189,11 @@ class TestAgentIntegration:
 
     def test_capture_rate_limits_from_headers(self):
         """Simulate the header capture path without a real API call."""
-        import sys
-        import os
         # Use a mock httpx-like response
         class MockResponse:
             headers = NOUS_HEADERS
 
         # Import AIAgent minimally
-        from unittest.mock import MagicMock, patch
 
         # Test the parsing directly
         state = parse_rate_limit_headers(MockResponse.headers, provider="nous")

tests/agent/test_redact.py

@@ -1,7 +1,6 @@
 """Tests for agent.redact -- secret masking in logs and output."""
 
 import logging
-import os
 
 import pytest
 

tests/agent/test_shell_hooks.py

@@ -9,10 +9,7 @@ covered in ``test_shell_hooks_consent.py``.
 from __future__ import annotations
 
 import json
-import os
-import stat
 from pathlib import Path
-from typing import Any, Dict
 
 import pytest
 

tests/agent/test_shell_hooks_consent.py

@@ -7,7 +7,6 @@ hooks_auto_accept: config key).
 
 from __future__ import annotations
 
-import json
 from pathlib import Path
 from unittest.mock import patch
 

tests/agent/test_skill_bundles.py

@@ -2,7 +2,6 @@
 
 import os
 from pathlib import Path
-from unittest.mock import patch
 
 import pytest
 

tests/agent/test_subagent_progress.py

@@ -10,10 +10,8 @@ Verifies that:
 
 import io
 import sys
-import time
-import threading
 import pytest
-from unittest.mock import MagicMock, patch
+from unittest.mock import MagicMock
 
 from agent.display import KawaiiSpinner
 from tools.delegate_tool import _build_child_progress_callback

tests/agent/test_subdirectory_hints.py

@@ -1,6 +1,5 @@
 """Tests for progressive subdirectory hint discovery."""
 
-import os
 import pytest
 from pathlib import Path
 from unittest.mock import patch

tests/agent/test_title_generator.py

@@ -1,9 +1,7 @@
 """Tests for agent.title_generator — auto-generated session titles."""
 
-import threading
 from unittest.mock import MagicMock, patch
 
-import pytest
 
 from agent.title_generator import (
     generate_title,

tests/agent/transports/test_bedrock_transport.py

@@ -1,11 +1,10 @@
 """Tests for the BedrockTransport."""
 
-import json
 import pytest
 from types import SimpleNamespace
 
 from agent.transports import get_transport
-from agent.transports.types import NormalizedResponse, ToolCall
+from agent.transports.types import NormalizedResponse
 
 
 @pytest.fixture

tests/agent/transports/test_codex_app_server_session.py

@@ -7,7 +7,6 @@ deadline timeouts. These tests pin all of that without spawning real codex.
 
 from __future__ import annotations
 
-import threading
 import time
 from unittest.mock import patch
 from typing import Any, Optional
@@ -17,7 +16,6 @@ import pytest
 import agent.transports.codex_app_server_session as session_mod
 from agent.transports.codex_app_server_session import (
     CodexAppServerSession,
-    TurnResult,
     _ServerRequestRouting,
     _approval_choice_to_codex_decision,
     _coerce_turn_input_text,

tests/agent/transports/test_codex_event_projector.py

@@ -11,7 +11,6 @@ import pytest
 
 from agent.transports.codex_event_projector import (
     CodexEventProjector,
-    ProjectionResult,
     _deterministic_call_id,
     _format_tool_args,
 )

tests/agent/transports/test_codex_transport.py

@@ -5,7 +5,7 @@ import pytest
 from types import SimpleNamespace
 
 from agent.transports import get_transport
-from agent.transports.types import NormalizedResponse, ToolCall
+from agent.transports.types import NormalizedResponse
 
 
 @pytest.fixture

tests/agent/transports/test_hermes_tools_mcp_server.py

@@ -8,9 +8,7 @@ build helper assembles a server when the SDK is present.
 
 from __future__ import annotations
 
-from unittest.mock import patch
 
-import pytest
 
 
 class TestModuleSurface:

tests/agent/transports/test_transport.py

@@ -2,10 +2,9 @@
 
 import pytest
 from types import SimpleNamespace
-from unittest.mock import MagicMock
 
 from agent.transports.base import ProviderTransport
-from agent.transports.types import NormalizedResponse, ToolCall, Usage
+from agent.transports.types import NormalizedResponse
 from agent.transports import get_transport, register_transport, _REGISTRY
 
 

tests/agent/transports/test_types.py

@@ -1,7 +1,6 @@
 """Tests for agent/transports/types.py — dataclass construction + helpers."""
 
 import json
-import pytest
 
 from agent.transports.types import (
     NormalizedResponse,

tests/cli/test_branch_command.py

@@ -10,10 +10,8 @@ Verifies that:
 """
 
 import os
-import uuid
 from datetime import datetime
-from pathlib import Path
-from unittest.mock import MagicMock, patch, PropertyMock
+from unittest.mock import MagicMock
 
 import pytest
 

tests/cli/test_cli_background_tui_refresh.py

@@ -4,11 +4,8 @@ Ensures the TUI is properly refreshed before printing background task output
 to prevent spinner/status bar overlap (#2718).
 """
 
-import threading
-from types import SimpleNamespace
 from unittest.mock import MagicMock, patch
 
-import pytest
 
 from cli import HermesCLI
 

tests/cli/test_cli_file_drop.py

@@ -1,9 +1,6 @@
 """Tests for _detect_file_drop — file path detection that prevents
 dragged/pasted absolute paths from being mistaken for slash commands."""
 
-import os
-import tempfile
-from pathlib import Path
 
 import pytest
 

tests/cli/test_cli_goal_interrupt.py

@@ -12,7 +12,6 @@ minimal ``HermesCLI`` stub (pattern used elsewhere in tests/cli).
 from __future__ import annotations
 
 import queue
-import sys
 import uuid
 from pathlib import Path
 from unittest.mock import MagicMock, patch

tests/cli/test_cli_interrupt_subagent.py

@@ -10,15 +10,12 @@ This tests the COMPLETE path including _run_single_child, _active_children
 registration, interrupt propagation, and child detection.
 """
 
-import json
-import os
-import queue
 import threading
 import time
 import unittest
-from unittest.mock import MagicMock, patch, PropertyMock
+from unittest.mock import MagicMock, patch
 
-from tools.interrupt import set_interrupt, is_interrupted
+from tools.interrupt import set_interrupt
 
 
 class TestCLISubagentInterrupt(unittest.TestCase):

tests/cli/test_cli_light_mode.py

@@ -8,7 +8,6 @@ before the terminal query, which is the path most users hit.
 
 from __future__ import annotations
 
-import importlib
 
 import pytest
 

tests/cli/test_cli_status_bar.py

@@ -568,7 +568,6 @@ class TestStatusBarWidthSource:
     """Ensure status bar fragments don't overflow the terminal width."""
 
     def _make_wide_cli(self):
-        from datetime import datetime, timedelta
         cli_obj = _attach_agent(
             _make_cli(),
             prompt_tokens=100_000,

tests/cli/test_cli_tools_command.py

@@ -1,6 +1,6 @@
 """Tests for /tools slash command handler in the interactive CLI."""
 
-from unittest.mock import MagicMock, patch, call
+from unittest.mock import MagicMock, patch
 
 from cli import HermesCLI
 

tests/cli/test_cwd_env_respect.py

@@ -6,8 +6,6 @@ Rules:
 - Non-local with explicit path: keep as-is.
 """
 
-import os
-import pytest
 
 _CWD_PLACEHOLDERS = (".", "auto", "cwd")
 

tests/cli/test_personality_none.py

@@ -1,6 +1,6 @@
 """Tests for /personality none — clearing personality overlay."""
 import pytest
-from unittest.mock import MagicMock, patch, mock_open
+from unittest.mock import MagicMock, patch
 import yaml
 
 

tests/cli/test_quick_commands.py

@@ -1,7 +1,7 @@
 """Tests for user-defined quick commands that bypass the agent loop."""
 import os
 import subprocess
-from unittest.mock import MagicMock, patch, AsyncMock
+from unittest.mock import MagicMock, patch
 from rich.text import Text
 import pytest
 

tests/cli/test_resume_display.py

@@ -10,7 +10,6 @@ import sys
 from io import StringIO
 from unittest.mock import MagicMock, patch
 
-import pytest
 import cli as cli_mod
 
 sys.path.insert(0, os.path.join(os.path.dirname(__file__), ".."))
@@ -719,7 +718,6 @@ class TestResumeDisplayConfig:
 
     def test_cli_defaults_have_resume_display(self):
         """cli.py load_cli_config defaults include resume_display."""
-        import cli as _cli_mod
         from cli import load_cli_config
 
         with (

tests/cli/test_resume_quiet_stderr.py

@@ -13,7 +13,6 @@ Interactive mode (tool_progress_mode == "full") still uses ChatConsole.
 from datetime import datetime
 from unittest.mock import MagicMock, patch
 
-import pytest
 
 from cli import HermesCLI
 

tests/cli/test_save_conversation_location.py

@@ -11,7 +11,6 @@ the absolute path plus the resume hint for the live session.
 from __future__ import annotations
 
 import json
-import os
 import sys
 from datetime import datetime
 from pathlib import Path

tests/cli/test_session_boundary_hooks.py

@@ -1,9 +1,5 @@
-import pytest
 from unittest.mock import MagicMock, patch
 from hermes_cli.plugins import VALID_HOOKS, PluginManager
-import os
-import shutil
-import tempfile
 from cli import HermesCLI
 
 

tests/cli/test_slash_command_interrupt.py

@@ -11,7 +11,7 @@ prompt_toolkit input loop. We exercise the same try/except by calling
 through a thin wrapper that mirrors the real dispatch shape.
 """
 
-from unittest.mock import MagicMock, patch
+from unittest.mock import patch
 
 from cli import HermesCLI
 

tests/cli/test_slash_confirm_windows.py

@@ -20,7 +20,6 @@ import threading
 import time
 from unittest.mock import MagicMock, patch
 
-import pytest
 
 
 def _make_cli():

tests/cli/test_stream_delta_think_tag.py

@@ -3,7 +3,6 @@ import sys
 import os
 sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", ".."))
 
-import pytest
 
 
 def _make_cli_stub():

tests/cli/test_surrogate_sanitization.py

@@ -13,7 +13,6 @@ from run_agent import (
     _sanitize_surrogates,
     _sanitize_messages_surrogates,
     _sanitize_structure_surrogates,
-    _SURROGATE_RE,
 )
 
 

tests/cli/test_worktree.py

@@ -9,7 +9,6 @@ import shutil
 import subprocess
 import pytest
 from pathlib import Path
-from unittest.mock import patch, MagicMock
 
 
 @pytest.fixture
@@ -397,7 +396,6 @@ class TestWorktreeInclude:
         assert info is not None
 
         # Manually copy .worktreeinclude entries (mirrors cli.py logic)
-        import shutil
         include_file = git_repo / ".worktreeinclude"
         wt_path = Path(info["path"])
         for line in include_file.read_text().splitlines():

tests/conftest.py

@@ -21,10 +21,8 @@ test runner at ``scripts/run_tests.sh``.
 
 import asyncio
 import os
-import re
 import sys
 from pathlib import Path
-from unittest.mock import patch
 
 import pytest
 

tests/cron/test_cron_context_from.py

@@ -45,7 +45,7 @@ class TestJobContextFromField:
         assert loaded["context_from"] == [job_a["id"]]
 
     def test_create_job_with_context_from_list(self, cron_env):
-        from cron.jobs import create_job, get_job
+        from cron.jobs import create_job
 
         job_a = create_job(prompt="Find news", schedule="every 1h")
         job_b = create_job(prompt="Find weather", schedule="every 1h")

tests/cron/test_cron_inactivity_timeout.py

@@ -12,11 +12,8 @@ import concurrent.futures
 import os
 import sys
 import time
-import threading
 from pathlib import Path
-from unittest.mock import MagicMock, patch
 
-import pytest
 
 # Ensure project root is importable
 sys.path.insert(0, str(Path(__file__).parent.parent.parent))

tests/cron/test_cron_no_agent.py

@@ -12,7 +12,6 @@ Covers:
 from __future__ import annotations
 
 import json
-from pathlib import Path
 from unittest.mock import patch
 
 import pytest

tests/cron/test_cron_profile.py

@@ -8,7 +8,6 @@ from __future__ import annotations
 
 import json
 import os
-from pathlib import Path
 
 import pytest
 

tests/cron/test_cron_script.py

@@ -9,11 +9,9 @@ Tests cover:
 
 import json
 import os
-import stat
 import sys
 import textwrap
 from pathlib import Path
-from unittest.mock import patch
 
 import pytest
 

tests/cron/test_cron_workdir.py

@@ -13,7 +13,6 @@ Covers:
 from __future__ import annotations
 
 import json
-from pathlib import Path
 
 import pytest
 

tests/cron/test_file_permissions.py

@@ -1,6 +1,5 @@
 """Tests for file permissions hardening on sensitive files."""
 
-import json
 import os
 import stat
 import tempfile

tests/cron/test_jobs.py

@@ -1,11 +1,8 @@
 """Tests for cron/jobs.py — schedule parsing, job CRUD, and due-job detection."""
 
-import json
 import threading
 import pytest
 from datetime import datetime, timedelta, timezone
-from pathlib import Path
-from unittest.mock import patch
 
 from cron.jobs import (
     parse_duration,

tests/cron/test_scheduler.py

@@ -1275,7 +1275,6 @@ class TestRunJobSessionPersistence:
         (issue #8585)
         """
         from cron.scheduler import tick
-        from cron.jobs import load_jobs, save_jobs
 
         job = {
             "id": "empty-job",
@@ -2300,7 +2299,6 @@ class TestParallelTick:
     def test_parallel_jobs_run_concurrently(self):
         """Two jobs launched in the same tick should overlap in time."""
         import threading
-        import time
 
         barrier = threading.Barrier(2, timeout=5)
         call_order = []

tests/cron/test_scheduler_mcp_init.py

@@ -15,9 +15,8 @@ short-circuit on already-connected servers.
 
 from __future__ import annotations
 
-from unittest.mock import patch, MagicMock
+from unittest.mock import patch
 
-import pytest
 
 
 

tests/e2e/matrix_xsign_bootstrap/test_bootstrap.py

@@ -27,7 +27,6 @@ isn't reachable.
 """
 from __future__ import annotations
 
-import asyncio
 import json
 import logging
 import os
@@ -37,7 +36,6 @@ import shutil
 import subprocess
 import sys
 import tempfile
-import time
 import unittest
 import urllib.error
 import urllib.request

tests/gateway/conftest.py

@@ -419,7 +419,6 @@ def pytest_configure(config):
         lock = FileLock(str(lock_file), timeout=120)
     except ImportError:
         # Fallback: no locking (still correct, just slower under contention).
-        import contextlib
 
         class _NoLock:
             def __enter__(self):