airbyte-agent-amazon-ads 0.1.5__py3-none-any.whl → 0.1.9__py3-none-any.whl

airbyte_agent_amazon_ads/models.py

@@ -152,6 +152,61 @@ class AmazonAdsExecuteResultWithMeta(AmazonAdsExecuteResult[T], Generic[T, S]):
     meta: S
     """Metadata about the response (e.g., pagination cursors, record counts)."""
 
+# ===== SEARCH DATA MODELS =====
+# Entity-specific Pydantic models for search result data
+
+# Type variable for search data generic
+D = TypeVar('D')
+
+class ProfilesSearchData(BaseModel):
+    """Search result data for profiles entity."""
+    model_config = ConfigDict(extra="allow")
+
+    account_info: dict[str, Any] | None = None
+    """"""
+    country_code: str | None = None
+    """"""
+    currency_code: str | None = None
+    """"""
+    daily_budget: float | None = None
+    """"""
+    profile_id: int | None = None
+    """"""
+    timezone: str | None = None
+    """"""
+
+
+# ===== GENERIC SEARCH RESULT TYPES =====
+
+class AirbyteSearchHit(BaseModel, Generic[D]):
+    """A single search result with typed data."""
+    model_config = ConfigDict(extra="allow")
+
+    id: str | None = None
+    """Unique identifier for the record."""
+    score: float | None = None
+    """Relevance score for the match."""
+    data: D
+    """The matched record data."""
+
+
+class AirbyteSearchResult(BaseModel, Generic[D]):
+    """Result from Airbyte cache search operations with typed hits."""
+    model_config = ConfigDict(extra="allow")
+
+    hits: list[AirbyteSearchHit[D]] = Field(default_factory=list)
+    """List of matching records."""
+    next_cursor: str | None = None
+    """Cursor for fetching the next page of results."""
+    took_ms: int | None = None
+    """Time taken to execute the search in milliseconds."""
+
+
+# ===== ENTITY-SPECIFIC SEARCH RESULT TYPE ALIASES =====
+
+ProfilesSearchResult = AirbyteSearchResult[ProfilesSearchData]
+"""Search result type for profiles entity."""
+
 
 
 # ===== OPERATION RESULT TYPE ALIASES =====

airbyte_agent_amazon_ads/types.py

@@ -9,6 +9,7 @@ try:
 except ImportError:
     from typing import TypedDict, NotRequired  # type: ignore[attr-defined]
 
+from typing import Any, Literal
 
 
 # ===== NESTED PARAM TYPE DEFINITIONS =====
@@ -46,3 +47,192 @@ class SponsoredProductCampaignsGetParams(TypedDict):
     """Parameters for sponsored_product_campaigns.get operation"""
     campaign_id: str
 
