airbyte-agent-amazon-ads 0.1.6__tar.gz → 0.1.11__tar.gz

{airbyte_agent_amazon_ads-0.1.6 → airbyte_agent_amazon_ads-0.1.11}/AUTH.md

@@ -69,13 +69,13 @@ After creating the connector, execute operations using either the Python SDK or
 from airbyte_agent_amazon-ads import AmazonAdsConnector
 
 connector = AmazonAdsConnector(
-    external_user_id="<your-scoped-token>",
+    external_user_id="<your_external_user_id>",
     airbyte_client_id="<your-client-id>",
     airbyte_client_secret="<your-client-secret>"
 )
 
 @agent.tool_plain # assumes you're using Pydantic AI
-@AmazonAdsConnector.describe
+@AmazonAdsConnector.tool_utils
 async def amazon-ads_execute(entity: str, action: str, params: dict | None = None):
     return await connector.execute(entity, action, params or {})
 ```
@@ -96,7 +96,7 @@ The Amazon-Ads connector requires the following configuration variables. These v
 
 | Variable | Type | Required | Default | Description |
 |----------|------|----------|---------|-------------|
-| `region_url` | `string` | Yes | https://advertising-api.amazon.com | The Amazon Ads API endpoint URL based on region:
+| `region` | `string` | Yes | https://advertising-api.amazon.com | The Amazon Ads API endpoint URL based on region:
 - NA (North America): https://advertising-api.amazon.com
 - EU (Europe): https://advertising-api-eu.amazon.com
 - FE (Far East): https://advertising-api-fe.amazon.com

{airbyte_agent_amazon_ads-0.1.6 → airbyte_agent_amazon_ads-0.1.11}/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Amazon Ads changelog
 
+## [0.1.11] - 2026-01-26
+- Updated connector definition (YAML version 1.0.3)
+- Source commit: 74809153
+- SDK version: 0.1.0
+
+## [0.1.10] - 2026-01-26
+- Updated connector definition (YAML version 1.0.3)
+- Source commit: b73c71e0
+- SDK version: 0.1.0
+
+## [0.1.9] - 2026-01-24
+- Updated connector definition (YAML version 1.0.3)
+- Source commit: 609c1d86
+- SDK version: 0.1.0
+
+## [0.1.8] - 2026-01-23
+- Updated connector definition (YAML version 1.0.3)
+- Source commit: 6b458f8d
+- SDK version: 0.1.0
+
+## [0.1.7] - 2026-01-23
+- Updated connector definition (YAML version 1.0.2)
+- Source commit: 32c5ef46
+- SDK version: 0.1.0
+
 ## [0.1.6] - 2026-01-23
 - Updated connector definition (YAML version 1.0.1)
 - Source commit: 416466da

{airbyte_agent_amazon_ads-0.1.6 → airbyte_agent_amazon_ads-0.1.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: airbyte-agent-amazon-ads
-Version: 0.1.6
+Version: 0.1.11
 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/
@@ -86,7 +86,7 @@ connector = AmazonAdsConnector(
 )
 
 @agent.tool_plain # assumes you're using Pydantic AI
-@AmazonAdsConnector.describe
+@AmazonAdsConnector.tool_utils
 async def amazon-ads_execute(entity: str, action: str, params: dict | None = None):
     return await connector.execute(entity, action, params or {})
 ```
@@ -101,17 +101,18 @@ This example assumes you've already authenticated your connector with Airbyte. S
 from airbyte_agent_amazon-ads import AmazonAdsConnector
 
 connector = AmazonAdsConnector(
-    external_user_id="<your-scoped-token>",
+    external_user_id="<your_external_user_id>",
     airbyte_client_id="<your-client-id>",
     airbyte_client_secret="<your-client-secret>"
 )
 
 @agent.tool_plain # assumes you're using Pydantic AI
