GroundService gRPC API

GroundService provides access to Ground's deferred news database. Plugins call this to surface attestations in Claude Code sessions via Ground.

Proto file: plugin/grpc/protocol/ground.proto

Service Methods

Method	Request	Response	Streaming
WriteToGround	WriteToGroundRequest	WriteToGroundResponse	No
ReadUndelivered	ReadUndeliveredRequest	ReadUndeliveredResponse	No

WriteToGround

WriteToGround inserts an attestation into Ground's SQLite database. Ground delivers these as deferred news on session Stop.

Request: WriteToGroundRequest
Response: WriteToGroundResponse

ReadUndelivered

ReadUndelivered returns the detail text from the most recent undelivered deferred message for a given predicate name and project context. Used by plugins to accumulate news across writes.

Request: ReadUndeliveredRequest
Response: ReadUndeliveredResponse

Message Types

WriteToGroundRequest

Field	Type	Description
auth_token	string	-
subjects	string	-
predicates	string	-
contexts	string	-
actors	string	-
attributes	google.protobuf.Struct	-
source	string	-

WriteToGroundResponse

Field	Type	Description
success	bool	-
error	string	-

ReadUndeliveredRequest

Field	Type	Description
auth_token	string	-
predicate_name	string	-
project_context	string	-

ReadUndeliveredResponse

Field	Type	Description
detail	string	-
error	string	-

← Back to API Index