+# ===== SEARCH TYPES =====
+
+# Sort specification
+AirbyteSortOrder = Literal["asc", "desc"]
+
+# ===== PROFILES SEARCH TYPES =====
+
+class ProfilesSearchFilter(TypedDict, total=False):
+    """Available fields for filtering profiles search queries."""
+    account_info: dict[str, Any] | None
+    """"""
+    country_code: str | None
+    """"""
+    currency_code: str | None
+    """"""
+    daily_budget: float | None
+    """"""
+    profile_id: int | None
+    """"""
+    timezone: str | None
+    """"""
+
+
+class ProfilesInFilter(TypedDict, total=False):
+    """Available fields for 'in' condition (values are lists)."""
+    account_info: list[dict[str, Any]]
+    """"""
+    country_code: list[str]
+    """"""
+    currency_code: list[str]
+    """"""
+    daily_budget: list[float]
+    """"""
+    profile_id: list[int]
+    """"""
+    timezone: list[str]
+    """"""
+
+
+class ProfilesAnyValueFilter(TypedDict, total=False):
+    """Available fields with Any value type. Used for 'contains' and 'any' conditions."""
+    account_info: Any
+    """"""
+    country_code: Any
+    """"""
+    currency_code: Any
+    """"""
+    daily_budget: Any
+    """"""
+    profile_id: Any
+    """"""
+    timezone: Any
+    """"""
+
+
+class ProfilesStringFilter(TypedDict, total=False):
+    """String fields for text search conditions (like, fuzzy, keyword)."""
+    account_info: str
+    """"""
+    country_code: str
+    """"""
+    currency_code: str
+    """"""
+    daily_budget: str
+    """"""
+    profile_id: str
+    """"""
+    timezone: str
+    """"""
+
+
+class ProfilesSortFilter(TypedDict, total=False):
+    """Available fields for sorting profiles search results."""
+    account_info: AirbyteSortOrder
+    """"""
+    country_code: AirbyteSortOrder
+    """"""
+    currency_code: AirbyteSortOrder
+    """"""
+    daily_budget: AirbyteSortOrder
+    """"""
+    profile_id: AirbyteSortOrder
+    """"""
+    timezone: AirbyteSortOrder
+    """"""
+
+
+# Entity-specific condition types for profiles
+class ProfilesEqCondition(TypedDict, total=False):
+    """Equal to: field equals value."""
+    eq: ProfilesSearchFilter
+
+
+class ProfilesNeqCondition(TypedDict, total=False):
+    """Not equal to: field does not equal value."""
+    neq: ProfilesSearchFilter
+
+
+class ProfilesGtCondition(TypedDict, total=False):
+    """Greater than: field > value."""
+    gt: ProfilesSearchFilter
+
+
+class ProfilesGteCondition(TypedDict, total=False):
+    """Greater than or equal: field >= value."""
+    gte: ProfilesSearchFilter
+
+
+class ProfilesLtCondition(TypedDict, total=False):
+    """Less than: field < value."""
+    lt: ProfilesSearchFilter
+
+
+class ProfilesLteCondition(TypedDict, total=False):
+    """Less than or equal: field <= value."""
+    lte: ProfilesSearchFilter
+
+
+class ProfilesLikeCondition(TypedDict, total=False):
+    """Partial string match with % wildcards."""
+    like: ProfilesStringFilter
+
+
+class ProfilesFuzzyCondition(TypedDict, total=False):
+    """Ordered word text match (case-insensitive)."""
+    fuzzy: ProfilesStringFilter
+
+
+class ProfilesKeywordCondition(TypedDict, total=False):
+    """Keyword text match (any word present)."""
+    keyword: ProfilesStringFilter
+
+
+class ProfilesContainsCondition(TypedDict, total=False):
+    """Check if value exists in array field. Example: {"contains": {"tags": "premium"}}"""
+    contains: ProfilesAnyValueFilter
+
+
+# Reserved keyword conditions using functional TypedDict syntax
+ProfilesInCondition = TypedDict("ProfilesInCondition", {"in": ProfilesInFilter}, total=False)
+"""In list: field value is in list. Example: {"in": {"status": ["active", "pending"]}}"""
+
+ProfilesNotCondition = TypedDict("ProfilesNotCondition", {"not": "ProfilesCondition"}, total=False)
+"""Negates the nested condition."""
+
+ProfilesAndCondition = TypedDict("ProfilesAndCondition", {"and": "list[ProfilesCondition]"}, total=False)
+"""True if all nested conditions are true."""
+
+ProfilesOrCondition = TypedDict("ProfilesOrCondition", {"or": "list[ProfilesCondition]"}, total=False)
+"""True if any nested condition is true."""
+
+ProfilesAnyCondition = TypedDict("ProfilesAnyCondition", {"any": ProfilesAnyValueFilter}, total=False)
+"""Match if ANY element in array field matches nested condition. Example: {"any": {"addresses": {"eq": {"state": "CA"}}}}"""
+
+# Union of all profiles condition types
+ProfilesCondition = (
+    ProfilesEqCondition
+    | ProfilesNeqCondition
+    | ProfilesGtCondition
+    | ProfilesGteCondition
+    | ProfilesLtCondition
+    | ProfilesLteCondition
+    | ProfilesInCondition
+    | ProfilesLikeCondition
+    | ProfilesFuzzyCondition
+    | ProfilesKeywordCondition
+    | ProfilesContainsCondition
+    | ProfilesNotCondition
+    | ProfilesAndCondition
+    | ProfilesOrCondition
+    | ProfilesAnyCondition
+)
+
+
+class ProfilesSearchQuery(TypedDict, total=False):
+    """Search query for profiles entity."""
+    filter: ProfilesCondition
+    sort: list[ProfilesSortFilter]
+
+
+
+# ===== SEARCH PARAMS =====
+
+class AirbyteSearchParams(TypedDict, total=False):
+    """Parameters for Airbyte cache search operations (generic, use entity-specific query types for better type hints)."""
+    query: dict[str, Any]
+    limit: int
+    cursor: str
+    fields: list[list[str]]

