chore!: Deprecate connector schemas by aaronsteers · Pull Request #188 · airbytehq/airbyte-api-python-sdk

Aaron ("AJ") Steers (aaronsteers) · 2026-06-23T07:27:40Z

Summary

Research PR — confirms that Speakeasy overlays support wildcard JSONPath for bulk-deprecating all 600 connector schemas with just 2 overlay actions.

Working syntax:

overlay: 1.0.0x-speakeasy-jsonpath: rfc9535 # Required: switches from legacy to RFC 9535 parseractions:
- target: "$.components.schemas[?search(@~, '^source-')]"update:
deprecated: truex-speakeasy-deprecation-message: "..."

Where @~ is Speakeasy's PropertyNameExtension (accesses the schema key name) and search() does substring regex matching per RFC 9535.

Result: Speakeasy generates @deprecated from typing_extensions on both BaseModel and TypedDict connector classes — producing real DeprecationWarning at runtime, not just docstring annotations. 600 connector model files annotated, 0 core models affected.

Key pitfalls discovered:

match() does full-string match (match(@~, '^source-') matches nothing) — use search() instead
x-speakeasy-jsonpath: rfc9535 is required — overlay 1.0.0 defaults to legacy VMware Labs parser which lacks match()/search()/@~

Link to Devin session: https://app.devin.ai/sessions/1a9172f7c32f4aa2852da2423f44101a
Requested by: Aaron ("AJ") Steers (@aaronsteers)

…refix Co-Authored-By: AJ Steers <aj@airbyte.io>

devin-ai-integration · 2026-06-23T07:27:43Z

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

Disable automatic comment, CI, and merge conflict monitoring

octavia-bot · 2026-06-23T07:27:56Z

Generate SDK Job Info
Running Speakeasy SDK generation.

Job started... Check job output.
SDK generation failed. Check the job output for details.

…tion Try filtering schemas by content (existence of sourceType/destinationType properties) instead of by name prefix, since match() is not supported. Co-Authored-By: AJ Steers <aj@airbyte.io>

github-actions · 2026-06-23T07:32:52Z

Generated Code Drift Detected

The committed code does not match what the generation pipeline produces.

To fix: Comment /generate on this PR to regenerate.

 gen.yaml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)

octavia-bot · 2026-06-23T07:33:24Z

Generate SDK Job Info
Running Speakeasy SDK generation.

Job started... Check job output.
SDK generation completed successfully.

…ard matching Enable x-speakeasy-jsonpath: rfc9535 and use match(@~, '^source-') to regex-match schema names by prefix. The @~ extension accesses the property name of the current node in filter expressions. Co-Authored-By: AJ Steers <aj@airbyte.io>

octavia-bot · 2026-06-23T07:47:21Z

Generate SDK Job Info
Running Speakeasy SDK generation.

Job started... Check job output.
SDK generation completed successfully.

…hema names match() does full-string match per RFC 9535, so match(@~, '^source-') requires the entire name to be '^source-'. search() does substring match, so search(@~, '^source-') correctly finds names starting with 'source-'. Co-Authored-By: AJ Steers <aj@airbyte.io>

octavia-bot · 2026-06-23T07:53:24Z

Generate SDK Job Info
Running Speakeasy SDK generation.

Job started... Check job output.
SDK generation completed successfully.

octavia-bot · 2026-06-23T08:05:31Z

Generate SDK Job Info
Running Speakeasy SDK generation.

Job started... Check job output.
SDK generation completed successfully.

devin-ai-integration

Devin Review found 1 potential issue.

Copilot

Copilot wasn't able to review this pull request because it exceeds the maximum number of files (300). Try reducing the number of changed files and requesting a review from Copilot again.

Co-Authored-By: AJ Steers <aj@airbyte.io>

octavia-bot · 2026-06-23T08:22:30Z

Generate SDK Job Info
Running Speakeasy SDK generation.

Job started... Check job output.
SDK generation completed successfully.

Co-Authored-By: AJ Steers <aj@airbyte.io>

octavia-bot · 2026-06-23T18:58:36Z

Generate SDK Job Info
Running Speakeasy SDK generation.

Job started... Check job output.
SDK generation completed successfully.

Co-Authored-By: AJ Steers <aj@airbyte.io>

octavia-bot · 2026-06-23T19:05:14Z

Generate SDK Job Info
Running Speakeasy SDK generation.

Job started... Check job output.
SDK generation failed. Check the job output for details.

octavia-bot · 2026-06-23T19:08:28Z

Generate SDK Job Info
Running Speakeasy SDK generation.

Job started... Check job output.
SDK generation completed successfully.

Co-Authored-By: AJ Steers <aj@airbyte.io>

…ero-diff Co-Authored-By: AJ Steers <aj@airbyte.io>

feat: test wildcard JSONPath to deprecate connector schemas by name p…
acb6928
…refix Co-Authored-By: AJ Steers <aj@airbyte.io>

Aaron ("AJ") Steers (aaronsteers) self-assigned this Jun 23, 2026

