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