{airbyte_agent_amazon_ads-0.1.5.dist-info → airbyte_agent_amazon_ads-0.1.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: airbyte-agent-amazon-ads
-Version: 0.1.5
+Version: 0.1.9
 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 {})
 ```
@@ -107,11 +107,12 @@ 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 {})
 ```
 
+
 ## 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.5
-- **Connector version:** 1.0.1
-- **Generated with Connector SDK commit SHA:** f17cdd8c92950751a75daff9c6bf74df05774ede
+- **Package version:** 0.1.9
+- **Connector version:** 1.0.3
+- **Generated with Connector SDK commit SHA:** 609c1d86c76b36ff699b57123a5a8c2050d958c3

{airbyte_agent_amazon_ads-0.1.5.dist-info → airbyte_agent_amazon_ads-0.1.9.dist-info}/RECORD

@@ -1,27 +1,27 @@
-airbyte_agent_amazon_ads/__init__.py,sha256=q1HEHSqUrBKHSJDrjl6DpmKQ7BLgfV8-Ct_07h9yWoU,1442
-airbyte_agent_amazon_ads/connector.py,sha256=_xaQg0CzkAHAZLoWoP7zIwYN4Uvge-jYlQyP5A2hrF0,19290
-airbyte_agent_amazon_ads/connector_model.py,sha256=JaflXe0x3R1neowZ8dQ4kTX-6lmQMmAJO9xP1nRFNoc,61939
-airbyte_agent_amazon_ads/models.py,sha256=373Eq2tb4mroZNrkWCpt-oFY1bZgOZd2sDfaNVDZ0rc,7610
-airbyte_agent_amazon_ads/types.py,sha256=qe9zmgsEV06BQKQ68In9fwZji2tDqCB2JJXU_6dNwxA,1538
+airbyte_agent_amazon_ads/__init__.py,sha256=f883U_4eSRjMLgjqpi5rGcKZ0U44ME_Z0IY-XZhwlPc,1896
+airbyte_agent_amazon_ads/connector.py,sha256=LUhUhLTmj2oF8J7-0jO4I8KfPK4L082yTzwUyz_DKL0,23895
+airbyte_agent_amazon_ads/connector_model.py,sha256=lOTUqeFdrTtnW2GLh5hBwxp9Xwg0lTPTAE5EcOaQteE,98118
+airbyte_agent_amazon_ads/models.py,sha256=TOHCY0p3cE0rWVv3YfYvyvL-lmdYBcoGRTXtFNNBztc,9182
+airbyte_agent_amazon_ads/types.py,sha256=EW-jvOmXyJQqe2ESiDCs7nCIIsFreDCIZBlA6aplxpA,6728
 airbyte_agent_amazon_ads/_vendored/__init__.py,sha256=ILl7AHXMui__swyrjxrh9yRa4dLiwBvV6axPWFWty80,38
 airbyte_agent_amazon_ads/_vendored/connector_sdk/__init__.py,sha256=T5o7roU6NSpH-lCAGZ338sE5dlh4ZU6i6IkeG1zpems,1949
 airbyte_agent_amazon_ads/_vendored/connector_sdk/auth_strategies.py,sha256=5Sb9moUp623o67Q2wMa8iZldJH08y4gQdoutoO_75Iw,42088
 airbyte_agent_amazon_ads/_vendored/connector_sdk/auth_template.py,sha256=nju4jqlFC_KI82ILNumNIyiUtRJcy7J94INIZ0QraI4,4454