-@AmazonAdsConnector.describe
+@AmazonAdsConnector.tool_utils
 async def amazon-ads_execute(entity: str, action: str, params: dict | None = None):
     return await connector.execute(entity, action, params or {})
 ```
 
+
 ## Full documentation
 
 This connector supports the following entities and actions.
@@ -131,6 +132,6 @@ For the service's official API docs, see the [Amazon-Ads API reference](https://
 
 ## Version information
 
-- **Package version:** 0.1.6
-- **Connector version:** 1.0.1
-- **Generated with Connector SDK commit SHA:** 416466da4970ae5fd6c7f2c658a68e047e51efd9
+- **Package version:** 0.1.11
+- **Connector version:** 1.0.3
+- **Generated with Connector SDK commit SHA:** 74809153299f81ed3e220538146012ee2abd2e0d

{airbyte_agent_amazon_ads-0.1.6 → airbyte_agent_amazon_ads-0.1.11}/README.md

@@ -53,7 +53,7 @@ connector = AmazonAdsConnector(
 )
 
 @agent.tool_plain # assumes you're using Pydantic AI
-@AmazonAdsConnector.describe
+@AmazonAdsConnector.tool_utils
 async def amazon-ads_execute(entity: str, action: str, params: dict | None = None):
     return await connector.execute(entity, action, params or {})
 ```
@@ -68,17 +68,18 @@ This example assumes you've already authenticated your connector with Airbyte. S
 from airbyte_agent_amazon-ads import AmazonAdsConnector
 
 connector = AmazonAdsConnector(
-    external_user_id="<your-scoped-token>",
+    external_user_id="<your_external_user_id>",
     airbyte_client_id="<your-client-id>",
     airbyte_client_secret="<your-client-secret>"
 )
 
 @agent.tool_plain # assumes you're using Pydantic AI
-@AmazonAdsConnector.describe
+@AmazonAdsConnector.tool_utils
 async def amazon-ads_execute(entity: str, action: str, params: dict | None = None):
     return await connector.execute(entity, action, params or {})
 ```
 
+
 ## Full documentation
 
 This connector supports the following entities and actions.
@@ -98,6 +99,6 @@ For the service's official API docs, see the [Amazon-Ads API reference](https://
 
 ## Version information
 
-- **Package version:** 0.1.6
-- **Connector version:** 1.0.1
-- **Generated with Connector SDK commit SHA:** 416466da4970ae5fd6c7f2c658a68e047e51efd9
+- **Package version:** 0.1.11
+- **Connector version:** 1.0.3
+- **Generated with Connector SDK commit SHA:** 74809153299f81ed3e220538146012ee2abd2e0d

{airbyte_agent_amazon_ads-0.1.6 → airbyte_agent_amazon_ads-0.1.11}/REFERENCE.md

@@ -8,7 +8,7 @@ The Amazon-Ads connector supports the following entities and actions.
 
 | Entity | Actions |
 |--------|---------|
-| Profiles | [List](#profiles-list), [Get](#profiles-get) |
+| Profiles | [List](#profiles-list), [Get](#profiles-get), [Search](#profiles-search) |
 | Portfolios | [List](#portfolios-list), [Get](#portfolios-get) |
 | Sponsored Product Campaigns | [List](#sponsored-product-campaigns-list), [Get](#sponsored-product-campaigns-get) |
 
@@ -119,6 +119,75 @@ curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_i
 | `accountInfo` | `object \| any` |  |
 
 
+</details>
+
+### Profiles Search
+
+Search and filter profiles records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.
+
+#### Python SDK
+
+```python
+await amazon_ads.profiles.search(
+    query={"filter": {"eq": {"accountInfo": {}}}}
+)
+```
+
+#### API
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+    "entity": "profiles",
+    "action": "search",
+    "params": {
+        "query": {"filter": {"eq": {"accountInfo": {}}}}
+    }
+}'
+```
+
+#### Parameters
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `query` | `object` | Yes | Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or |
+| `query.filter` | `object` | No | Filter conditions |
+| `query.sort` | `array` | No | Sort conditions |
+| `limit` | `integer` | No | Maximum results to return (default 1000) |
+| `cursor` | `string` | No | Pagination cursor from previous response's next_cursor |
+| `fields` | `array` | No | Field paths to include in results |
+
+#### Searchable Fields
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `accountInfo` | `object` |  |
+| `countryCode` | `string` |  |
+| `currencyCode` | `string` |  |
+| `dailyBudget` | `number` |  |
+| `profileId` | `integer` |  |
+| `timezone` | `string` |  |
+
+<details>
+<summary><b>Response Schema</b></summary>
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `hits` | `array` | List of matching records |
+| `hits[].id` | `string` | Record identifier |
+| `hits[].score` | `number` | Relevance score |
+| `hits[].data` | `object` | Record data containing the searchable fields listed above |
+| `hits[].data.accountInfo` | `object` |  |
+| `hits[].data.countryCode` | `string` |  |
+| `hits[].data.currencyCode` | `string` |  |
+| `hits[].data.dailyBudget` | `number` |  |
+| `hits[].data.profileId` | `integer` |  |
+| `hits[].data.timezone` | `string` |  |
+| `next_cursor` | `string \| null` | Cursor for next page of results |
+| `took_ms` | `number` | Query execution time in milliseconds |
+
 </details>
 
 ## Portfolios
