`gj \dZddlmZddlZddlmZmZdZedGdd Zy) uCapabilityDescriptor — the relay handshake payload. EXPERIMENTAL. The connector hands a ``CapabilityDescriptor`` to the gateway's ``RelayAdapter`` at handshake time; it tells the adapter which platform it is fronting and which capabilities to advertise to the ``GatewayStreamConsumer`` (char limit, draft-streaming, edit/threading support, markdown dialect, length unit). It is the linchpin of the generalization: one gateway adapter serves Discord, Telegram, Matrix, Signal, ... without per-platform branching. EXPERIMENTAL: this schema MAY CHANGE without a deprecation cycle until at least two real Class-1 platforms have validated it. Evolution during the experimental phase is additive-only, gated by ``contract_version`` (see docs/relay-connector-contract.md). Field origins (most are a wire-serializable projection of ``PlatformEntry`` plus the per-instance capability methods on ``BasePlatformAdapter``): - ``max_message_length`` -> ``PlatformEntry.max_message_length`` / adapter ``MAX_MESSAGE_LENGTH`` attribute (read by stream_consumer). - ``len_unit`` -> selects which ``message_len_fn`` the adapter installs ("chars" = builtin len; "utf16" = Telegram-style UTF-16 code-unit counting). - ``supports_draft_streaming`` -> adapter ``supports_draft_streaming()`` probe. - ``supports_edit`` -> whether edit-based streaming is possible (Discord/ Telegram yes; Signal/SMS no -> consumer degrades to one-message-per-segment). - ``supports_threads`` -> ``create_handoff_thread`` capability flag. - ``markdown_dialect`` -> presentation hint (e.g. "markdown_v2", "discord"). - ``emoji`` / ``platform_hint`` / ``pii_safe`` -> ``PlatformEntry`` fields of the same name. ) annotationsN)asdict dataclassT)frozenceZdZUdZded<ded<ded<ded<ded <ded <ded <ded <ded <dZded<dZded<dZded<dZded<ddZ e ddZ e dddddd ddZ y) CapabilityDescriptoruImmutable capability descriptor negotiated at relay handshake. Frozen so a descriptor cannot be mutated after handshake — the adapter advertises a fixed capability profile for the life of the connection. intcontract_versionstrplatformlabelmax_message_lengthboolsupports_draft_streaming supports_editsupports_threadsmarkdown_dialectlen_unit🔌emoji platform_hintFpii_safesupports_contextcDtjt|ddS)zCSerialize to a compact, stable JSON string for the handshake frame.TF) sort_keys ensure_ascii)jsondumpsr)selfs K/root/.hermes/venv/lib/python3.12/site-packages/gateway/relay/descriptor.pyto_jsonzCapabilityDescriptor.to_jsonDszz&,$UKKc>tj|}|jDchc]}|}}|jDcic] \}}||vs ||}}}d|vr t |ddkrd|d<|di|Scc}wcc}}w#t t f$rd|d<Y)wxYw)zDeserialize from a handshake JSON string. Unknown keys are ignored (forward-compat: a newer connector may send fields this gateway does not know yet); missing optional keys fall back to dataclass defaults. rr)rloads__dataclass_fields__itemsr TypeError ValueError)clsdatarawfknownkvfiltereds r" from_jsonzCapabilityDescriptor.from_jsonHsjj445q55%(YY[?TQAJAqD?? 8 + 6x 456!;59H12X6?z* 615-. 6s# A: A?A?BBBcharsTplain)rrrrrct|ddxsd}|t|j|j||||||t|ddt|ddt|dd  S) u:Project a ``gateway.platform_registry.PlatformEntry`` into a descriptor. Demonstrates the descriptor is a *subset/projection* of what ``PlatformEntry`` already encodes, not a parallel concept: ``label``, ``max_message_length``, ``emoji``, ``platform_hint``, ``pii_safe`` and the platform name come straight off the entry. The runtime capability bits that ``PlatformEntry`` does NOT encode (length unit, draft/edit/ thread/markdown behavior) are supplied by the caller — in production the connector fills these from the live adapter's capability methods. ``max_message_length`` of 0 on a ``PlatformEntry`` means "no limit"; we map that to the stream_consumer default of 4096 so the descriptor always carries a concrete chunking bound. rrr&rrrrrF) r r rrrrrrrrrr)getattrCONTRACT_VERSIONnamer)r-entryrrrrrmax_lens r"from_platform_entryz(CapabilityDescriptor.from_platform_entrybsl2%!5q9AT-ZZ++&%='--%,7!%"=UJ6  r$N)returnr )r.r r?'CapabilityDescriptor') rr rrrrrrrr r?r@) __name__ __module__ __qualname____doc____annotations__rrrrr# classmethodr5r>r'r$r"r r )s M J""ME3M3Hd #d"L2  )."!& '&  & #' &  & & &  & & r$r ) rD __future__rr dataclassesrrr:r r'r$r"rIs><# ) $_ _ _ r$