$REF sibilings violation [BUG]

[DennisvDijk]

API Spec link

https://github.com/Azure/azure-rest-api-specs/blob/main/specification/cognitiveservices/data-plane/AzureOpenAI/inference/stable/2024-10-21/inference.json

API Spec version

2024-10-21

Describe the bug

When we try to lint this specific release, the linter (both Spectral & Vacuum) returns a no-$ref-siblings rule violation. Indicating that at line 1351, there is a sibling amongst a ref which is displayed below.

              "parallel_tool_calls": {
                "$ref": "#/components/schemas/ParallelToolCalls",
                "nullable": true
              },

We're aware that Autorest has performed lints for these specs but I'm wondering whether or not these errors we're also triggered.

Expected behavior

Since the spec is 3.0, not 3.1, ref rules are still applied. We expect a oneOf block or some sort to fix this issue.

Please see: https://meta.stoplight.io/docs/spectral/4dec24461f3af-open-api-rules#no-ref-siblings.

Actual behavior

Linting errors:

inference.json:1352:17 | error    | a `$ref` cannot be placed next to any other properties                                               | no-$ref-siblings           | Schemas              | $.components.schemas['ParallelToolCalls']

Reproduction Steps

Download Vacuum or Spectral cli (or any other spec linter) and run XXXXX lint inference.json | grep error to explicitly return error logs. .

Environment

No response

[v-jiaodi]

@yetamsft Please help take a look, thanks.