airbyte-agent-amazon-ads 0.1.25__tar.gz → 0.1.27__tar.gz

{airbyte_agent_amazon_ads-0.1.25 → airbyte_agent_amazon_ads-0.1.27}/AUTH.md

@@ -15,8 +15,8 @@ In open source mode, you provide API credentials directly to the connector.
 
 | Field Name | Type | Required | Description |
 |------------|------|----------|-------------|
-| `client_id` | `str` | Yes | The client ID of your Amazon Ads API application |
-| `client_secret` | `str` | Yes | The client secret of your Amazon Ads API application |
+| `client_id` | `str` | No | The client ID of your Amazon Ads API application |
+| `client_secret` | `str` | No | The client secret of your Amazon Ads API application |
 | `refresh_token` | `str` | Yes | The refresh token obtained from the OAuth authorization flow |
 
 Example request:
@@ -49,8 +49,8 @@ Create a connector with OAuth credentials.
 
 | Field Name | Type | Required | Description |
 |------------|------|----------|-------------|
-| `client_id` | `str` | Yes | The client ID of your Amazon Ads API application |
-| `client_secret` | `str` | Yes | The client secret of your Amazon Ads API application |
+| `client_id` | `str` | No | The client ID of your Amazon Ads API application |
+| `client_secret` | `str` | No | The client secret of your Amazon Ads API application |
 | `refresh_token` | `str` | Yes | The refresh token obtained from the OAuth authorization flow |
 
 Example request:
