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.0
x-speakeasy-jsonpath: rfc9535  # Required: switches from legacy to RFC 9535 parser

actions:
  - target: "$.components.schemas[?search(@~, '^source-')]"
    update:
      deprecated: true
      x-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-bot Bot and 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 deprecated Jun 23, 2026

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

Copilot AI 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 deprecated Jun 23, 2026

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

devin-ai-integration Bot reviewed Jun 23, 2026

View reviewed changes

Comment thread gen.yaml Outdated

Copilot AI reviewed Jun 23, 2026

ci: trigger CI checks after SDK regeneration

0248b26

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

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

ci: retrigger CI with corrected PR title

a19efd9

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

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

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

Aaron ("AJ") Steers (aaronsteers) changed the title ~~chore: test wildcard JSONPath for deprecating connector schemas~~ chore!: Deprecate connector schemas Jun 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-integration Bot closed this Jun 23, 2026

devin-ai-integration Bot reopened this Jun 23, 2026

devin-ai-integration Bot and 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 Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Uh oh!

devin-ai-integration Bot commented Jun 23, 2026

🤖 Devin AI Engineer

Uh oh!

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

Uh oh!

Uh oh!

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

Uh oh!

Uh oh!

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

Uh oh!

Uh oh!

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

Uh oh!

Uh oh!

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

Uh oh!

Uh oh!

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

Uh oh!

Uh oh!

devin-ai-integration Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

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

Uh oh!

Uh oh!

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

Uh oh!

Uh oh!

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

Uh oh!

Uh oh!

octavia-bot Bot 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!

2 participants

Aaron ("AJ") Steers (aaronsteers) commented Jun 23, 2026 •

edited by devin-ai-integration Bot

Loading

octavia-bot Bot commented Jun 23, 2026 •

edited

Loading

github-actions Bot commented Jun 23, 2026 •

edited

Loading

octavia-bot Bot commented Jun 23, 2026 •

edited

Loading

octavia-bot Bot commented Jun 23, 2026 •

edited

Loading

octavia-bot Bot commented Jun 23, 2026 •

edited

Loading

octavia-bot Bot commented Jun 23, 2026 •

edited

Loading

octavia-bot Bot commented Jun 23, 2026 •

edited

Loading

octavia-bot Bot commented Jun 23, 2026 •

edited

Loading

octavia-bot Bot commented Jun 23, 2026 •

edited

Loading

octavia-bot Bot commented Jun 23, 2026 •

edited

Loading