hermes-agent/tests/tools/test_tts_instructions.py
Teknium 39975613b1
test: prune wave 2 + speed fixes — 28,106 → 19,757 test functions, suite wall 315s → 294s
Second, deeper pass over tools/gateway/hermes_cli plus first pass over
the trees wave 1 missed (acp, acp_adapter, skills, computer_use, docker,
dashboard, conformance, monitoring, secret_sources, hermes_state,
providers). Same rubric as wave 1 (AGENTS.md test policy); security,
alternation/caching invariants, issue-number regressions, and E2E kept.

Real test-quality fixes found and rooted out along the way:
- tests/tools/test_command_guards.py made real auxiliary-LLM HTTPS calls
  (DEFAULT_CONFIG smart-approval leaked in) — pinned approval
  mode=manual via autouse fixture: 17.4s → 0.4s.
- test_model_switch_custom_providers.py / test_user_providers_model_switch.py
  silently probed live provider catalogs (~2s/test) — stubbed
  cached_provider_model_ids/provider_model_ids/fetch_api_models.
- test_telegram_noise_filter.py: 15-platform copy-paste matrix over
  shared gateway.run logic → 3 representative platforms (55s → 3.9s).
- test_gateway_shutdown.py: stop()'s 5s interrupt-deadline loop spun on
  MagicMock agents — interrupt.side_effect now clears _running_agents
  (22s → 1.0s).
- test_gateway_inactivity_timeout.py poll-harness timings shrunk 3-5x
  (24s → 1.1s); test_mcp_stability.py backoff/SIGTERM-grace sleeps
  patched (15.4s → 2.5s); test_async_delegation.py negative-drain wait
  5s → 0.5s.
- test_telegram_init_deadline.py: loop-block margin restored to 1.0s
  with rationale comment — the watchdog-dump assertion needs the loop
  blocked well past deadline+grace under parallel load (flaked once in
  the 40-worker verification run at a 0.2s margin).

Verification: full hermetic suite via scripts/run_tests.sh —
2,438 files, 21,718 tests passed, 0 failed, 293.9s wall.
Suite totals vs original baseline: 46,820 → 19,757 test functions
(−57.8%), wall 583.5s → 293.9s (−50%), subprocess CPU 13,564s → 11,623s.
2026-07-29 13:39:40 -07:00

116 lines
4.8 KiB
Python

"""Tests for the OpenAI TTS `instructions` field passthrough.
Covers #14196: forwarding the OpenAI-spec `instructions` parameter through the
`text_to_speech` tool so the agent can control tone/emotion/pacing on
gpt-4o-mini-tts and OpenAI-compatible voice-design servers.
"""
import json
from unittest.mock import MagicMock, patch
import pytest
@pytest.fixture(autouse=True)
def clean_env(monkeypatch):
for key in ("OPENAI_API_KEY", "HERMES_SESSION_PLATFORM"):
monkeypatch.delenv(key, raising=False)
# ---------------------------------------------------------------------------
# Backend-level passthrough (_generate_openai_tts)
# ---------------------------------------------------------------------------
class TestOpenaiBackendInstructions:
def _run(self, tmp_path, monkeypatch, *, tts_config=None, instructions=None):
monkeypatch.setenv("OPENAI_API_KEY", "test-key")
mock_client = MagicMock()
mock_client.audio.speech.create.return_value = MagicMock()
mock_cls = MagicMock(return_value=mock_client)
with patch("tools.tts_tool._import_openai_client", return_value=mock_cls), \
patch("tools.tts_tool._resolve_openai_audio_client_config",
return_value=("test-key", None, False)):
from tools.tts_tool import _generate_openai_tts
kwargs = {}
if instructions is not None:
kwargs["instructions"] = instructions
_generate_openai_tts(
"Hello", str(tmp_path / "out.mp3"), tts_config or {}, **kwargs
)
return mock_client.audio.speech.create
def test_instructions_forwarded_when_provided(self, tmp_path, monkeypatch):
"""Tool arg `instructions` is passed to audio.speech.create as-is."""
create = self._run(tmp_path, monkeypatch, instructions="Speak cheerfully.")
assert create.call_args[1]["instructions"] == "Speak cheerfully."
def test_empty_string_instructions_omitted(self, tmp_path, monkeypatch):
"""Empty string is treated as absent (not forwarded)."""
create = self._run(tmp_path, monkeypatch, instructions="")
assert "instructions" not in create.call_args[1]
# ---------------------------------------------------------------------------
# Tool-level plumbing (text_to_speech_tool -> _generate_openai_tts)
# ---------------------------------------------------------------------------
class TestToolLevelInstructions:
def _invoke_tool(self, tmp_path, monkeypatch, *, instructions=None):
monkeypatch.setenv("OPENAI_API_KEY", "test-key")
mock_client = MagicMock()
def fake_stream(path):
# Mimic OpenAI SDK's stream_to_file by writing a tiny payload.
with open(path, "wb") as f:
f.write(b"ID3\x03\x00\x00\x00\x00\x00\x00")
response = MagicMock()
response.stream_to_file.side_effect = fake_stream
mock_client.audio.speech.create.return_value = response
mock_cls = MagicMock(return_value=mock_client)
with patch("tools.tts_tool._import_openai_client", return_value=mock_cls), \
patch("tools.tts_tool._resolve_openai_audio_client_config",
return_value=("test-key", None, False)), \
patch("tools.tts_tool._load_tts_config",
return_value={"provider": "openai"}):
from tools.tts_tool import text_to_speech_tool
kwargs = {"output_path": str(tmp_path / "out.mp3")}
if instructions is not None:
kwargs["instructions"] = instructions
result = text_to_speech_tool("Hello world", **kwargs)
return mock_client.audio.speech.create, json.loads(result)
def test_tool_threads_instructions_to_openai_create(
self, tmp_path, monkeypatch
):
create, result = self._invoke_tool(
tmp_path, monkeypatch, instructions="Whisper conspiratorially."
)
assert result.get("success") is True
assert create.call_args[1]["instructions"] == "Whisper conspiratorially."
def test_tool_omits_instructions_when_not_supplied(
self, tmp_path, monkeypatch
):
create, result = self._invoke_tool(tmp_path, monkeypatch)
assert result.get("success") is True
assert "instructions" not in create.call_args[1]
# ---------------------------------------------------------------------------
# Schema
# ---------------------------------------------------------------------------
class TestSchema:
def test_schema_exposes_instructions_parameter(self):
from tools.tts_tool import TTS_SCHEMA
props = TTS_SCHEMA["parameters"]["properties"]
assert "instructions" in props
assert props["instructions"]["type"] == "string"
# Must stay optional — current behavior must be preserved.
assert "instructions" not in TTS_SCHEMA["parameters"].get("required", [])