Narrow execution-surface contract for process placement and runtime routing.
@type t() :: %ExecutionPlane.Placements.Surface{ boundary_class: String.t() | atom() | nil, contract_version: String.t(), lease_ref: String.t() | nil, observability: map(), surface_kind: String.t(), surface_ref: String.t() | nil, target_id: String.t() | nil, transport_options: map() }
@spec capabilities(String.t() | atom() | map() | keyword() | t() | nil) :: {:ok, ExecutionPlane.Placements.Capabilities.t()} | {:error, term()}
@spec contract_version() :: String.t()
@spec new(map() | keyword() | t()) :: {:ok, t()} | {:error, term()}
@spec new!(map() | keyword() | t()) :: t()
@spec nonlocal_path_surface?(String.t() | atom() | map() | keyword() | t() | nil) :: boolean()
@spec path_semantics(String.t() | atom() | map() | keyword() | t() | nil) :: :local | :remote | :guest | nil
@spec placement_family(String.t() | atom() | map() | keyword() | t() | nil) :: String.t() | nil
@spec remote_surface?(String.t() | atom() | map() | keyword() | t() | nil) :: boolean()
@spec supported_surface_kinds() :: [String.t(), ...]
@spec to_map(t()) :: map()