-airbyte_agent_amazon_ads/_vendored/connector_sdk/connector_model_loader.py,sha256=SY_Juqw-cap156MsdgrMfe5MAuFdX0vUcSbH5LUYNK0,36295
+airbyte_agent_amazon_ads/_vendored/connector_sdk/connector_model_loader.py,sha256=nCu6oym6LoKrS94NTivU1vyQE_qnU-rhx8ExpuOX_LU,39544
 airbyte_agent_amazon_ads/_vendored/connector_sdk/constants.py,sha256=AtzOvhDMWbRJgpsQNWl5tkogHD6mWgEY668PgRmgtOY,2737
 airbyte_agent_amazon_ads/_vendored/connector_sdk/exceptions.py,sha256=ss5MGv9eVPmsbLcLWetuu3sDmvturwfo6Pw3M37Oq5k,481
 airbyte_agent_amazon_ads/_vendored/connector_sdk/extensions.py,sha256=XWRRoJOOrwUHSKbuQt5DU7CCu8ePzhd_HuP7c_uD77w,21376
 airbyte_agent_amazon_ads/_vendored/connector_sdk/http_client.py,sha256=yucwu3OvJh5wLQa1mk-gTKjtqjKKucMw5ltmlE7mk1c,28000
-airbyte_agent_amazon_ads/_vendored/connector_sdk/introspection.py,sha256=2CyKXZHT74-1Id97uw1RLeyOi6TV24_hoNbQ6-6y7uI,10335
+airbyte_agent_amazon_ads/_vendored/connector_sdk/introspection.py,sha256=kRVI4TDQDLdcCnTBUML8ycAtdqAQufVh-027sMkb4i8,19165
 airbyte_agent_amazon_ads/_vendored/connector_sdk/secrets.py,sha256=J9ezMu4xNnLW11xY5RCre6DHP7YMKZCqwGJfk7ufHAM,6855
-airbyte_agent_amazon_ads/_vendored/connector_sdk/types.py,sha256=d8PidSD5nzhSSgFwUeYtRKw8pTm0Gft_IHsGeELifuk,8748
+airbyte_agent_amazon_ads/_vendored/connector_sdk/types.py,sha256=in8gHsn5nsScujOfHZmkOgNmqmJKiPyNNjg59m5fGWc,8807
 airbyte_agent_amazon_ads/_vendored/connector_sdk/utils.py,sha256=G4LUXOC2HzPoND2v4tQW68R9uuPX9NQyCjaGxb7Kpl0,1958
 airbyte_agent_amazon_ads/_vendored/connector_sdk/validation.py,sha256=4MPrxYmQh8TbCU0KdvvRKe35Lg1YYLEBd0u4aKySl_E,32122
 airbyte_agent_amazon_ads/_vendored/connector_sdk/cloud_utils/__init__.py,sha256=4799Hv9f2zxDVj1aLyQ8JpTEuFTp_oOZMRz-NZCdBJg,134
 airbyte_agent_amazon_ads/_vendored/connector_sdk/cloud_utils/client.py,sha256=YxdRpQr9XjDzih6csSseBVGn9kfMtaqbOCXP0TPuzFY,7189
 airbyte_agent_amazon_ads/_vendored/connector_sdk/executor/__init__.py,sha256=EmG9YQNAjSuYCVB4D5VoLm4qpD1KfeiiOf7bpALj8p8,702
 airbyte_agent_amazon_ads/_vendored/connector_sdk/executor/hosted_executor.py,sha256=ydHcG-biRS1ITT5ELwPShdJW-KYpvK--Fos1ipNgHho,6995
-airbyte_agent_amazon_ads/_vendored/connector_sdk/executor/local_executor.py,sha256=Vg4rPk0sbgXEdYLx2n2Spgj9XrDUWykD2E2o7sWloRM,73849
+airbyte_agent_amazon_ads/_vendored/connector_sdk/executor/local_executor.py,sha256=tVbfstxOrm5qJt1NawTwjhIIpDgPCC4wSrKM5eALPSQ,74064
 airbyte_agent_amazon_ads/_vendored/connector_sdk/executor/models.py,sha256=lYVT_bNcw-PoIks4WHNyl2VY-lJVf2FntzINSOBIheE,5845
 airbyte_agent_amazon_ads/_vendored/connector_sdk/http/__init__.py,sha256=y8fbzZn-3yV9OxtYz8Dy6FFGI5v6TOqADd1G3xHH3Hw,911
 airbyte_agent_amazon_ads/_vendored/connector_sdk/http/config.py,sha256=6J7YIIwHC6sRu9i-yKa5XvArwK2KU60rlnmxzDZq3lw,3283
