mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-06-22 10:32:00 +00:00
53d9b98305
Frozen, JSON-serializable handshake payload the connector hands the future RelayAdapter: char limit, draft-streaming/edit/threading flags, markdown dialect, len_unit. Mostly a wire projection of PlatformEntry + the adapter capability methods. contract_version gates additive-only evolution; declared EXPERIMENTAL until >=2 Class-1 platforms validate it. from_json ignores unknown keys (forward-compat) and fills optional defaults. Phase 0, Task 0.2 of the gateway-relay plan.
66 lines
2.2 KiB
Python
66 lines
2.2 KiB
Python
"""Tests for the experimental CapabilityDescriptor (relay Phase 0, Task 0.2)."""
|
|
|
|
from gateway.relay.descriptor import CONTRACT_VERSION, CapabilityDescriptor
|
|
|
|
|
|
def _telegram_descriptor(**overrides) -> CapabilityDescriptor:
|
|
base = dict(
|
|
contract_version=CONTRACT_VERSION,
|
|
platform="telegram",
|
|
label="Telegram",
|
|
max_message_length=4096,
|
|
supports_draft_streaming=False,
|
|
supports_edit=True,
|
|
supports_threads=True,
|
|
markdown_dialect="markdown_v2",
|
|
len_unit="utf16",
|
|
emoji="\u2708\ufe0f",
|
|
platform_hint="You are on Telegram.",
|
|
pii_safe=False,
|
|
)
|
|
base.update(overrides)
|
|
return CapabilityDescriptor(**base)
|
|
|
|
|
|
def test_descriptor_roundtrips_json():
|
|
d = _telegram_descriptor()
|
|
assert CapabilityDescriptor.from_json(d.to_json()) == d
|
|
|
|
|
|
def test_descriptor_is_frozen():
|
|
d = _telegram_descriptor()
|
|
try:
|
|
d.max_message_length = 1 # type: ignore[misc]
|
|
except Exception as exc: # FrozenInstanceError
|
|
assert "cannot assign" in str(exc) or "frozen" in str(exc).lower()
|
|
else: # pragma: no cover
|
|
raise AssertionError("descriptor should be immutable (frozen)")
|
|
|
|
|
|
def test_from_json_ignores_unknown_keys():
|
|
"""A newer connector may send fields this gateway doesn't know — those are
|
|
dropped, not fatal (forward-compat during the experimental phase)."""
|
|
d = _telegram_descriptor()
|
|
raw = d.to_json()[:-1] + ', "future_field": "ignored"}'
|
|
restored = CapabilityDescriptor.from_json(raw)
|
|
assert restored == d
|
|
|
|
|
|
def test_from_json_fills_optional_defaults():
|
|
"""Optional fields (emoji/platform_hint/pii_safe) fall back to defaults."""
|
|
minimal = (
|
|
'{"contract_version": 1, "platform": "x", "label": "X", '
|
|
'"max_message_length": 2000, "supports_draft_streaming": false, '
|
|
'"supports_edit": false, "supports_threads": false, '
|
|
'"markdown_dialect": "plain", "len_unit": "chars"}'
|
|
)
|
|
d = CapabilityDescriptor.from_json(minimal)
|
|
assert d.pii_safe is False
|
|
assert d.platform_hint == ""
|
|
assert d.emoji == "\U0001f50c"
|
|
|
|
|
|
def test_module_is_marked_experimental():
|
|
import gateway.relay.descriptor as m
|
|
|
|
assert "EXPERIMENTAL" in (m.__doc__ or "")
|