gRPC: common

Shared messages of the Kyvernon native API (v1). Conventions: * Object ids are MoRef-compatible strings ("vm-42", "host-7"). * Timestamps are RFC 3339 strings in UTC with microsecond precision. * Typed record bodies travel as JSON (*_json fields) in v1; the schemas are published in docs/api/openapi.yaml. Dedicated protobuf messages exist where the operation itself is typed (power operations, tasks, agent).

Messages

`RecordMeta`

Store-maintained metadata of every record.

Field	Number	Type	Description
`id`	1	`string`	Id of the object (`vm-12`, `host-3`).
`uuid`	2	`string`	UUID of the object, stable for its lifetime.
`parent`	3	`string`	Id of the parent in the inventory tree; empty for a root.
`name`	4	`string`	Name of the object.
`version`	5	`uint64`	Store version of the last change; the expected version of a compare-and-set update.
`created_version`	6	`uint64`	Store version that created the object.
`created_at`	7	`string`	Creation time, RFC 3339.
`updated_at`	8	`string`	Time of the last change, RFC 3339.

`Object`

A record with its JSON body.

Field	Number	Type	Description
`meta`	1	`RecordMeta`	Identity, place and versions of the object.
`kind`	2	`string`	Object kind (for example `VirtualMachine`).
`data_json`	3	`string`	The kind-specific body as JSON, the same shape as in the REST API.

`PageRequest`

Pagination request; after is the id to resume after.

Field	Number	Type	Description
`limit`	1	`uint32`	Most items in one answer; 0 means the server default.
`after`	2	`string`	Cursor: the `next` of the previous page; empty for the first page.

`PageInfo`

Pagination response.

Field	Number	Type	Description
`version`	1	`uint64`	Store version the page was read at.
`next`	2	`string`	Cursor of the next page; empty on the last page.

`ErrorDetail`

Error details attached to gRPC status (also the REST envelope body).

Field	Number	Type	Description
`code`	1	`string`	Error code (`NOT_FOUND`, `FAILED_PRECONDITION`, ...).
`message`	2	`string`	English developer message.
`key`	3	`string`	Message id the console localises (`error.not_found`); empty when there is none.
`details`	4	map<`string`, `string`>	Arguments of the message id.
`correlation_id`	5	`string`	Correlation id of the request (the `x-request-id` metadata, or one the server chose).

`TaskRef`

Reference to a task created by a long-running operation.

Field	Number	Type	Description
`task_id`	1	`string`	Id of the task to poll or wait for.

`Empty`

No fields.