feat: test content-based JSONPath filter for connector schema depreca…
e8d53fe
…tion Try filtering schemas by content (existence of sourceType/destinationType properties) instead of by name prefix, since match() is not supported. Co-Authored-By: AJ Steers <aj@airbyte.io>

octavia-botBotand others added 2 commits June 23, 2026 07:36

chore: regenerate SDK with Speakeasy
2158e3c

chore: regenerate SDK with Speakeasy
0f89ec4

Aaron ("AJ") Steers (aaronsteers) changed the title ~~Do not merge: test wildcard JSONPath for deprecating connector schemas~~chore!: mark typed connector models as deprecatedJun 23, 2026

Aaron ("AJ") Steers (aaronsteers) marked this pull request as ready for review June 23, 2026 08:04

CopilotAI review requested due to automatic review settings June 23, 2026 08:04

Aaron ("AJ") Steers (aaronsteers) changed the title ~~chore!: mark typed connector models as deprecated~~chore!: mark typed connector-specific models as deprecatedJun 23, 2026

Copilotstarted reviewing on behalf of Aaron ("AJ") Steers (aaronsteers)June 23, 2026 08:05 View session

devin-ai-integrationBot reviewed Jun 23, 2026
View reviewed changes

Comment threadgen.yaml Outdated

CopilotAI reviewed Jun 23, 2026

ci: trigger CI checks after SDK regeneration
0248b26
Co-Authored-By: AJ Steers <aj@airbyte.io>

devin-ai-integrationBot changed the title ~~chore!: mark typed connector-specific models as deprecated~~Do not merge: test wildcard JSONPath for deprecating connector schemasJun 23, 2026

ci: retrigger CI with corrected PR title
a19efd9
Co-Authored-By: AJ Steers <aj@airbyte.io>

devin-ai-integrationBot changed the title ~~Do not merge: test wildcard JSONPath for deprecating connector schemas~~chore: Do not merge - test wildcard JSONPath for deprecating connector schemasJun 23, 2026

devin-ai-integrationBot changed the title ~~chore: Do not merge - test wildcard JSONPath for deprecating connector schemas~~chore: test wildcard JSONPath for deprecating connector schemasJun 23, 2026

Aaron ("AJ") Steers (aaronsteers) changed the title ~~chore: test wildcard JSONPath for deprecating connector schemas~~chore!: Deprecate connector schemasJun 23, 2026

chore: set version to 2.0.0 for breaking change
bf43b5a
Co-Authored-By: AJ Steers <aj@airbyte.io>

ci: trigger CI checks
c2bc531
Co-Authored-By: AJ Steers <aj@airbyte.io>

devin-ai-integrationBot closed this Jun 23, 2026

devin-ai-integrationBot reopened this Jun 23, 2026

devin-ai-integrationBotand others added 5 commits June 23, 2026 19:27

ci: retrigger PR checks
12e4088
Co-Authored-By: AJ Steers <aj@airbyte.io>

ci: allow zero-diff check to run on workflow_dispatch
d53f748
Co-Authored-By: AJ Steers <aj@airbyte.io>

ci: remove version from gen.yaml and strip it after generation
ff41532
Co-Authored-By: AJ Steers <aj@airbyte.io>

Merge origin/main into devin/1782199589-test-wildcard-deprecation
c14f09d
Co-Authored-By: AJ Steers <aj@airbyte.io>

ci: replace version in gen.yaml with comment, exclude gen.yaml from z…
91a9b4d
…ero-diff Co-Authored-By: AJ Steers <aj@airbyte.io>

Uh oh!

Conversation

Aaron ("AJ") Steers (aaronsteers) commented Jun 23, 2026• edited by devin-ai-integration BotLoading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Uh oh!

devin-ai-integrationBot commented Jun 23, 2026

🤖 Devin AI Engineer

Uh oh!

octavia-botBot commented Jun 23, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actionsBot commented Jun 23, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

octavia-botBot commented Jun 23, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

octavia-botBot commented Jun 23, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

octavia-botBot commented Jun 23, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

octavia-botBot commented Jun 23, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

devin-ai-integrationBot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

CopilotAI left a comment

Choose a reason for hiding this comment

Uh oh!

octavia-botBot commented Jun 23, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

octavia-botBot commented Jun 23, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

octavia-botBot commented Jun 23, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

octavia-botBot commented Jun 23, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Aaron ("AJ") Steers (aaronsteers) commented Jun 23, 2026•
edited by devin-ai-integration Bot
Loading

octavia-botBot commented Jun 23, 2026•
edited
Loading

github-actionsBot commented Jun 23, 2026•
edited
Loading

octavia-botBot commented Jun 23, 2026•
edited
Loading

octavia-botBot commented Jun 23, 2026•
edited
Loading

octavia-botBot commented Jun 23, 2026•
edited
Loading

octavia-botBot commented Jun 23, 2026•
edited
Loading

octavia-botBot commented Jun 23, 2026•
edited
Loading

octavia-botBot commented Jun 23, 2026•
edited
Loading

octavia-botBot commented Jun 23, 2026•
edited
Loading

octavia-botBot commented Jun 23, 2026•
edited
Loading