@@ -42,16 +42,16 @@ airbyte_agent_amazon_ads/_vendored/connector_sdk/performance/__init__.py,sha256=
 airbyte_agent_amazon_ads/_vendored/connector_sdk/performance/instrumentation.py,sha256=_dXvNiqdndIBwDjeDKNViWzn_M5FkSUsMmJtFldrmsM,1504
 airbyte_agent_amazon_ads/_vendored/connector_sdk/performance/metrics.py,sha256=FRff7dKt4iwt_A7pxV5n9kAGBR756PC7q8-weWygPSM,2817
 airbyte_agent_amazon_ads/_vendored/connector_sdk/schema/__init__.py,sha256=Uymu-QuzGJuMxexBagIvUxpVAigIuIhz3KeBl_Vu4Ko,1638
-airbyte_agent_amazon_ads/_vendored/connector_sdk/schema/base.py,sha256=zBW5svQohGCdn46Snc8DG4PsqfmZDovp693vRgugDFE,5374
-airbyte_agent_amazon_ads/_vendored/connector_sdk/schema/components.py,sha256=x3YCM1p2n_xHi50fMeOX0mXUiPqjGlLHs3Go8jXokb0,7895
+airbyte_agent_amazon_ads/_vendored/connector_sdk/schema/base.py,sha256=IoAucZQ0j0xTdm4VWotB636R4jsrkYnppMQhXE0uoyU,6541
+airbyte_agent_amazon_ads/_vendored/connector_sdk/schema/components.py,sha256=nJIPieavwX3o3ODvdtLHPk84d_V229xmg6LDfwEHjzc,8119
 airbyte_agent_amazon_ads/_vendored/connector_sdk/schema/connector.py,sha256=mSZk1wr2YSdRj9tTRsPAuIlCzd_xZLw-Bzl1sMwE0rE,3731
-airbyte_agent_amazon_ads/_vendored/connector_sdk/schema/extensions.py,sha256=f7VhHrcIYxaPOJHMc4g0lpy04pZTbx5nlroNzAu5B9Q,7135
+airbyte_agent_amazon_ads/_vendored/connector_sdk/schema/extensions.py,sha256=5hgpFHK7fzpzegCkJk882DeIP79bCx_qairKJhvPMZ8,9590
 airbyte_agent_amazon_ads/_vendored/connector_sdk/schema/operations.py,sha256=RpzGtAI4yvAtMHAfMUMcUwgHv_qJojnKlNb75_agUF8,5729
 airbyte_agent_amazon_ads/_vendored/connector_sdk/schema/security.py,sha256=6ljzf_JHs4amnQX9AhePcEsT8P3ZnTSC4xeg7-cvsNQ,9100
 airbyte_agent_amazon_ads/_vendored/connector_sdk/telemetry/__init__.py,sha256=RaLgkBU4dfxn1LC5Y0Q9rr2PJbrwjxvPgBLmq8_WafE,211
 airbyte_agent_amazon_ads/_vendored/connector_sdk/telemetry/config.py,sha256=tLmQwAFD0kP1WyBGWBS3ysaudN9H3e-3EopKZi6cGKg,885
 airbyte_agent_amazon_ads/_vendored/connector_sdk/telemetry/events.py,sha256=8Y1NbXiwISX-V_wRofY7PqcwEXD0dLMnntKkY6XFU2s,1328
 airbyte_agent_amazon_ads/_vendored/connector_sdk/telemetry/tracker.py,sha256=Ftrk0_ddfM7dZG8hF9xBuPwhbc9D6JZ7Q9qs5o3LEyA,5579
-airbyte_agent_amazon_ads-0.1.5.dist-info/METADATA,sha256=jPZzeVjWD9y6Lsq7CVUEQt_XCePJr_xosoFhVo0MAVI,5152
-airbyte_agent_amazon_ads-0.1.5.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-airbyte_agent_amazon_ads-0.1.5.dist-info/RECORD,,
+airbyte_agent_amazon_ads-0.1.9.dist-info/METADATA,sha256=_RbZLdC2MqkaarpWQu6NQfNnfDXX2PhXwCFm6dxsf-0,5157
+airbyte_agent_amazon_ads-0.1.9.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+airbyte_agent_amazon_ads-0.1.9.dist-info/RECORD,,