@@ -311,3 +380,4 @@ curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_i
 
 </details>
 
+

{airbyte_agent_amazon_ads-0.1.6 → airbyte_agent_amazon_ads-0.1.11}/airbyte_agent_amazon_ads/__init__.py

@@ -19,7 +19,11 @@ from .models import (
     AmazonAdsExecuteResultWithMeta,
     ProfilesListResult,
     PortfoliosListResult,
-    SponsoredProductCampaignsListResult
+    SponsoredProductCampaignsListResult,
+    AirbyteSearchHit,
+    AirbyteSearchResult,
+    ProfilesSearchData,
+    ProfilesSearchResult
 )
 from .types import (
     SponsoredProductCampaignsListParamsStatefilter,
@@ -28,7 +32,12 @@ from .types import (
     PortfoliosListParams,
     PortfoliosGetParams,
     SponsoredProductCampaignsListParams,
-    SponsoredProductCampaignsGetParams
+    SponsoredProductCampaignsGetParams,
+    AirbyteSearchParams,
+    AirbyteSortOrder,
+    ProfilesSearchFilter,
+    ProfilesSearchQuery,
+    ProfilesCondition
 )
 
 __all__ = [
@@ -47,6 +56,10 @@ __all__ = [
     "ProfilesListResult",
     "PortfoliosListResult",
     "SponsoredProductCampaignsListResult",
+    "AirbyteSearchHit",
+    "AirbyteSearchResult",
+    "ProfilesSearchData",
+    "ProfilesSearchResult",
     "SponsoredProductCampaignsListParamsStatefilter",
     "ProfilesListParams",
     "ProfilesGetParams",
@@ -54,4 +67,9 @@ __all__ = [
     "PortfoliosGetParams",
     "SponsoredProductCampaignsListParams",
     "SponsoredProductCampaignsGetParams",
+    "AirbyteSearchParams",
+    "AirbyteSortOrder",
+    "ProfilesSearchFilter",
+    "ProfilesSearchQuery",
+    "ProfilesCondition",
 ]

{airbyte_agent_amazon_ads-0.1.6 → airbyte_agent_amazon_ads-0.1.11}/airbyte_agent_amazon_ads/_vendored/connector_sdk/connector_model_loader.py

@@ -62,6 +62,53 @@ class TokenExtractValidationError(ConnectorModelLoaderError):
     pass
 
 
+# Expected auth_mapping keys for each auth type.
+# These are the auth parameters that each security scheme expects, NOT the user's credential field names.
+EXPECTED_AUTH_MAPPING_KEYS: dict[AuthType, set[str]] = {
+    AuthType.BEARER: {"token"},
+    AuthType.BASIC: {"username", "password"},
+    AuthType.API_KEY: {"api_key"},
+    AuthType.OAUTH2: {"access_token", "refresh_token", "client_id", "client_secret"},
+}
+
+
+def _validate_auth_mapping_keys(
+    auth_type: AuthType,
+    auth_config: AirbyteAuthConfig | None,
+    scheme_name: str = "default",
+) -> None:
+    """Validate that auth_mapping keys match expected parameters for the auth type.
+
+    The auth_mapping keys must be the parameters expected by the security scheme
+    (e.g., "token" for bearer), not the user's credential field names.
+
+    Args:
+        auth_type: The authentication type
+        auth_config: The x-airbyte-auth-config containing auth_mapping
+        scheme_name: Name of the security scheme for error messages
+
+    Raises:
+        InvalidOpenAPIError: If auth_mapping keys don't match expected parameters
+    """
+    if auth_config is None or auth_config.auth_mapping is None:
+        return  # No explicit auth_mapping, will use defaults
+
+    expected_keys = EXPECTED_AUTH_MAPPING_KEYS.get(auth_type)
+    if expected_keys is None:
+        return  # Unknown auth type, skip validation
+
+    actual_keys = set(auth_config.auth_mapping.keys())
+    invalid_keys = actual_keys - expected_keys
+
+    if invalid_keys:
+        raise InvalidOpenAPIError(
+            f"Invalid auth_mapping keys for {auth_type.value} auth in scheme '{scheme_name}': {invalid_keys}. "
+            f"Expected keys for {auth_type.value}: {sorted(expected_keys)}. "
+            f"Note: auth_mapping keys must be the auth parameters (e.g., 'token' for bearer), "
+            f'not your credential field names. Use template syntax to map: token: "${{your_field}}"'
+        )
+
+
 def extract_path_params(path: str) -> list[str]:
     """Extract parameter names from path template.
 
@@ -145,6 +192,87 @@ def _deproxy_schema(obj: Any) -> Any:
         return obj
 
 
+def _type_includes(type_value: Any, target: str) -> bool:
+    if isinstance(type_value, list):
+        return target in type_value
+    return type_value == target
+
+
+def _flatten_cache_properties(properties: dict[str, Any], prefix: str) -> list[str]:
+    entries: list[str] = []
+    for prop_name, prop in properties.items():
+        path = f"{prefix}{prop_name}" if prefix else prop_name
+        entries.append(path)
+
+        prop_type = getattr(prop, "type", None) if not isinstance(prop, dict) else prop.get("type")
+        prop_properties = getattr(prop, "properties", None) if not isinstance(prop, dict) else prop.get("properties")
+
+        if _type_includes(prop_type, "array"):
+            array_path = f"{path}[]"
+            entries.append(array_path)
+            if isinstance(prop_properties, dict):
+                entries.extend(_flatten_cache_properties(prop_properties, prefix=f"{array_path}."))
+        elif isinstance(prop_properties, dict):
+            entries.extend(_flatten_cache_properties(prop_properties, prefix=f"{path}."))
+
+    return entries
+
+
+def _flatten_cache_field_paths(field: Any) -> list[str]:
+    field_name = getattr(field, "name", None) if not isinstance(field, dict) else field.get("name")
+    if not isinstance(field_name, str) or not field_name:
+        return []
+
+    field_type = getattr(field, "type", None) if not isinstance(field, dict) else field.get("type")
+    field_properties = getattr(field, "properties", None) if not isinstance(field, dict) else field.get("properties")
+
+    entries = [field_name]
+    if _type_includes(field_type, "array"):
+        array_path = f"{field_name}[]"
+        entries.append(array_path)
+        if isinstance(field_properties, dict):
+            entries.extend(_flatten_cache_properties(field_properties, prefix=f"{array_path}."))
+    elif isinstance(field_properties, dict):
+        entries.extend(_flatten_cache_properties(field_properties, prefix=f"{field_name}."))
+
+    return entries
+
+
+def _dedupe_strings(values: list[str]) -> list[str]:
+    seen: set[str] = set()
+    ordered: list[str] = []
+    for value in values:
+        if value not in seen:
+            seen.add(value)
+            ordered.append(value)
+    return ordered
+
+
+def _extract_search_field_paths(spec: OpenAPIConnector) -> dict[str, list[str]]:
+    cache_config = getattr(spec.info, "x_airbyte_cache", None)
+    entities = getattr(cache_config, "entities", None)
+    if not isinstance(entities, list):
+        return {}
+
+    search_fields: dict[str, list[str]] = {}
+    for entity in entities:
+        entity_name = getattr(entity, "entity", None) if not isinstance(entity, dict) else entity.get("entity")
+        if not isinstance(entity_name, str) or not entity_name:
+            continue
+
+        fields = getattr(entity, "fields", None) if not isinstance(entity, dict) else entity.get("fields")
+        if not isinstance(fields, list):
+            continue
+
+        field_paths: list[str] = []
+        for field in fields:
+            field_paths.extend(_flatten_cache_field_paths(field))
+
+        search_fields[entity_name] = _dedupe_strings(field_paths)
+
+    return search_fields
+
+
 def parse_openapi_spec(raw_config: dict) -> OpenAPIConnector:
     """Parse OpenAPI specification from YAML.
 
@@ -434,6 +562,8 @@ def convert_openapi_to_connector_model(spec: OpenAPIConnector) -> ConnectorModel
     if not connector_id:
         raise InvalidOpenAPIError("Missing required x-airbyte-connector-id field")
 
+    search_field_paths = _extract_search_field_paths(spec)
+
     # Create ConnectorModel
     model = ConnectorModel(
         id=connector_id,
@@ -444,6 +574,7 @@ def convert_openapi_to_connector_model(spec: OpenAPIConnector) -> ConnectorModel
         entities=entities,
         openapi_spec=spec,
         retry_config=retry_config,
+        search_field_paths=search_field_paths,
     )
 
     return model
@@ -840,6 +971,9 @@ def _parse_single_security_scheme(scheme: Any) -> AuthConfig:
         oauth2_config = _parse_oauth2_config(scheme)
         # Use explicit x-airbyte-auth-config if present, otherwise generate default
         auth_config_obj = scheme.x_airbyte_auth_config or _generate_default_auth_config(AuthType.OAUTH2)
+        # Validate auth_mapping keys if explicitly provided
+        if scheme.x_airbyte_auth_config:
+            _validate_auth_mapping_keys(AuthType.OAUTH2, scheme.x_airbyte_auth_config)
         return AuthConfig(
             type=AuthType.OAUTH2,
             config=oauth2_config,
@@ -850,6 +984,10 @@ def _parse_single_security_scheme(scheme: Any) -> AuthConfig:
     # Use explicit x-airbyte-auth-config if present, otherwise generate default
     auth_config_obj = scheme.x_airbyte_auth_config or _generate_default_auth_config(auth_type)
 
+    # Validate auth_mapping keys if explicitly provided
+    if scheme.x_airbyte_auth_config:
+        _validate_auth_mapping_keys(auth_type, scheme.x_airbyte_auth_config)
+
     return AuthConfig(
         type=auth_type,
         config=auth_config,

{airbyte_agent_amazon_ads-0.1.6 → airbyte_agent_amazon_ads-0.1.11}/airbyte_agent_amazon_ads/_vendored/connector_sdk/executor/local_executor.py

@@ -1032,7 +1032,9 @@ class LocalExecutor:
         if "variables" in graphql_config and graphql_config["variables"]:
             variables = self._interpolate_variables(graphql_config["variables"], params, param_defaults)
             # Filter out None values (optional fields not provided) - matches REST _extract_body() behavior
-            body["variables"] = {k: v for k, v in variables.items() if v is not None}
+            # But preserve None for variables explicitly marked as nullable (e.g., to unassign a user)
+            nullable_vars = set(graphql_config.get("x-airbyte-nullable-variables") or [])
+            body["variables"] = {k: v for k, v in variables.items() if v is not None or k in nullable_vars}
 
         # Add operation name if specified
         if "operationName" in graphql_config: