Crate gestura_core_a2a 

Agent-to-Agent protocol types, client, and server for Gestura.

gestura-core-a2a implements Gestura’s A2A domain: a transport-agnostic JSON-RPC server model, an HTTP client for remote agents, and the typed task lifecycle/provenance structures needed for cross-agent delegation.

Main concepts

• A2AServer: protocol server that shells can expose over HTTP/SSE
• A2AClient: HTTP client for discovery, task creation, retries, status, and cancellation
• AgentCard / Skill: remote capability advertisement
• A2ATask, TaskStatus, RemoteTaskContract: typed remote-task lifecycle
• TaskProvenance / TaskAuditEvent: provenance and audit metadata

Architecture boundary

This crate owns protocol logic and domain types. Listener setup, shell transport hosting, and GUI/CLI presentation concerns remain in the shell crates that embed it.

Stable import paths

Most code should import through gestura_core::a2a::*.

Structs

A2AClient

A2A HTTP Client for agent-to-agent communication

A2AError

A2A Error

A2AMessage

A2A Message

A2ARequest

A2A JSON-RPC Request

A2AResponse

A2A JSON-RPC Response

A2AServer

A2A server for handling incoming JSON-RPC requests.

A2ATask

A2A Task

A2ATaskEvent

Streamable task event payload.

AgentCard

Agent Card for A2A discovery

AgentCardRegistry

In-memory registry for discovered/known agent cards.

AgentProfile

Agent profile for authentication and identity propagation.

Artifact

Artifact produced by a task

ArtifactManifestEntry

Summary metadata for an artifact without its full payload.

AuthenticationInfo

Authentication info

CreateTaskRequest

Rich remote task create request.

OAuth2Config

OAuth2 configuration

ProfileStore

Profile store for managing agent profiles.

RemoteTaskContract

Structured contract shared with a remote worker.

RemoteTaskLease

Active lease state for a remote task.

RemoteTaskLeaseRequest

Requested lease semantics for a remote task.

RemoteTaskProgress

Progress snapshot reported by a remote worker.

Skill

Skill definition

TaskArtifactFetchRequest

Request to fetch a specific artifact for a task.

TaskAuditEvent

Audit entry recorded for task lifecycle changes.

TaskHeartbeatRequest

Heartbeat/update request for a remote task.

TaskProvenance

Remote provenance metadata for a task.

Enums

A2ATaskEventKind

Event emitted when an A2A task changes.

MessagePart

Message part (text, file, or data)

TaskStatus

Task status

Functions

create_gestura_agent_card

Create a default agent card for Gestura.

is_token_well_formed

Return whether a token is well-formed for Gestura’s current bearer-token scheme.