@@ -71,6 +71,59 @@ curl -X POST "https://api.airbyte.ai/v1/integrations/connectors" \
   }'
 ```
 
+
+
+#### Bring your own OAuth flow
+To implement your own OAuth flow, use Airbyte's server-side OAuth API endpoints. For a complete guide, see [Implement your own OAuth flow](https://docs.airbyte.com/ai-agents/quickstarts/tutorial-server-side-oauth).
+
+**Step 1: Initiate the OAuth flow**
+
+Request a consent URL for your user.
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `external_user_id` | `string` | Yes | Your unique identifier for the end user |
+| `connector_type` | `string` | Yes | The connector type (e.g., "Amazon-Ads") |
+| `redirect_url` | `string` | Yes | URL to redirect to after OAuth authorization |
+
+Example request:
+
+```bash
+curl -X POST "https://api.airbyte.ai/v1/integrations/connectors/oauth/initiate" \
+  -H "Authorization: Bearer <BEARER_TOKEN>" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "external_user_id": "<EXTERNAL_USER_ID>",
+    "connector_type": "Amazon-Ads",
+    "redirect_url": "https://yourapp.com/oauth/callback"
+  }'
+```
+
+Redirect your user to the `consent_url` from the response. After they authorize, they'll be redirected back to your app with a `secret_id` query parameter.
+
+**Step 2: Create a connector with the secret ID**
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `external_user_id` | `string` | Yes | Your unique identifier for the end user |
+| `connector_type` | `string` | Yes | The connector type (e.g., "Amazon-Ads") |
+| `name` | `string` | Yes | A name for this connector instance |
+| `server_side_oauth_secret_id` | `string` | Yes | The secret_id from the OAuth callback |
+
+Example request:
+
+```bash
+curl -X POST "https://api.airbyte.ai/v1/integrations/connectors" \
+  -H "Authorization: Bearer <BEARER_TOKEN>" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "external_user_id": "<EXTERNAL_USER_ID>",
+    "connector_type": "Amazon-Ads",
+    "name": "My Amazon-Ads Connector",
+    "server_side_oauth_secret_id": "<secret_id_from_callback>"
+  }'
+```
+
 #### Token
 This authentication method isn't available for this connector.
 

{airbyte_agent_amazon_ads-0.1.25 → airbyte_agent_amazon_ads-0.1.27}/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Amazon Ads changelog
 
+## [0.1.27] - 2026-02-03
+- Updated connector definition (YAML version 1.0.6)
+- Source commit: 888d0538
+- SDK version: 0.1.0
+
+## [0.1.26] - 2026-02-02
+- Updated connector definition (YAML version 1.0.5)
+- Source commit: 94024675
+- SDK version: 0.1.0
+
 ## [0.1.25] - 2026-02-02
 - Updated connector definition (YAML version 1.0.5)
 - Source commit: 9d9866b0

{airbyte_agent_amazon_ads-0.1.25 → airbyte_agent_amazon_ads-0.1.27}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: airbyte-agent-amazon-ads
-Version: 0.1.25
+Version: 0.1.27
 Summary: Airbyte Amazon-Ads Connector for AI platforms
 Project-URL: Homepage, https://github.com/airbytehq/airbyte-agent-connectors
 Project-URL: Documentation, https://docs.airbyte.com/ai-agents/
@@ -135,7 +135,7 @@ See the official [Amazon-Ads API reference](https://advertising.amazon.com/API/d
 
 ## Version information
 
-- **Package version:** 0.1.25
-- **Connector version:** 1.0.5
-- **Generated with Connector SDK commit SHA:** 9d9866b0aae8c3494d04d34e193b9bd860bfc1c6
+- **Package version:** 0.1.27
+- **Connector version:** 1.0.6
+- **Generated with Connector SDK commit SHA:** 888d0538a17d95c6769f63dbad90e713de97c89b
 - **Changelog:** [View changelog](https://github.com/airbytehq/airbyte-agent-connectors/blob/main/connectors/amazon-ads/CHANGELOG.md)

{airbyte_agent_amazon_ads-0.1.25 → airbyte_agent_amazon_ads-0.1.27}/README.md

@@ -102,7 +102,7 @@ See the official [Amazon-Ads API reference](https://advertising.amazon.com/API/d
 
 ## Version information
 
-- **Package version:** 0.1.25
-- **Connector version:** 1.0.5
-- **Generated with Connector SDK commit SHA:** 9d9866b0aae8c3494d04d34e193b9bd860bfc1c6
+- **Package version:** 0.1.27
+- **Connector version:** 1.0.6
+- **Generated with Connector SDK commit SHA:** 888d0538a17d95c6769f63dbad90e713de97c89b
 - **Changelog:** [View changelog](https://github.com/airbytehq/airbyte-agent-connectors/blob/main/connectors/amazon-ads/CHANGELOG.md)

{airbyte_agent_amazon_ads-0.1.25 → airbyte_agent_amazon_ads-0.1.27}/airbyte_agent_amazon_ads/_vendored/connector_sdk/executor/local_executor.py

@@ -546,23 +546,25 @@ class LocalExecutor:
             return ExecutionResult(success=False, data={}, error=str(e))
 
     async def check(self) -> ExecutionResult:
-        """Perform a health check by running a lightweight list operation.
+        """Perform a health check by running a lightweight operation.
 
         Finds the operation marked with preferred_for_check=True, or falls back
-        to the first list operation. Executes it with limit=1 to verify
-        connectivity and credentials.
+        to the first list operation. Executes it to verify connectivity and credentials.
+        For list operations, uses limit=1 to minimize data transfer.
 
         Returns:
             ExecutionResult with data containing status, error, and checked operation details.
         """
         check_entity = None
         check_endpoint = None
+        check_action = None
 
-        # Look for preferred check operation
+        # Look for preferred check operation (can be any action type)
         for (ent_name, op_action), endpoint in self._operation_index.items():
             if getattr(endpoint, "preferred_for_check", False):
                 check_entity = ent_name
                 check_endpoint = endpoint
+                check_action = op_action
                 break
 
         # Fallback to first list operation
@@ -571,18 +573,19 @@ class LocalExecutor:
                 if op_action == Action.LIST:
                     check_entity = ent_name
                     check_endpoint = endpoint
+                    check_action = op_action
                     break
 
-        if check_endpoint is None or check_entity is None:
+        if check_endpoint is None or check_entity is None or check_action is None:
             return ExecutionResult(
                 success=True,
                 data={
                     "status": "skipped",
-                    "error": "No list operation available for health check",
+                    "error": "No operation available for health check",
                 },
             )
 
-        # Find the standard handler to execute the list operation
+        # Find the standard handler to execute the operation
         standard_handler = next(
             (h for h in self._operation_handlers if isinstance(h, _StandardOperationHandler)),
             None,
@@ -598,13 +601,15 @@ class LocalExecutor:
             )
 
         try:
-            await standard_handler.execute_operation(check_entity, Action.LIST, {"limit": 1})
+            # Use limit=1 for list operations to minimize data transfer
+            params = {"limit": 1} if check_action == Action.LIST else {}
+            await standard_handler.execute_operation(check_entity, check_action, params)
             return ExecutionResult(
                 success=True,
                 data={
                     "status": "healthy",
                     "checked_entity": check_entity,
-                    "checked_action": "list",
+                    "checked_action": check_action.value,
                 },
             )
         except Exception as e:
@@ -614,7 +619,7 @@ class LocalExecutor:
                     "status": "unhealthy",
                     "error": str(e),
                     "checked_entity": check_entity,
-                    "checked_action": "list",
+                    "checked_action": check_action.value,
                 },
                 error=str(e),
             )

{airbyte_agent_amazon_ads-0.1.25 → airbyte_agent_amazon_ads-0.1.27}/airbyte_agent_amazon_ads/_vendored/connector_sdk/schema/base.py

@@ -10,7 +10,7 @@ from enum import StrEnum
 from typing import Any, Dict
 from uuid import UUID
 
-from pydantic import BaseModel, ConfigDict, Field, field_validator
+from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator
 from pydantic_core import Url
 
 from .extensions import CacheConfig, ReplicationConfig, RetryConfig
@@ -210,3 +210,34 @@ class Server(BaseModel):
             raise ValueError("Server URL cannot be empty")
         # Allow both absolute URLs and relative paths
         return v
+
+    @model_validator(mode="after")
+    def validate_replication_environment_mapping(self) -> "Server":
+        """Validate that x-airbyte-replication-environment-mapping sources exist in variables.
+
+        For simple mappings like {"subdomain": "subdomain"}, the key is the source variable.
+        For transform mappings like {"domain": {"source": "subdomain", "format": "..."}},
+        the "source" field is the source variable.
+        """
+        env_mapping = self.x_airbyte_replication_environment_mapping
+        if not env_mapping or not self.variables:
+            return self
+
+        variable_names = set(self.variables.keys())
+
+        for env_key, mapping_value in env_mapping.items():
+            if isinstance(mapping_value, str):
+                source_var = env_key
+            elif isinstance(mapping_value, EnvironmentMappingTransform):
+                source_var = mapping_value.source
+            else:
+                continue
+
+            if source_var not in variable_names:
+                available = ", ".join(sorted(variable_names)) if variable_names else "(none)"
+                raise ValueError(
+                    f"x-airbyte-replication-environment-mapping: source variable '{source_var}' "
+                    f"not found in server variables. Available: {available}"
+                )
+
+        return self

{airbyte_agent_amazon_ads-0.1.25 → airbyte_agent_amazon_ads-0.1.27}/airbyte_agent_amazon_ads/_vendored/connector_sdk/schema/extensions.py

@@ -14,7 +14,7 @@ are implemented.
 
 from typing import Literal
 
-from pydantic import BaseModel, ConfigDict, Field
+from pydantic import BaseModel, ConfigDict, Field, model_validator
 
 
 class PaginationConfig(BaseModel):
@@ -252,6 +252,24 @@ class ReplicationConfig(BaseModel):
         description="Mapping from replication_config field names to source_config field names",
     )
 
+    @model_validator(mode="after")
+    def validate_replication_config_key_mapping(self) -> "ReplicationConfig":
+        """Validate that replication_config_key_mapping keys exist in properties.
+
+        The mapping is: {local_key: airbyte_path}
+        We validate that local_key exists in our properties.
+        """
+        if self.replication_config_key_mapping and self.properties:
+            property_names = set(self.properties.keys())
+            for local_key, airbyte_path in self.replication_config_key_mapping.items():
+                if local_key not in property_names:
+                    available = ", ".join(sorted(property_names)) if property_names else "(none)"
+                    raise ValueError(
+                        f"replication_config_key_mapping: local key '{local_key}' "
+                        f"(mapped to '{airbyte_path}') not found in properties. Available: {available}"
+                    )
+        return self
+
 
 class CacheConfig(BaseModel):
     """

{airbyte_agent_amazon_ads-0.1.25 → airbyte_agent_amazon_ads-0.1.27}/airbyte_agent_amazon_ads/_vendored/connector_sdk/schema/operations.py

@@ -90,9 +90,10 @@ class Operation(BaseModel):
         None,
         alias="x-airbyte-preferred-for-check",
         description=(
-            "Mark this list operation as the preferred operation for health checks. "
+            "Mark this operation as the preferred operation for health checks. "
             "When the CHECK action is executed, this operation will be used instead of "
-            "falling back to the first available list operation. Choose a lightweight, "
+            "falling back to the first available list operation. The operation's actual "
+            "action type (get, list, etc.) will be respected. Choose a lightweight, "
             "always-available endpoint (e.g., users, accounts)."
         ),
     )

{airbyte_agent_amazon_ads-0.1.25 → airbyte_agent_amazon_ads-0.1.27}/airbyte_agent_amazon_ads/_vendored/connector_sdk/schema/security.py

@@ -81,6 +81,21 @@ class AuthConfigOption(BaseModel):
         description="Mapping from source config paths (e.g., 'credentials.api_key') to auth config keys for direct connectors",
     )
 
+    @model_validator(mode="after")
+    def validate_replication_auth_key_mapping(self) -> "AuthConfigOption":
+        """Validate that replication_auth_key_mapping target keys exist in properties."""
+        if self.replication_auth_key_mapping and self.properties:
+            property_names = set(self.properties.keys())
+            for airbyte_path, our_key in self.replication_auth_key_mapping.items():
+                if our_key not in property_names:
+                    option_context = f"oneOf option '{self.title}'" if self.title else "oneOf option"
+                    available = ", ".join(sorted(property_names)) if property_names else "(none)"
+                    raise ValueError(
+                        f"replication_auth_key_mapping in {option_context}: target key '{our_key}' "
+                        f"(mapped from '{airbyte_path}') not found in properties. Available: {available}"
+                    )
+        return self
+
 
 class AirbyteAuthConfig(BaseModel):
     """
@@ -146,8 +161,30 @@ class AirbyteAuthConfig(BaseModel):
             if not self.auth_mapping:
                 raise ValueError("Single auth option must have auth_mapping")
 
+            # Validate replication_auth_key_mapping targets exist in properties
+            if self.replication_auth_key_mapping and self.properties:
+                self._validate_replication_auth_key_mapping(self.replication_auth_key_mapping, self.properties, context="x-airbyte-auth-config")
+
         return self
 
+    @staticmethod
+    def _validate_replication_auth_key_mapping(mapping: Dict[str, str], properties: Dict[str, AuthConfigFieldSpec], context: str) -> None:
+        """Validate that replication_auth_key_mapping target keys exist in properties.
+
+        Args:
+            mapping: The replication_auth_key_mapping dict (airbyte_path -> our_key)
+            properties: The properties dict from x-airbyte-auth-config
+            context: Context string for error messages
+        """
+        property_names = set(properties.keys())
+        for airbyte_path, our_key in mapping.items():
+            if our_key not in property_names:
+                available = ", ".join(sorted(property_names)) if property_names else "(none)"
+                raise ValueError(
+                    f"replication_auth_key_mapping in {context}: target key '{our_key}' "
+                    f"(mapped from '{airbyte_path}') not found in properties. Available: {available}"
+                )
+
 
 class SecurityScheme(BaseModel):
     """

{airbyte_agent_amazon_ads-0.1.25 → airbyte_agent_amazon_ads-0.1.27}/airbyte_agent_amazon_ads/_vendored/connector_sdk/types.py

@@ -239,7 +239,7 @@ class EndpointDefinition(BaseModel):
     # Health check support (Airbyte extension)
     preferred_for_check: bool = Field(
         False,
-        description="Mark this list operation as preferred for health checks (from x-airbyte-preferred-for-check extension)",
+        description="Mark this operation as preferred for health checks (from x-airbyte-preferred-for-check extension)",
     )
 
 

{airbyte_agent_amazon_ads-0.1.25 → airbyte_agent_amazon_ads-0.1.27}/airbyte_agent_amazon_ads/_vendored/connector_sdk/validation.py

@@ -959,7 +959,7 @@ def validate_connector_readiness(connector_dir: str | Path) -> Dict[str, Any]:
     if not has_preferred_check:
         readiness_warnings.append(
             "No operation has x-airbyte-preferred-for-check: true. "
-            "Add this extension to a lightweight list operation (e.g., users.list) "
+            "Add this extension to a lightweight operation (e.g., users.list or accounts.get) "
             "to enable reliable health checks."
         )
 

{airbyte_agent_amazon_ads-0.1.25 → airbyte_agent_amazon_ads-0.1.27}/airbyte_agent_amazon_ads/connector.py

@@ -93,7 +93,7 @@ class AmazonAdsConnector:
     """
 
     connector_name = "amazon-ads"
-    connector_version = "1.0.5"
+    connector_version = "1.0.6"
     vendored_sdk_version = "0.1.0"  # Version of vendored connector-sdk
 
     # Map of (entity, action) -> needs_envelope for envelope wrapping decision

{airbyte_agent_amazon_ads-0.1.25 → airbyte_agent_amazon_ads-0.1.27}/airbyte_agent_amazon_ads/connector_model.py

@@ -26,7 +26,7 @@ from uuid import (
 AmazonAdsConnectorModel: ConnectorModel = ConnectorModel(
     id=UUID('c6b0a29e-1da9-4512-9002-7bfd0cba2246'),
     name='amazon-ads',
-    version='1.0.5',
+    version='1.0.6',
     base_url='{region}',
     auth=AuthConfig(
         type=AuthType.OAUTH2,
@@ -39,7 +39,7 @@ AmazonAdsConnectorModel: ConnectorModel = ConnectorModel(
         user_config_spec=AirbyteAuthConfig(
             title='OAuth2 Authentication',
             type='object',
-            required=['client_id', 'client_secret', 'refresh_token'],
+            required=['refresh_token'],
             properties={
                 'client_id': AuthConfigFieldSpec(
                     title='Client ID',

{airbyte_agent_amazon_ads-0.1.25 → airbyte_agent_amazon_ads-0.1.27}/airbyte_agent_amazon_ads/models.py

@@ -9,6 +9,7 @@ from __future__ import annotations
 
 from pydantic import BaseModel, ConfigDict, Field
 from typing import TypeVar, Generic, Union, Any
+from typing import Optional
 
 # Authentication configuration
 
@@ -17,9 +18,9 @@ class AmazonAdsAuthConfig(BaseModel):
 
     model_config = ConfigDict(extra="forbid")
 
-    client_id: str
+    client_id: Optional[str] = None
     """The client ID of your Amazon Ads API application"""
-    client_secret: str
+    client_secret: Optional[str] = None
     """The client secret of your Amazon Ads API application"""
     refresh_token: str
     """The refresh token obtained from the OAuth authorization flow"""

{airbyte_agent_amazon_ads-0.1.25 → airbyte_agent_amazon_ads-0.1.27}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "airbyte-agent-amazon-ads"
-version = "0.1.25"
+version = "0.1.27"
 description = "Airbyte Amazon-Ads Connector for AI platforms"
 readme = "README.md"
 requires-python = ">=3.13"