340 lines
12 KiB
Python
340 lines
12 KiB
Python
"""Relay Phase 4 tests — thread lifecycle ops, reply_to enrichment parse,
|
|
auto-thread markers, and the hello command manifest.
|
|
|
|
Covers:
|
|
- create_handoff_thread routes through `thread_create` (op-gated; None
|
|
fallback contract preserved for the handoff watcher);
|
|
- rename_thread routes through `thread_rename` with the
|
|
only_if_current_name guard on the wire (op-gated; False on decline);
|
|
- the relay semantic-rename lane parity: a relay source carrying the
|
|
connector-stamped auto-thread markers satisfies the same field contract
|
|
the native _is_discord_auto_thread_lane reads;
|
|
- _event_from_wire maps reply_to {text,author,is_own} onto the native
|
|
MessageEvent reply-context fields and the auto-thread markers onto
|
|
SessionSource;
|
|
- the ws transport sends command_manifest on the DISCORD hello only;
|
|
- the manifest builder satisfies Discord CHAT_INPUT naming rules.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import re
|
|
from typing import Any, Dict
|
|
|
|
import pytest
|
|
|
|
from gateway.config import Platform, PlatformConfig
|
|
from gateway.relay.adapter import RelayAdapter
|
|
from gateway.relay.command_manifest import build_relay_command_manifest
|
|
from gateway.relay.descriptor import CONTRACT_VERSION, CapabilityDescriptor
|
|
from gateway.relay.ws_transport import _event_from_wire
|
|
|
|
from tests.gateway.relay.stub_connector import StubConnector
|
|
|
|
FULL_OPS = (
|
|
"send",
|
|
"edit",
|
|
"typing",
|
|
"get_chat_info",
|
|
"thread_create",
|
|
"thread_rename",
|
|
)
|
|
|
|
|
|
def make_desc(**kw) -> CapabilityDescriptor:
|
|
base = dict(
|
|
contract_version=CONTRACT_VERSION,
|
|
platform="discord",
|
|
label="Discord",
|
|
max_message_length=2000,
|
|
supports_draft_streaming=False,
|
|
supports_edit=True,
|
|
supports_threads=True,
|
|
markdown_dialect="discord",
|
|
len_unit="chars",
|
|
supported_ops=FULL_OPS,
|
|
)
|
|
base.update(kw)
|
|
return CapabilityDescriptor(**base)
|
|
|
|
|
|
def _adapter(**desc_kw) -> tuple[RelayAdapter, StubConnector]:
|
|
stub = StubConnector(make_desc(**desc_kw))
|
|
adapter = RelayAdapter(PlatformConfig(), make_desc(**desc_kw), transport=stub)
|
|
return adapter, stub
|
|
|
|
|
|
# ── thread_create (handoff) ──────────────────────────────────────────────
|
|
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_create_handoff_thread_routes_thread_create():
|
|
adapter, stub = _adapter()
|
|
stub.next_send_result = {"success": True} # unused; thread op has own arm
|
|
|
|
async def send_outbound(action, *, platform=None):
|
|
stub.sent.append(action)
|
|
stub.sent_platforms.append(platform)
|
|
return {"success": True, "thread_id": "th77"}
|
|
|
|
stub.send_outbound = send_outbound # type: ignore[method-assign]
|
|
thread_id = await adapter.create_handoff_thread("chan1", "fix the build")
|
|
assert thread_id == "th77"
|
|
action = stub.sent[-1]
|
|
assert action["op"] == "thread_create"
|
|
assert action["chat_id"] == "chan1"
|
|
assert action["thread_name"] == "fix the build"
|
|
|
|
|
|
# ── rename_thread (semantic rename) ──────────────────────────────────────
|
|
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_rename_thread_carries_the_no_clobber_guard():
|
|
adapter, stub = _adapter()
|
|
ok = await adapter.rename_thread(
|
|
"th1", "Fix the build", only_if_current_name="Hermes"
|
|
)
|
|
assert ok is True
|
|
action = stub.sent[-1]
|
|
assert action["op"] == "thread_rename"
|
|
assert action["message_id"] == "th1"
|
|
assert action["thread_name"] == "Fix the build"
|
|
assert action["only_if_current_name"] == "Hermes"
|
|
# chat_id defaults to the thread id (Discord ignores it; Telegram callers
|
|
# pass parent_chat_id explicitly).
|
|
assert action["chat_id"] == "th1"
|
|
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_rename_thread_parent_chat_and_gating():
|
|
adapter, stub = _adapter()
|
|
await adapter.rename_thread("42", "topic", parent_chat_id="-100999")
|
|
assert stub.sent[-1]["chat_id"] == "-100999"
|
|
assert "only_if_current_name" not in stub.sent[-1]
|
|
|
|
gated, gated_stub = _adapter(supported_ops=("send",))
|
|
assert await gated.rename_thread("42", "x") is False
|
|
assert gated_stub.sent == []
|
|
|
|
|
|
# ── the relay semantic-rename lane (marker parity) ───────────────────────
|
|
|
|
|
|
# ── reply_to wire parse ──────────────────────────────────────────────────
|
|
|
|
|
|
def test_event_from_wire_reply_to_absent_and_partial():
|
|
plain = _event_from_wire(
|
|
{
|
|
"text": "hi",
|
|
"message_type": "text",
|
|
"source": {"platform": "telegram", "chat_id": "5", "chat_type": "dm"},
|
|
}
|
|
)
|
|
assert plain.reply_to_text is None
|
|
assert plain.reply_to_is_own_message is False
|
|
partial = _event_from_wire(
|
|
{
|
|
"text": "re",
|
|
"message_type": "text",
|
|
"source": {"platform": "whatsapp", "chat_id": "1", "chat_type": "dm"},
|
|
"reply_to_message_id": "wamid.x",
|
|
"reply_to": {"author": "Alice"}, # text leg missed the cache
|
|
}
|
|
)
|
|
assert partial.reply_to_author_name == "Alice"
|
|
assert partial.reply_to_text is None
|
|
|
|
|
|
# ── hello command manifest ───────────────────────────────────────────────
|
|
|
|
|
|
|
|
|
|
# ── auto-thread routing feedback (send-result thread_id) ─────────────────
|
|
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_send_captures_auto_thread_feedback():
|
|
"""A send result carrying thread_id + auto_thread_name (the connector's
|
|
auto-thread egress policy routed the reply into a thread it created)
|
|
populates auto_thread_info_for_chat for the semantic-rename lane."""
|
|
adapter, stub = _adapter()
|
|
|
|
async def send_outbound(action, *, platform=None):
|
|
stub.sent.append(action)
|
|
return {
|
|
"success": True,
|
|
"message_id": "m1",
|
|
"thread_id": "th-auto-1",
|
|
"auto_thread_name": "What is a duck",
|
|
}
|
|
|
|
stub.send_outbound = send_outbound # type: ignore[method-assign]
|
|
result = await adapter.send("chan1", "quack")
|
|
assert result.success
|
|
assert adapter.auto_thread_info_for_chat("chan1") == (
|
|
"th-auto-1",
|
|
"What is a duck",
|
|
)
|
|
# Plain results (no auto-thread) leave no feedback for other chats.
|
|
assert adapter.auto_thread_info_for_chat("chan-other") is None
|
|
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_send_without_thread_feedback_leaves_no_info():
|
|
adapter, stub = _adapter()
|
|
|
|
async def send_outbound(action, *, platform=None):
|
|
return {"success": True, "message_id": "m2"}
|
|
|
|
stub.send_outbound = send_outbound # type: ignore[method-assign]
|
|
await adapter.send("chan2", "hello")
|
|
assert adapter.auto_thread_info_for_chat("chan2") is None
|
|
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_auto_thread_feedback_is_bounded():
|
|
adapter, stub = _adapter()
|
|
|
|
async def send_outbound(action, *, platform=None):
|
|
return {
|
|
"success": True,
|
|
"message_id": "m",
|
|
"thread_id": f"th-{action['chat_id']}",
|
|
"auto_thread_name": "n",
|
|
}
|
|
|
|
stub.send_outbound = send_outbound # type: ignore[method-assign]
|
|
for i in range(300):
|
|
await adapter.send(f"c{i}", "x")
|
|
assert len(adapter._auto_thread_by_chat) <= 256
|
|
# Newest entries survive the bound.
|
|
assert adapter.auto_thread_info_for_chat("c299") == ("th-c299", "n")
|
|
|
|
|
|
# ── title-turn rename: registration shape-gate + fire-time cache poll ────
|
|
|
|
|
|
def _mk_runner_stub():
|
|
"""Minimal object carrying the three GatewayRunner methods under test."""
|
|
import asyncio as _asyncio
|
|
from gateway.run import GatewayRunner
|
|
|
|
class _Stub:
|
|
_is_relay_discord_channel_lane = GatewayRunner._is_relay_discord_channel_lane
|
|
_relay_auto_thread_info = GatewayRunner._relay_auto_thread_info
|
|
_is_discord_auto_thread_lane = GatewayRunner._is_discord_auto_thread_lane
|
|
_sanitize_discord_thread_title = GatewayRunner._sanitize_discord_thread_title
|
|
_rename_discord_auto_thread_for_session_title = (
|
|
GatewayRunner._rename_discord_auto_thread_for_session_title
|
|
)
|
|
|
|
def __init__(self, adapter):
|
|
self.adapters = {Platform.RELAY: adapter}
|
|
|
|
def _adapter_for_source(self, source):
|
|
return self.adapters.get(Platform.RELAY)
|
|
|
|
return _Stub
|
|
|
|
|
|
def _relay_channel_source():
|
|
from types import SimpleNamespace
|
|
|
|
return SimpleNamespace(
|
|
platform=Platform.DISCORD,
|
|
chat_id="chan-parent",
|
|
chat_type="group",
|
|
thread_id=None,
|
|
delivered_via_upstream_relay=True,
|
|
auto_thread_created=False,
|
|
auto_thread_initial_name=None,
|
|
)
|
|
|
|
|
|
def test_relay_channel_lane_shape_gate():
|
|
from types import SimpleNamespace
|
|
from gateway.config import Platform as P
|
|
|
|
stub = _mk_runner_stub()(adapter=None)
|
|
src = _relay_channel_source()
|
|
assert stub._is_relay_discord_channel_lane(src) is True
|
|
# thread events, DMs, and native (non-relay) events do not match
|
|
assert (
|
|
stub._is_relay_discord_channel_lane(
|
|
SimpleNamespace(**{**src.__dict__, "thread_id": "t1"})
|
|
)
|
|
is False
|
|
)
|
|
assert (
|
|
stub._is_relay_discord_channel_lane(
|
|
SimpleNamespace(**{**src.__dict__, "chat_type": "dm"})
|
|
)
|
|
is False
|
|
)
|
|
assert (
|
|
stub._is_relay_discord_channel_lane(
|
|
SimpleNamespace(**{**src.__dict__, "delivered_via_upstream_relay": False})
|
|
)
|
|
is False
|
|
)
|
|
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_title_rename_polls_feedback_that_arrives_late():
|
|
"""The auto-title races delivery: feedback lands AFTER the rename lane
|
|
starts. The lane must poll the adapter cache and still rename."""
|
|
import asyncio
|
|
|
|
adapter, stub_conn = _adapter()
|
|
renames: list = []
|
|
|
|
async def rename_thread(thread_id, name, *, only_if_current_name=None, parent_chat_id=None):
|
|
renames.append((thread_id, name, only_if_current_name))
|
|
return True
|
|
|
|
adapter.rename_thread = rename_thread # type: ignore[method-assign]
|
|
runner = _mk_runner_stub()(adapter)
|
|
src = _relay_channel_source()
|
|
|
|
async def land_feedback_late():
|
|
await asyncio.sleep(0.7) # past the first poll tick
|
|
adapter._auto_thread_by_chat["chan-parent"] = ("th-9", "Initial words")
|
|
|
|
task = asyncio.create_task(land_feedback_late())
|
|
await runner._rename_discord_auto_thread_for_session_title(
|
|
src, "sess1", "Debugging the flux capacitor"
|
|
)
|
|
await task
|
|
assert renames == [("th-9", "Debugging the flux capacitor", "Initial words")]
|
|
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_title_rename_true_miss_noops(monkeypatch):
|
|
"""No feedback ever arrives (connector didn't auto-thread): no rename."""
|
|
import gateway.run as run_mod
|
|
|
|
adapter, _ = _adapter()
|
|
renames: list = []
|
|
|
|
async def rename_thread(thread_id, name, **kw):
|
|
renames.append(thread_id)
|
|
return True
|
|
|
|
adapter.rename_thread = rename_thread # type: ignore[method-assign]
|
|
runner = _mk_runner_stub()(adapter)
|
|
src = _relay_channel_source()
|
|
# Shrink the poll loop for test speed: 20 ticks of 0.5s -> patch sleep.
|
|
orig_sleep = run_mod.asyncio.sleep
|
|
|
|
async def fast_sleep(_s):
|
|
await orig_sleep(0)
|
|
|
|
monkeypatch.setattr(run_mod.asyncio, "sleep", fast_sleep)
|
|
await runner._rename_discord_auto_thread_for_session_title(
|
|
src, "sess1", "A title"
|
|
)
|
|
assert renames == []
|