Skip to content

Add TypeScript SDK capability manifest and compatibility matrix - #71754

Merged
jason810496 merged 2 commits into
apache:mainfrom
jason810496:ci/ts-sdk/compat-matrix
Aug 26, 2026
Merged

jason810496 merged 2 commits into
apache:mainfrom
jason810496:ci/ts-sdk/compat-matrix

Conversation

@jason810496

@jason810496 jason810496 commented Aug 18, 2026 •

Copy link
Copy Markdown
Member

Why

The TypeScript SDK needs a machine-readable declaration of its supported Language SDK capabilities.

What

  • Add the TypeScript SDK capability manifest.
  • Generate the compatibility matrix in the TypeScript SDK README.
  • Verify the declared supervisor schema version against the TypeScript runtime.

Was generative AI tooling used to co-author this PR?
  • Yes, with help from Claude Code (Opus 4.8) and Codex (GPT-5) following the guidelines

Comment thread ts-sdk/capabilities.yaml Outdated
Comment thread ts-sdk/capabilities.yaml Outdated
Co-authored-by: Phani Kumar <94376113+phanikumv@users.noreply.github.com>
@jason810496
jason810496 force-pushed the ci/ts-sdk/compat-matrix branch from b61b70a to ebc8f87 Compare August 26, 2026 04:30
@jason810496
jason810496 requested a review from phanikumv August 26, 2026 04:38

@amoghrajesh amoghrajesh left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good work on this one, one issue, otherwise LGTM

Comment thread scripts/ci/prek/update_ts_sdk_readme_matrix.py
read_ts_schema_version returned None both when capabilities.yaml disagreed
with the generated runtime constant and when the constant could not be read
at all, so a missing or renamed SUPERVISOR_API_VERSION sent the contributor
to capabilities.yaml, which cannot fix either case. The unreadable case now
names src/generated/supervisor.ts and the generator instead. Reading the file
also no longer raises when it is absent, so that path reaches the new message.

@jason810496 jason810496 left a comment •

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the review Phani and Amogh, I will merge this once the CI pass.

Comment thread scripts/ci/prek/update_ts_sdk_readme_matrix.py
@jason810496
jason810496 merged commit 906aab3 into apache:main Aug 26, 2026
96 checks passed
imrichardwu pushed a commit to imrichardwu/airflow that referenced this pull request Sep 11, 2026
…he#71754)

* Add TypeScript SDK capability manifest and compatibility matrix

Co-authored-by: Phani Kumar <94376113+phanikumv@users.noreply.github.com>

* Report a missing TypeScript supervisor schema constant separately

read_ts_schema_version returned None both when capabilities.yaml disagreed
with the generated runtime constant and when the constant could not be read
at all, so a missing or renamed SUPERVISOR_API_VERSION sent the contributor
to capabilities.yaml, which cannot fix either case. The unreadable case now
names src/generated/supervisor.ts and the generator instead. Reading the file
also no longer raises when it is absent, so that path reaches the new message.

---------

Co-authored-by: Phani Kumar <94376113+phanikumv@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants