Skip to content

Conversation

@backkem
Copy link
Contributor

@backkem backkem commented Jan 28, 2026

Summary

Moves agent-info message definitions and metadata discovery from the application protocol to the network protocol,
establishing clearer separation of concerns.

Motivation

Addresses #346: The spec currently links DNS-SD instance names with agent-info for consistency checking, creating
tight coupling between discovery and application layers. Since agent-info can be exchanged before authentication
completes, protocol implementations need the network layer to control this exchange to maintain security boundaries.

By making agent-info a network protocol message, the DNS-SD/agent-info coordination becomes internal to the network
spec rather than a cross-spec dependency.

Also partially relates to #343 by moving agent-status (connection keep-alive) to the network protocol as it seems
better suited for transport-specific details.

Changes

Network protocol (network.bs):

  • Add Metadata Discovery section with agent-info message definition
  • Add pre-auth message restrictions and abuse protection guidance
  • Add Connection Keep-Alive section with agent-status messages
  • Add Capabilities Registry mechanism

Application protocol (application.bs):

  • Reference network spec for agent-info mechanism
  • Keep capability value definitions (receive-audio, receive-video, etc.)

CDDL:

  • Move agent-info-*, agent-status-*, request, response to network_messages.cddl
  • Keep agent-capability enum in application_messages.cddl

- Move agent-info, agent-status messages and CDDL to network spec
- Add pre-auth message restrictions and abuse protection guidance
- Keep capability value definitions (receive-audio, etc.) in application spec
- Resolve Issue(346) by making agent-info a network-level message
@backkem backkem requested a review from markafoltz January 28, 2026 18:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant