fix(workflow): use $sourceDescriptions for workflow references

[harshit078]

What/Why/How?

• Added support for the Arazzo workflow reference form $sourceDescriptions.<name>.<workflowId>.
• The previous $sourceDescriptions.<name>.workflows.<workflowId> form is still maintained.

Reference

#2826

Testing

Screenshots (optional)

Check yourself

• This PR follows the contributing guide
• All new/updated code is covered by tests
• Core code changed? - Tested with other Redocly products (internal contributions only)
• New package installed? - Tested in different environments (browser/node)
• Documentation update has been considered

Security

• The security impact of the change has been considered
• Code follows company security practices and guidelines

---

Note

Low Risk
Localized change to context path parsing with backward compatibility and broad test updates; no auth or data-layer impact.

Overview
Adds Arazzo-compliant external workflow references as $sourceDescriptions.<name>.<workflowId> (without a .workflows. segment) in get-value-from-context resolution, so Respect can resolve referenced workflows the way the spec describes.

The older $sourceDescriptions.<name>.workflows.<workflowId> syntax still works. For the spec form, if the third segment is not a matching workflowId, resolution falls back to a property on the source description (e.g. $sourceDescriptions.test.url).

Tests and flow-runner examples were updated to the spec form, with explicit coverage for legacy paths and spec fallbacks.

^{Reviewed by Cursor Bugbot for commit d692b6c. Bugbot is set up for automated code reviews on this repo. Configure here.}

[changeset-bot]

🦋 Changeset detected

Latest commit: d692b6c

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 3 packages

Name	Type
@redocly/respect-core	Patch
@redocly/cli	Patch
@redocly/openapi-core	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[harshit078]

Hi @DmitryAnansky , Can you review the PR and check it ? Thanks !

[github-actions]

Performance Benchmark (Lower is Faster)

CLI Version	Bundle	Lint	Check Config
cli-latest	▓ 1.00x ± 0.02	▓ 1.00x ± 0.01	▓ 1.00x (Fastest)
cli-next	▓ 1.00x (Fastest)	▓ 1.00x (Fastest)	▓ 1.01x ± 0.01

[DmitryAnansky]

Probably we need to handle case with

    if (isLegacyForm) {
      return undefined;
    }

[DmitryAnansky]

Could you please update existing tests to use correct and not legacy format?

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 658bf13. Configure here.}