Skip to content

feat: introduce TransportProtocol validation #527

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
martimfasantos wants to merge 4 commits into from
Closed

feat: introduce TransportProtocol validation #527

Changes from 2 commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
dabd80e
feat: introduce TransportProtocol validation for AgentCard and AgentI…
martimfasantos Oct 31, 2025
09db309
formatting
martimfasantos Oct 31, 2025
c7182b1
fix: update TransportProtocol enum values to uppercase for Python con…
martimfasantos Oct 31, 2025
5ad16bd
Merge branch 'main' into feat-add-transport-type-validation
martimfasantos Nov 2, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 25 additions & 13 deletions src/a2a/types.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -93,13 +93,30 @@ class AgentExtension(A2ABaseModel):
"""


class TransportProtocol(str, Enum):
"""
Supported A2A transport protocols.
"""

jsonrpc = 'JSONRPC'
grpc = 'GRPC'
http_json = 'HTTP+JSON'
Comment thread
martimfasantos marked this conversation as resolved.
Outdated


class AgentInterface(A2ABaseModel):
"""
Declares a combination of a target URL and a transport protocol for interacting with the agent.
This allows agents to expose the same functionality over multiple transport mechanisms.
"""

transport: str = Field(..., examples=['JSONRPC', 'GRPC', 'HTTP+JSON'])
transport: TransportProtocol = Field(
...,
examples=[
TransportProtocol.jsonrpc,
TransportProtocol.grpc,
TransportProtocol.http_json,
],
Comment thread
martimfasantos marked this conversation as resolved.
)
"""
The transport protocol supported at this URL.
"""
Expand Down Expand Up @@ -1021,16 +1038,6 @@ class TextPart(A2ABaseModel):
"""


class TransportProtocol(str, Enum):
"""
Supported A2A transport protocols.
"""

jsonrpc = 'JSONRPC'
grpc = 'GRPC'
http_json = 'HTTP+JSON'


class UnsupportedOperationError(A2ABaseModel):
"""
An A2A-specific error indicating that the requested operation is not supported by the agent.
Expand Down Expand Up @@ -1774,8 +1781,13 @@ class AgentCard(A2ABaseModel):
"""
A human-readable name for the agent.
"""
preferred_transport: str | None = Field(
default='JSONRPC', examples=['JSONRPC', 'GRPC', 'HTTP+JSON']
preferred_transport: TransportProtocol | None = Field(
default=TransportProtocol.jsonrpc,
examples=[
TransportProtocol.jsonrpc,
TransportProtocol.grpc,
TransportProtocol.http_json,
Comment thread
martimfasantos marked this conversation as resolved.
Outdated
],
)
"""
The transport protocol for the preferred endpoint (the main 'url' field).
Expand Down
Loading