feat: Add metadata models package with dynamic schema download

.pre-commit-config.yaml

@@ -21,7 +21,10 @@ exclude: |
     ^.*?/build/.*$|
     ^.*?/dist/.*$|
     ^.*?/\.coverage$|
-    ^.*?/coverage\.xml$
+    ^.*?/coverage\.xml$|
+
+    ^airbyte_cdk/sources/declarative/models/declarative_component_schema\.py$|
+    ^airbyte_cdk/test/models/connector_metadata/generated/models\.py$
   )
 
 repos:

airbyte_cdk/test/models/__init__.py

@@ -1,10 +1,16 @@
 # Copyright (c) 2025 Airbyte, Inc., all rights reserved.
 """Models used for standard tests."""
 
+from airbyte_cdk.test.models.connector_metadata import (
+    ConnectorMetadataDefinitionV0,
+    ConnectorTestSuiteOptions,
+)
 from airbyte_cdk.test.models.outcome import ExpectedOutcome
 from airbyte_cdk.test.models.scenario import ConnectorTestScenario
 
 __all__ = [
+    "ConnectorMetadataDefinitionV0",
     "ConnectorTestScenario",
+    "ConnectorTestSuiteOptions",
     "ExpectedOutcome",
 ]

airbyte_cdk/test/models/connector_metadata/__init__.py

@@ -0,0 +1,24 @@
+"""Pydantic and JSON Schema models for `metadata.yaml` validation and testing.
+
+## Usage
+
+```python
+from airbyte_cdk.test.models import ConnectorMetadataDefinitionV0
+import yaml
+
+metadata = ConnectorMetadataDefinitionV0(**yaml.safe_load(metadata_yaml))
+```
+
+## Regenerating Models
+
+These models are auto-generated from JSON schemas in the airbytehq/airbyte repository.
+For information on regenerating these models, see the Contributing Guide:
+https://github.com/airbytehq/airbyte-python-cdk/blob/main/docs/CONTRIBUTING.md#regenerating-connector-metadata-models
+"""
+
+from .generated.models import ConnectorMetadataDefinitionV0, ConnectorTestSuiteOptions
+
+__all__ = [
+    "ConnectorMetadataDefinitionV0",
+    "ConnectorTestSuiteOptions",
+]