apiVersion: capsule.dev/v0.1
kind: Capsule
name: cverse-protobuf
version: 0.1.0
type: subsystem
purpose:
summary: 'Defines the gRPC service contracts and generates client/server stubs for
communication between the Go orchestration server and the Python inference services.
This capsule provides a standardized interface for AI capabilities.
'
owns:
- gRPC service definitions (.proto files)
- Generated Go protobuf code
- Generated Python protobuf code
does_not_own:
- The code that uses these interfaces (clients/servers)
- The build scripts for generating protobufs
interfaces:
provides:
- kind: library
name: go-grpc-stubs
description: Go client/server stubs for gRPC services.
- kind: library
name: python-grpc-stubs
description: Python client/server stubs for gRPC services.
agent:
summary_for_ai: 'This capsule defines the communication contracts. An agent working
on this capsule would focus on extending or modifying the .proto definitions and
regenerating the corresponding language-specific stubs.
'
avoid:
- Modifying generated code directly.
verification:
invariants:
- The .proto files must be valid Protobuf definitions.
- Generated code must accurately reflect the .proto definitions.
x-reuse:
notes: 'None. This capsule is highly reusable as it only contains interface definitions
and generated code.
'
x-reconstruct:
install: install.json