airbyte-agent-klaviyo 0.1.1__tar.gz → 0.1.4__tar.gz

airbyte_agent_klaviyo-0.1.4/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Klaviyo changelog
+
+## [0.1.4] - 2026-02-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 9d9866b0
+- SDK version: 0.1.0
+
+## [0.1.3] - 2026-01-30
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: b184da3e
+- SDK version: 0.1.0
+
+## [0.1.2] - 2026-01-30
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 5b20f488
+- SDK version: 0.1.0
+
+## [0.1.1] - 2026-01-30
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: a3729d85
+- SDK version: 0.1.0
+
+## [0.1.0] - 2026-01-30
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 041914fa
+- SDK version: 0.1.0

{airbyte_agent_klaviyo-0.1.1 → airbyte_agent_klaviyo-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: airbyte-agent-klaviyo
-Version: 0.1.1
+Version: 0.1.4
 Summary: Airbyte Klaviyo Connector for AI platforms
 Project-URL: Homepage, https://github.com/airbytehq/airbyte-agent-connectors
 Project-URL: Documentation, https://docs.airbyte.com/ai-agents/
@@ -146,7 +146,7 @@ See the official [Klaviyo API reference](https://developers.klaviyo.com/en/refer
 
 ## Version information
 
-- **Package version:** 0.1.1
+- **Package version:** 0.1.4
 - **Connector version:** 1.0.0
-- **Generated with Connector SDK commit SHA:** e4eb233f8dd57ad9bc825064625222a988db2cc6
+- **Generated with Connector SDK commit SHA:** 9d9866b0aae8c3494d04d34e193b9bd860bfc1c6
 - **Changelog:** [View changelog](https://github.com/airbytehq/airbyte-agent-connectors/blob/main/connectors/klaviyo/CHANGELOG.md)

{airbyte_agent_klaviyo-0.1.1 → airbyte_agent_klaviyo-0.1.4}/README.md

@@ -113,7 +113,7 @@ See the official [Klaviyo API reference](https://developers.klaviyo.com/en/refer
 
 ## Version information
 
-- **Package version:** 0.1.1
+- **Package version:** 0.1.4
 - **Connector version:** 1.0.0
-- **Generated with Connector SDK commit SHA:** e4eb233f8dd57ad9bc825064625222a988db2cc6
+- **Generated with Connector SDK commit SHA:** 9d9866b0aae8c3494d04d34e193b9bd860bfc1c6
 - **Changelog:** [View changelog](https://github.com/airbytehq/airbyte-agent-connectors/blob/main/connectors/klaviyo/CHANGELOG.md)

{airbyte_agent_klaviyo-0.1.1 → airbyte_agent_klaviyo-0.1.4}/airbyte_agent_klaviyo/__init__.py

@@ -7,9 +7,9 @@ Auto-generated from OpenAPI specification.
 from .connector import KlaviyoConnector
 from .models import (
     KlaviyoAuthConfig,
-    ProfileLinks,
     ProfileAttributesLocation,
     ProfileAttributes,
+    ProfileLinks,
     Profile,
     ProfilesListLinks,
     ProfilesList,
@@ -18,18 +18,18 @@ from .models import (
     List,
     ListsListLinks,
     ListsList,
-    CampaignAttributes,
     CampaignLinks,
+    CampaignAttributes,
     Campaign,
     CampaignsListLinks,
     CampaignsList,
-    EventLinks,
-    EventAttributes,
-    EventRelationshipsMetricData,
-    EventRelationshipsMetric,
     EventRelationshipsProfileData,
     EventRelationshipsProfile,
+    EventRelationshipsMetricData,
+    EventRelationshipsMetric,
     EventRelationships,
+    EventLinks,
+    EventAttributes,
     Event,
     EventsListLinks,
     EventsList,
@@ -39,8 +39,8 @@ from .models import (
     Metric,
     MetricsListLinks,
     MetricsList,
-    FlowAttributes,
     FlowLinks,
+    FlowAttributes,
     Flow,
     FlowsListLinks,
     FlowsList,
@@ -118,9 +118,9 @@ from .types import (
 __all__ = [
     "KlaviyoConnector",
     "KlaviyoAuthConfig",
-    "ProfileLinks",
     "ProfileAttributesLocation",
     "ProfileAttributes",
+    "ProfileLinks",
     "Profile",
     "ProfilesListLinks",
     "ProfilesList",
@@ -129,18 +129,18 @@ __all__ = [
     "List",
     "ListsListLinks",
     "ListsList",
-    "CampaignAttributes",
     "CampaignLinks",
+    "CampaignAttributes",
     "Campaign",
     "CampaignsListLinks",
     "CampaignsList",
-    "EventLinks",
-    "EventAttributes",
-    "EventRelationshipsMetricData",
-    "EventRelationshipsMetric",
     "EventRelationshipsProfileData",
     "EventRelationshipsProfile",
+    "EventRelationshipsMetricData",
+    "EventRelationshipsMetric",
     "EventRelationships",
+    "EventLinks",
+    "EventAttributes",
     "Event",
     "EventsListLinks",
     "EventsList",
@@ -150,8 +150,8 @@ __all__ = [
     "Metric",
     "MetricsListLinks",
     "MetricsList",
-    "FlowAttributes",
     "FlowLinks",
+    "FlowAttributes",
     "Flow",
     "FlowsListLinks",
     "FlowsList",

{airbyte_agent_klaviyo-0.1.1 → airbyte_agent_klaviyo-0.1.4}/airbyte_agent_klaviyo/_vendored/connector_sdk/cloud_utils/client.py

@@ -161,6 +161,131 @@ class AirbyteCloudClient:
         connector_id = connectors[0]["id"]
         return connector_id
 
+    async def initiate_oauth(
+        self,
+        definition_id: str,
+        external_user_id: str,
+        redirect_url: str,
+    ) -> str:
+        """Initiate a server-side OAuth flow.
+
+        Starts the OAuth flow for a connector. Returns a consent URL where the
+        end user should be redirected to grant access. After completing consent,
+        they'll be redirected to your redirect_url with a `server_side_oauth_secret_id`
+        query parameter that can be used with `create_source()`.
+
+        Args:
+            definition_id: Connector definition UUID
+            external_user_id: Workspace identifier
+            redirect_url: URL where users will be redirected after OAuth consent
+
+        Returns:
+            The OAuth consent URL
+
+        Raises:
+            httpx.HTTPStatusError: If the request fails
+
+        Example:
+            consent_url = await client.initiate_oauth(
+                definition_id="d8313939-3782-41b0-be29-b3ca20d8dd3a",
+                external_user_id="my-workspace",
+                redirect_url="https://myapp.com/oauth/callback",
+            )
+            # Redirect user to: consent_url
+            # After consent: https://myapp.com/oauth/callback?server_side_oauth_secret_id=...
+        """
+        token = await self.get_bearer_token()
+        url = f"{self.API_BASE_URL}/api/v1/integrations/connectors/oauth/initiate"
+        headers = {"Authorization": f"Bearer {token}"}
+        request_body = {
+            "external_user_id": external_user_id,
+            "definition_id": definition_id,
+            "redirect_url": redirect_url,
+        }
+
+        response = await self._http_client.post(url, json=request_body, headers=headers)
+        response.raise_for_status()
+        return response.json()["consent_url"]
+
+    async def create_source(
+        self,
+        name: str,
+        connector_definition_id: str,
+        external_user_id: str,
+        credentials: dict[str, Any] | None = None,
+        replication_config: dict[str, Any] | None = None,
+        server_side_oauth_secret_id: str | None = None,
+        source_template_id: str | None = None,
+    ) -> str:
+        """Create a new source on Airbyte Cloud.
+
+        Supports two authentication modes:
+        1. Direct credentials: Provide `credentials` dict
+        2. Server-side OAuth: Provide `server_side_oauth_secret_id` from OAuth flow
+
+        Args:
+            name: Source name
+            connector_definition_id: UUID of the connector definition
+            external_user_id: User identifier
+            credentials: Connector auth config dict. Required unless using OAuth.
+            replication_config: Optional replication settings (e.g., start_date for
+                connectors with x-airbyte-replication-config). Required for REPLICATION
+                mode sources like Intercom.
+            server_side_oauth_secret_id: OAuth secret ID from initiate_oauth redirect.
+                When provided, credentials are not required.
+            source_template_id: Source template ID. Required when organization has
+                multiple source templates for this connector type.
+
+        Returns:
+            The created source ID (UUID string)
+
+        Raises:
+            httpx.HTTPStatusError: If creation fails
+
+        Example:
+            # With direct credentials:
+            source_id = await client.create_source(
+                name="My Intercom Source",
+                connector_definition_id="d8313939-3782-41b0-be29-b3ca20d8dd3a",
+                external_user_id="my-workspace",
+                credentials={"access_token": "..."},
+                replication_config={"start_date": "2024-01-01T00:00:00Z"}
+            )
+
+            # With server-side OAuth:
+            source_id = await client.create_source(
+                name="My Intercom Source",
+                connector_definition_id="d8313939-3782-41b0-be29-b3ca20d8dd3a",
+                external_user_id="my-workspace",
+                server_side_oauth_secret_id="airbyte_oauth_..._secret_...",
+                replication_config={"start_date": "2024-01-01T00:00:00Z"}
+            )
+        """
+        token = await self.get_bearer_token()
+        url = f"{self.API_BASE_URL}/v1/integrations/connectors"
+        headers = {"Authorization": f"Bearer {token}"}
+
+        request_body: dict[str, Any] = {
+            "name": name,
+            "definition_id": connector_definition_id,
+            "external_user_id": external_user_id,
+        }
+
+        if credentials is not None:
+            request_body["credentials"] = credentials
+        if replication_config is not None:
+            request_body["replication_config"] = replication_config
+        if server_side_oauth_secret_id is not None:
+            request_body["server_side_oauth_secret_id"] = server_side_oauth_secret_id
+        if source_template_id is not None:
+            request_body["source_template_id"] = source_template_id
+
+        response = await self._http_client.post(url, json=request_body, headers=headers)
+        response.raise_for_status()
+
+        data = response.json()
+        return data["id"]
+
     async def execute_connector(
         self,
         connector_id: str,

{airbyte_agent_klaviyo-0.1.1 → airbyte_agent_klaviyo-0.1.4}/airbyte_agent_klaviyo/_vendored/connector_sdk/connector_model_loader.py

@@ -1014,6 +1014,7 @@ def _parse_security_scheme_to_option(scheme_name: str, scheme: Any) -> AuthOptio
         type=single_auth.type,
         config=single_auth.config,
         user_config_spec=single_auth.user_config_spec,
+        untested=getattr(scheme, "x_airbyte_untested", False),
     )
 
 

{airbyte_agent_klaviyo-0.1.1 → airbyte_agent_klaviyo-0.1.4}/airbyte_agent_klaviyo/_vendored/connector_sdk/executor/hosted_executor.py

@@ -19,19 +19,26 @@ class HostedExecutor:
     instead of directly calling external services. The cloud API handles all
     connector logic, secrets management, and execution.
 
-    The executor takes an external_user_id and uses the AirbyteCloudClient to:
+    The executor uses the AirbyteCloudClient to:
     1. Authenticate with the Airbyte Platform (bearer token with caching)
-    2. Look up the user's connector
+    2. Look up the user's connector (if connector_id not provided)
     3. Execute the connector operation via the cloud API
 
     Implements ExecutorProtocol.
 
     Example:
-        # Create executor with user ID, credentials, and connector definition ID
+        # Create executor with explicit connector_id (no lookup needed)
+        executor = HostedExecutor(
+            airbyte_client_id="client_abc123",
+            airbyte_client_secret="secret_xyz789",
+            connector_id="existing-source-uuid",
+        )
+
+        # Or create executor with user ID for lookup
         executor = HostedExecutor(
-            external_user_id="user-123",
             airbyte_client_id="client_abc123",
             airbyte_client_secret="secret_xyz789",
+            external_user_id="user-123",
             connector_definition_id="abc123-def456-ghi789",
         )
 
@@ -51,28 +58,48 @@ class HostedExecutor:
 
     def __init__(
         self,
-        external_user_id: str,
         airbyte_client_id: str,
         airbyte_client_secret: str,
-        connector_definition_id: str,
+        connector_id: str | None = None,
+        external_user_id: str | None = None,
+        connector_definition_id: str | None = None,
     ):
         """Initialize hosted executor.
 
+        Either provide connector_id directly OR (external_user_id + connector_definition_id)
+        for lookup.
+
         Args:
-            external_user_id: User identifier in the Airbyte system
             airbyte_client_id: Airbyte client ID for authentication
             airbyte_client_secret: Airbyte client secret for authentication
-            connector_definition_id: Connector definition ID used to look up
-                the user's connector.
+            connector_id: Direct connector/source ID (skips lookup if provided)
+            external_user_id: User identifier in the Airbyte system (for lookup)
+            connector_definition_id: Connector definition ID (for lookup)
+
+        Raises:
+            ValueError: If neither connector_id nor (external_user_id + connector_definition_id) provided
 
         Example:
+            # With explicit connector_id (no lookup)
+            executor = HostedExecutor(
+                airbyte_client_id="client_abc123",
+                airbyte_client_secret="secret_xyz789",
+                connector_id="existing-source-uuid",
+            )
+
+            # With lookup by user + definition
             executor = HostedExecutor(
-                external_user_id="user-123",
                 airbyte_client_id="client_abc123",
                 airbyte_client_secret="secret_xyz789",
+                external_user_id="user-123",
                 connector_definition_id="abc123-def456-ghi789",
             )
         """
+        # Validate: either connector_id OR (external_user_id + connector_definition_id) required
+        if not connector_id and not (external_user_id and connector_definition_id):
+            raise ValueError("Either connector_id OR (external_user_id + connector_definition_id) must be provided")
+
+        self._connector_id = connector_id
         self._external_user_id = external_user_id
         self._connector_definition_id = connector_definition_id
 
@@ -86,10 +113,9 @@ class HostedExecutor:
         """Execute connector via cloud API (ExecutorProtocol implementation).
 
         Flow:
-        1. Get connector definition id from executor config
-        2. Look up the user's connector ID
-        3. Execute the connector operation via the cloud API
-        4. Parse the response into ExecutionResult
+        1. Use provided connector_id or look up from external_user_id + definition_id
+        2. Execute the connector operation via the cloud API
+        3. Parse the response into ExecutionResult
 
         Args:
             config: Execution configuration (entity, action, params)
@@ -98,7 +124,7 @@ class HostedExecutor:
             ExecutionResult with success/failure status
 
         Raises:
-            ValueError: If no connector or multiple connectors found for user
+            ValueError: If no connector or multiple connectors found for user (when doing lookup)
             httpx.HTTPStatusError: If API returns 4xx/5xx status code
             httpx.RequestError: If network request fails
 
@@ -114,23 +140,26 @@ class HostedExecutor:
 
         with tracer.start_as_current_span("airbyte.hosted_executor.execute") as span:
             # Add span attributes for observability
-            span.set_attribute("connector.definition_id", self._connector_definition_id)
+            if self._connector_definition_id:
+                span.set_attribute("connector.definition_id", self._connector_definition_id)
             span.set_attribute("connector.entity", config.entity)
             span.set_attribute("connector.action", config.action)
-            span.set_attribute("user.external_id", self._external_user_id)
+            if self._external_user_id:
+                span.set_attribute("user.external_id", self._external_user_id)
             if config.params:
                 # Only add non-sensitive param keys
                 span.set_attribute("connector.param_keys", list(config.params.keys()))
 
             try:
-                # Step 1: Get connector definition id
-                connector_definition_id = self._connector_definition_id
-
-                # Step 2: Get the connector ID for this user
-                connector_id = await self._cloud_client.get_connector_id(
-                    external_user_id=self._external_user_id,
-                    connector_definition_id=connector_definition_id,
-                )
+                # Use provided connector_id or look it up
+                if self._connector_id:
+                    connector_id = self._connector_id
+                else:
+                    # Look up connector by external_user_id + definition_id
+                    connector_id = await self._cloud_client.get_connector_id(
+                        external_user_id=self._external_user_id,  # type: ignore[arg-type]
+                        connector_definition_id=self._connector_definition_id,  # type: ignore[arg-type]
+                    )
 
                 span.set_attribute("connector.connector_id", connector_id)
 

{airbyte_agent_klaviyo-0.1.1 → airbyte_agent_klaviyo-0.1.4}/airbyte_agent_klaviyo/_vendored/connector_sdk/executor/local_executor.py

@@ -36,6 +36,7 @@ from ..types import (
     EndpointDefinition,
     EntityDefinition,
 )
+from ..utils import find_matching_auth_options
 
 from .models import (
     ActionNotSupportedError,
@@ -356,8 +357,8 @@ class LocalExecutor:
     ) -> tuple[AuthOption, dict[str, SecretStr]]:
         """Infer authentication scheme from provided credentials.
 
-        Matches user credentials against each auth option's required fields
-        to determine which scheme to use.
+        Uses shared utility find_matching_auth_options to match credentials
+        against each auth option's required fields.
 
         Args:
             user_credentials: User-provided credentials
@@ -375,16 +376,8 @@ class LocalExecutor:
         # Get the credential keys provided by the user
         provided_keys = set(user_credentials.keys())
 
-        # Find all options where all required fields are present
-        matching_options: list[AuthOption] = []
-        for option in options:
-            if option.user_config_spec and option.user_config_spec.required:
-                required_fields = set(option.user_config_spec.required)
-                if required_fields.issubset(provided_keys):
-                    matching_options.append(option)
-            elif not option.user_config_spec or not option.user_config_spec.required:
-                # Option has no required fields - it matches any credentials
-                matching_options.append(option)
+        # Use shared utility to find matching options
+        matching_options = find_matching_auth_options(provided_keys, options)
 
         # Handle matching results
         if len(matching_options) == 0:
@@ -584,7 +577,7 @@ class LocalExecutor:
             return ExecutionResult(
                 success=True,
                 data={
-                    "status": "unhealthy",
+                    "status": "skipped",
                     "error": "No list operation available for health check",
                 },
             )
@@ -599,7 +592,7 @@ class LocalExecutor:
             return ExecutionResult(
                 success=True,
                 data={
-                    "status": "unhealthy",
+                    "status": "skipped",
                     "error": "No standard handler available",
                 },
             )
@@ -616,13 +609,14 @@ class LocalExecutor:
             )
         except Exception as e:
             return ExecutionResult(
-                success=True,
+                success=False,
                 data={
                     "status": "unhealthy",
                     "error": str(e),
                     "checked_entity": check_entity,
                     "checked_action": "list",
                 },
+                error=str(e),
             )
 
     async def _execute_operation(

{airbyte_agent_klaviyo-0.1.1 → airbyte_agent_klaviyo-0.1.4}/airbyte_agent_klaviyo/_vendored/connector_sdk/http/adapters/httpx_adapter.py

@@ -186,7 +186,16 @@ class HTTPXClient:
         # Try to get error message from response
         try:
             error_data = httpx_response.json()
-            error_message = error_data.get("message") or error_data.get("error") or str(error_data)
+            errors_list = error_data.get("errors")
+            if isinstance(errors_list, list):
+
+                def _extract_error(e: object) -> str:
+                    if isinstance(e, dict):
+                        return str(e.get("userPresentableMessage") or e.get("message") or e.get("error") or e)
+                    return str(e)
+
+                errors_list = ", ".join(_extract_error(e) for e in errors_list)
+            error_message = errors_list or error_data.get("message") or error_data.get("error") or str(error_data)
         except Exception:
             error_message = httpx_response.text or f"HTTP {status_code} error"
 

{airbyte_agent_klaviyo-0.1.1 → airbyte_agent_klaviyo-0.1.4}/airbyte_agent_klaviyo/_vendored/connector_sdk/schema/base.py

@@ -126,6 +126,17 @@ class Info(BaseModel):
     x_airbyte_example_questions: ExampleQuestions | None = Field(None, alias="x-airbyte-example-questions")
     x_airbyte_cache: CacheConfig | None = Field(None, alias="x-airbyte-cache")
     x_airbyte_replication_config: ReplicationConfig | None = Field(None, alias="x-airbyte-replication-config")
+    x_airbyte_skip_suggested_streams: list[str] = Field(
+        default_factory=list,
+        alias="x-airbyte-skip-suggested-streams",
+        description="List of Airbyte suggested streams to skip when validating cache entity coverage",
+    )
+    x_airbyte_skip_auth_methods: list[str] = Field(
+        default_factory=list,
+        alias="x-airbyte-skip-auth-methods",
+        description="List of Airbyte auth methods to skip when validating auth compatibility. "
+        "Use the SelectiveAuthenticator option key (e.g., 'Private App Credentials', 'oauth2.0')",
+    )
 
 
 class ServerVariable(BaseModel):

{airbyte_agent_klaviyo-0.1.1 → airbyte_agent_klaviyo-0.1.4}/airbyte_agent_klaviyo/_vendored/connector_sdk/schema/security.py

@@ -199,6 +199,11 @@ class SecurityScheme(BaseModel):
         alias="x-airbyte-token-extract",
         description="List of fields to extract from OAuth2 token responses and use as server variables",
     )
+    x_airbyte_untested: bool = Field(
+        False,
+        alias="x-airbyte-untested",
+        description="Mark this auth scheme as untested to skip cassette coverage validation",
+    )
 
     @field_validator("x_airbyte_token_extract", mode="after")
     @classmethod

{airbyte_agent_klaviyo-0.1.1 → airbyte_agent_klaviyo-0.1.4}/airbyte_agent_klaviyo/_vendored/connector_sdk/types.py

@@ -90,6 +90,10 @@ class AuthOption(BaseModel):
         None,
         description="User-facing credential specification from x-airbyte-auth-config",
     )
+    untested: bool = Field(
+        False,
+        description="Mark this auth scheme as untested to skip cassette coverage validation",
+    )
 
 
 class AuthConfig(BaseModel):