proto — gRPC contract definitions for instanode.dev

The Protobuf/gRPC contracts that define the interface between the agent-facing API and the provisioning engine for instanode.dev — zero-friction developer infrastructure for AI agents: provision a real Postgres, pgvector, Redis, MongoDB, NATS queue, or S3 bucket (and deploy your app) with a single HTTP call. No account, no Docker, no setup. Free anonymous tier.

These .proto files are the source of truth for the api ↔ provisioner gRPC boundary:

• common/v1/types.proto — shared message types.
• provisioner/v1/provisioner.proto — the provisioning service (create/destroy real databases, caches, queues).

Generate

Code is generated with buf:

buf generate   # or: make generate
buf lint       # or: make lint

Never hand-write rawDesc — it panics on grpc-go v1.64+. Regenerate with buf after any .proto change, then rebuild the consuming services.

Related

• api — the agent-facing HTTP/gRPC API.
• mcp — MCP server so AI agents (Claude, Cursor, Copilot, Windsurf) call instanode as a tool.
• Live platform + docs: https://instanode.dev