Management resource envelope

All Management kinds share this envelope:

uid: 65a2cb59-b2df-48c7-bcc5-78af8510ba5b
apiVersion: agentstration.io/v1
kind: Agent
metadata:
  name: sql-expert
  tags:
    domain: data
  annotations:
    owner: platform
definition: {}

uid is generated by the server and cannot change. kind is an extensible string, not an enum in the external contract. metadata.name is unique for the kind inside the current workspace. Tags select and classify; annotations carry non-selective descriptive metadata.

References use { name, workspaceRef? }. Local references omit workspaceRef; cross-workspace resolution is explicit and is rejected until an installation enables it.

JSON and YAML manifests use the same field names and round-trip through ResourceManifestSerializer.