airbyte-agent-zendesk-support 0.18.35__py3-none-any.whl → 0.18.42__py3-none-any.whl

airbyte_agent_zendesk_support/__init__.py

@@ -53,42 +53,26 @@ from .models import (
     ZendeskSupportExecuteResult,
     ZendeskSupportExecuteResultWithMeta,
     TicketsListResult,
-    TicketsGetResult,
     UsersListResult,
-    UsersGetResult,
     OrganizationsListResult,
-    OrganizationsGetResult,
     GroupsListResult,
-    GroupsGetResult,
     TicketCommentsListResult,
-    AttachmentsGetResult,
     TicketAuditsListResult,
     TicketMetricsListResult,
     TicketFieldsListResult,
-    TicketFieldsGetResult,
     BrandsListResult,
-    BrandsGetResult,
     ViewsListResult,
-    ViewsGetResult,
     MacrosListResult,
-    MacrosGetResult,
     TriggersListResult,
-    TriggersGetResult,
     AutomationsListResult,
-    AutomationsGetResult,
     TagsListResult,
     SatisfactionRatingsListResult,
-    SatisfactionRatingsGetResult,
     GroupMembershipsListResult,
     OrganizationMembershipsListResult,
     SlaPoliciesListResult,
-    SlaPoliciesGetResult,
     TicketFormsListResult,
-    TicketFormsGetResult,
     ArticlesListResult,
-    ArticlesGetResult,
-    ArticleAttachmentsListResult,
-    ArticleAttachmentsGetResult
+    ArticleAttachmentsListResult
 )
 from .types import (
     TicketsListParams,
@@ -133,4 +117,113 @@ from .types import (
     ArticleAttachmentsDownloadParams
 )
 
-__all__ = ["ZendeskSupportConnector", "ZendeskSupportAuthConfig", "Ticket", "User", "Organization", "Group", "TicketComment", "Attachment", "TicketAudit", "TicketMetric", "TicketField", "Brand", "View", "Macro", "Trigger", "Automation", "Tag", "SatisfactionRating", "GroupMembership", "OrganizationMembership", "SLAPolicy", "TicketForm", "Article", "ArticleAttachment", "TicketsListResultMeta", "UsersListResultMeta", "OrganizationsListResultMeta", "GroupsListResultMeta", "TicketCommentsListResultMeta", "TicketAuditsListResultMeta", "TicketMetricsListResultMeta", "TicketFieldsListResultMeta", "BrandsListResultMeta", "ViewsListResultMeta", "MacrosListResultMeta", "TriggersListResultMeta", "AutomationsListResultMeta", "TagsListResultMeta", "SatisfactionRatingsListResultMeta", "GroupMembershipsListResultMeta", "OrganizationMembershipsListResultMeta", "SlaPoliciesListResultMeta", "TicketFormsListResultMeta", "ArticlesListResultMeta", "ArticleAttachmentsListResultMeta", "ZendeskSupportExecuteResult", "ZendeskSupportExecuteResultWithMeta", "TicketsListResult", "TicketsGetResult", "UsersListResult", "UsersGetResult", "OrganizationsListResult", "OrganizationsGetResult", "GroupsListResult", "GroupsGetResult", "TicketCommentsListResult", "AttachmentsGetResult", "TicketAuditsListResult", "TicketMetricsListResult", "TicketFieldsListResult", "TicketFieldsGetResult", "BrandsListResult", "BrandsGetResult", "ViewsListResult", "ViewsGetResult", "MacrosListResult", "MacrosGetResult", "TriggersListResult", "TriggersGetResult", "AutomationsListResult", "AutomationsGetResult", "TagsListResult", "SatisfactionRatingsListResult", "SatisfactionRatingsGetResult", "GroupMembershipsListResult", "OrganizationMembershipsListResult", "SlaPoliciesListResult", "SlaPoliciesGetResult", "TicketFormsListResult", "TicketFormsGetResult", "ArticlesListResult", "ArticlesGetResult", "ArticleAttachmentsListResult", "ArticleAttachmentsGetResult", "TicketsListParams", "TicketsGetParams", "UsersListParams", "UsersGetParams", "OrganizationsListParams", "OrganizationsGetParams", "GroupsListParams", "GroupsGetParams", "TicketCommentsListParams", "AttachmentsGetParams", "AttachmentsDownloadParams", "TicketAuditsListParams", "TicketAuditsListParams", "TicketMetricsListParams", "TicketFieldsListParams", "TicketFieldsGetParams", "BrandsListParams", "BrandsGetParams", "ViewsListParams", "ViewsGetParams", "MacrosListParams", "MacrosGetParams", "TriggersListParams", "TriggersGetParams", "AutomationsListParams", "AutomationsGetParams", "TagsListParams", "SatisfactionRatingsListParams", "SatisfactionRatingsGetParams", "GroupMembershipsListParams", "OrganizationMembershipsListParams", "SlaPoliciesListParams", "SlaPoliciesGetParams", "TicketFormsListParams", "TicketFormsGetParams", "ArticlesListParams", "ArticlesGetParams", "ArticleAttachmentsListParams", "ArticleAttachmentsGetParams", "ArticleAttachmentsDownloadParams"]
+__all__ = [
+    "ZendeskSupportConnector",
+    "ZendeskSupportAuthConfig",
+    "Ticket",
+    "User",
+    "Organization",
+    "Group",
+    "TicketComment",
+    "Attachment",
+    "TicketAudit",
+    "TicketMetric",
+    "TicketField",
+    "Brand",
+    "View",
+    "Macro",
+    "Trigger",
+    "Automation",
+    "Tag",
+    "SatisfactionRating",
+    "GroupMembership",
+    "OrganizationMembership",
+    "SLAPolicy",
+    "TicketForm",
+    "Article",
+    "ArticleAttachment",
+    "TicketsListResultMeta",
+    "UsersListResultMeta",
+    "OrganizationsListResultMeta",
+    "GroupsListResultMeta",
+    "TicketCommentsListResultMeta",
+    "TicketAuditsListResultMeta",
+    "TicketMetricsListResultMeta",
+    "TicketFieldsListResultMeta",
+    "BrandsListResultMeta",
+    "ViewsListResultMeta",
+    "MacrosListResultMeta",
+    "TriggersListResultMeta",
+    "AutomationsListResultMeta",
+    "TagsListResultMeta",
+    "SatisfactionRatingsListResultMeta",
+    "GroupMembershipsListResultMeta",
+    "OrganizationMembershipsListResultMeta",
+    "SlaPoliciesListResultMeta",
+    "TicketFormsListResultMeta",
+    "ArticlesListResultMeta",
+    "ArticleAttachmentsListResultMeta",
+    "ZendeskSupportExecuteResult",
+    "ZendeskSupportExecuteResultWithMeta",
+    "TicketsListResult",
+    "UsersListResult",
+    "OrganizationsListResult",
+    "GroupsListResult",
+    "TicketCommentsListResult",
+    "TicketAuditsListResult",
+    "TicketMetricsListResult",
+    "TicketFieldsListResult",
+    "BrandsListResult",
+    "ViewsListResult",
+    "MacrosListResult",
+    "TriggersListResult",
+    "AutomationsListResult",
+    "TagsListResult",
+    "SatisfactionRatingsListResult",
+    "GroupMembershipsListResult",
+    "OrganizationMembershipsListResult",
+    "SlaPoliciesListResult",
+    "TicketFormsListResult",
+    "ArticlesListResult",
+    "ArticleAttachmentsListResult",
+    "TicketsListParams",
+    "TicketsGetParams",
+    "UsersListParams",
+    "UsersGetParams",
+    "OrganizationsListParams",
+    "OrganizationsGetParams",
+    "GroupsListParams",
+    "GroupsGetParams",
+    "TicketCommentsListParams",
+    "AttachmentsGetParams",
+    "AttachmentsDownloadParams",
+    "TicketAuditsListParams",
+    "TicketAuditsListParams",
+    "TicketMetricsListParams",
+    "TicketFieldsListParams",
+    "TicketFieldsGetParams",
+    "BrandsListParams",
+    "BrandsGetParams",
+    "ViewsListParams",
+    "ViewsGetParams",
+    "MacrosListParams",
+    "MacrosGetParams",
+    "TriggersListParams",
+    "TriggersGetParams",
+    "AutomationsListParams",
+    "AutomationsGetParams",
+    "TagsListParams",
+    "SatisfactionRatingsListParams",
+    "SatisfactionRatingsGetParams",
+    "GroupMembershipsListParams",
+    "OrganizationMembershipsListParams",
+    "SlaPoliciesListParams",
+    "SlaPoliciesGetParams",
+    "TicketFormsListParams",
+    "TicketFormsGetParams",
+    "ArticlesListParams",
+    "ArticlesGetParams",
+    "ArticleAttachmentsListParams",
+    "ArticleAttachmentsGetParams",
+    "ArticleAttachmentsDownloadParams",
+]

airbyte_agent_zendesk_support/_vendored/connector_sdk/auth_strategies.py

@@ -610,9 +610,7 @@ class OAuth2AuthStrategy(AuthStrategy):
         has_refresh_token = bool(secrets.get("refresh_token"))
 
         if not has_access_token and not has_refresh_token:
-            raise AuthenticationError(
-                "Missing OAuth2 credentials. Provide either 'access_token' " "or 'refresh_token' (for refresh-token-only mode)."
-            )
+            raise AuthenticationError("Missing OAuth2 credentials. Provide either 'access_token' or 'refresh_token' (for refresh-token-only mode).")
 
     def can_refresh(self, secrets: OAuth2RefreshSecrets) -> bool:
         """Check if token refresh is possible.
@@ -1106,8 +1104,7 @@ class AuthStrategyFactory:
         strategy = cls._strategies.get(auth_type)
         if strategy is None:
             raise AuthenticationError(
-                f"Authentication type '{auth_type.value}' is not implemented. "
-                f"Supported types: {', '.join(s.value for s in cls._strategies.keys())}"
+                f"Authentication type '{auth_type.value}' is not implemented. Supported types: {', '.join(s.value for s in cls._strategies.keys())}"
             )
         return strategy
 

airbyte_agent_zendesk_support/_vendored/connector_sdk/auth_template.py

@@ -17,7 +17,7 @@ class MissingVariableError(ValueError):
     def __init__(self, var_name: str, available_fields: list):
         self.var_name = var_name
         self.available_fields = available_fields
-        super().__init__(f"Template variable '${{{var_name}}}' not found in config. " f"Available fields: {available_fields}")
+        super().__init__(f"Template variable '${{{var_name}}}' not found in config. Available fields: {available_fields}")
 
 
 def apply_template(template: str, values: Dict[str, str]) -> str:

airbyte_agent_zendesk_support/_vendored/connector_sdk/cloud_utils/client.py

@@ -13,7 +13,7 @@ class AirbyteCloudClient:
 
     Handles authentication, token caching, and API calls to:
     - Get bearer tokens for authentication
-    - Look up connector instances for users
+    - Look up connectors for users
     - Execute connectors via the cloud API
 
     Example:
@@ -22,15 +22,15 @@ class AirbyteCloudClient:
             client_secret="your-client-secret"
         )
 
-        # Get a connector instance
-        instance_id = await client.get_connector_instance_id(
+        # Get a connector ID
+        connector_id = await client.get_connector_id(
             external_user_id="user-123",
-            connector_definition_id="stripe-def-456"
+            connector_definition_id="550e8400-e29b-41d4-a716-446655440000"
         )
 
         # Execute the connector
         result = await client.execute_connector(
-            instance_id=instance_id,
+            connector_id=connector_id,
             entity="customers",
             action="list",
             params={"limit": 10}
@@ -105,37 +105,37 @@ class AirbyteCloudClient:
 
         return access_token
 
-    async def get_connector_instance_id(
+    async def get_connector_id(
         self,
         external_user_id: str,
         connector_definition_id: str,
     ) -> str:
-        """Get connector instance ID for a user.
+        """Get connector ID for a user.
 
-        Looks up the connector instance that belongs to the specified user
-        and connector definition. Validates that exactly one instance exists.
+        Looks up the connector that belongs to the specified user
+        and connector definition. Validates that exactly one connector exists.
 
         Args:
             external_user_id: User identifier in the Airbyte system
             connector_definition_id: UUID of the connector definition
 
         Returns:
-            Connector instance ID (UUID string)
+            Connector ID (UUID string)
 
         Raises:
-            ValueError: If 0 or more than 1 instance is found
+            ValueError: If 0 or more than 1 connector is found
             httpx.HTTPStatusError: If API returns 4xx/5xx status code
             httpx.RequestError: If network request fails
 
         Example:
-            instance_id = await client.get_connector_instance_id(
+            connector_id = await client.get_connector_id(
                 external_user_id="user-123",
                 connector_definition_id="550e8400-e29b-41d4-a716-446655440000"
             )
         """
 
         token = await self.get_bearer_token()
-        url = f"{self.API_BASE_URL}/api/v1/connectors/instances_for_user"
+        url = f"{self.API_BASE_URL}/api/v1/connectors/connectors_for_user"
         params = {
             "external_user_id": external_user_id,
             "definition_id": connector_definition_id,
@@ -146,24 +146,24 @@ class AirbyteCloudClient:
         response.raise_for_status()
 
         data = response.json()
-        instances = data["instances"]
+        connectors = data["connectors"]
 
-        if len(instances) == 0:
-            raise ValueError(f"No connector instance found for user '{external_user_id}' " f"and connector '{connector_definition_id}'")
+        if len(connectors) == 0:
+            raise ValueError(f"No connector found for user '{external_user_id}' and connector definition '{connector_definition_id}'")
 
-        if len(instances) > 1:
+        if len(connectors) > 1:
             raise ValueError(
-                f"Multiple connector instances found for user '{external_user_id}' "
-                f"and connector '{connector_definition_id}'. Expected exactly 1, "
-                f"found {len(instances)}"
+                f"Multiple connectors found for user '{external_user_id}' "
+                f"and connector definition '{connector_definition_id}'. Expected exactly 1, "
+                f"found {len(connectors)}"
             )
 
-        instance_id = instances[0]["id"]
-        return instance_id
+        connector_id = connectors[0]["id"]
+        return connector_id
 
     async def execute_connector(
         self,
-        instance_id: str,
+        connector_id: str,
         entity: str,
         action: str,
         params: dict[str, Any] | None,
@@ -171,7 +171,7 @@ class AirbyteCloudClient:
         """Execute a connector operation.
 
         Args:
-            instance_id: Connector instance UUID
+            connector_id: Connector UUID (source ID)
             entity: Entity name (e.g., "customers", "invoices")
             action: Operation action (e.g., "list", "get", "create")
             params: Optional parameters for the operation
@@ -185,14 +185,14 @@ class AirbyteCloudClient:
 
         Example:
             result = await client.execute_connector(
-                instance_id="inst-123",
+                connector_id="550e8400-e29b-41d4-a716-446655440000",
                 entity="customers",
                 action="list",
                 params={"limit": 10}
             )
         """
         token = await self.get_bearer_token()
-        url = f"{self.API_BASE_URL}/api/v1/connectors/instances/{instance_id}/execute"
+        url = f"{self.API_BASE_URL}/api/v1/connectors/sources/{connector_id}/execute"
         headers = {"Authorization": f"Bearer {token}"}
         request_body = {
             "entity": entity,

airbyte_agent_zendesk_support/_vendored/connector_sdk/connector_model_loader.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import logging
 import re
 from pathlib import Path
 from typing import Any
@@ -768,8 +769,6 @@ def _parse_auth_from_openapi(spec: OpenAPIConnector) -> AuthConfig:
             options.append(auth_option)
         except Exception as e:
             # Log warning but continue - skip invalid schemes
-            import logging
-
             logger = logging.getLogger(__name__)
             logger.warning(f"Skipping invalid security scheme '{scheme_name}': {e}")
             continue

airbyte_agent_zendesk_support/_vendored/connector_sdk/executor/hosted_executor.py

@@ -21,7 +21,7 @@ class HostedExecutor:
 
     The executor takes an external_user_id and uses the AirbyteCloudClient to:
     1. Authenticate with the Airbyte Platform (bearer token with caching)
-    2. Look up the user's connector instance
+    2. Look up the user's connector
     3. Execute the connector operation via the cloud API
 
     Implements ExecutorProtocol.
@@ -63,7 +63,7 @@ class HostedExecutor:
             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 instance.
+                the user's connector.
 
         Example:
             executor = HostedExecutor(
@@ -86,8 +86,8 @@ class HostedExecutor:
         """Execute connector via cloud API (ExecutorProtocol implementation).
 
         Flow:
-        1. Get connector id from connector model
-        2. Look up the user's connector instance ID
+        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
 
@@ -98,7 +98,7 @@ class HostedExecutor:
             ExecutionResult with success/failure status
 
         Raises:
-            ValueError: If no instance or multiple instances found for user
+            ValueError: If no connector or multiple connectors found for user
             httpx.HTTPStatusError: If API returns 4xx/5xx status code
             httpx.RequestError: If network request fails
 
@@ -126,24 +126,23 @@ class HostedExecutor:
                 # Step 1: Get connector definition id
                 connector_definition_id = self._connector_definition_id
 
-                # Step 2: Get the connector instance ID for this user
-                instance_id = await self._cloud_client.get_connector_instance_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,
                 )
 
-                span.set_attribute("connector.instance_id", instance_id)
+                span.set_attribute("connector.connector_id", connector_id)
 
                 # Step 3: Execute the connector via the cloud API
                 response = await self._cloud_client.execute_connector(
-                    instance_id=instance_id,
+                    connector_id=connector_id,
                     entity=config.entity,
                     action=config.action,
                     params=config.params,
                 )
 
                 # Step 4: Parse the response into ExecutionResult
-                # The response_data is a dict from the API
                 result = self._parse_execution_result(response)
 
                 # Mark span as successful
@@ -152,7 +151,7 @@ class HostedExecutor:
                 return result
 
             except ValueError as e:
-                # Instance lookup validation error (0 or >1 instances)
+                # Connector lookup validation error (0 or >1 connectors)
                 span.set_attribute("connector.success", False)
                 span.set_attribute("connector.error_type", "ValueError")
                 span.record_exception(e)

airbyte_agent_zendesk_support/_vendored/connector_sdk/executor/local_executor.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 import asyncio
+import inspect
 import logging
 import os
 import re
@@ -11,6 +12,7 @@ from collections.abc import AsyncIterator
 from typing import Any, Protocol
 from urllib.parse import quote
 
+from jinja2 import Environment, StrictUndefined
 from jsonpath_ng import parse as parse_jsonpath
 from opentelemetry import trace
 
@@ -506,8 +508,6 @@ class LocalExecutor:
             result = handler.execute_operation(config.entity, action, params)
 
             # Check if it's an async generator (download) or awaitable (standard)
-            import inspect
-
             if inspect.isasyncgen(result):
                 # Download operation: return generator directly
                 return ExecutionResult(
@@ -814,7 +814,6 @@ class LocalExecutor:
             >>> _substitute_file_field_params("attachments[{attachment_index}].url", {"attachment_index": 0})
             "attachments[0].url"
         """
-        from jinja2 import Environment, StrictUndefined
 
         # Use custom delimiters to match OpenAPI path parameter syntax {var}
         # StrictUndefined raises clear error if a template variable is missing
@@ -1099,37 +1098,95 @@ class LocalExecutor:
 
         return interpolate_value(variables)
 
+    def _wrap_primitives(self, data: Any) -> dict[str, Any] | list[dict[str, Any]] | None:
+        """Wrap primitive values in dict format for consistent response structure.
+
+        Transforms primitive API responses into dict format so downstream code
+        can always expect dict-based data structures.
+
+        Args:
+            data: Response data (could be primitive, list, dict, or None)
+
+        Returns:
+            - If data is a primitive (str, int, float, bool): {"value": data}
+            - If data is a list: wraps all non-dict elements as {"value": item}
+            - If data is already a dict or list of dicts: unchanged
+            - If data is None: None
+
+        Examples:
+            >>> executor._wrap_primitives(42)
+            {"value": 42}
+            >>> executor._wrap_primitives([1, 2, 3])
+            [{"value": 1}, {"value": 2}, {"value": 3}]
+            >>> executor._wrap_primitives([1, {"id": 2}, 3])
+            [{"value": 1}, {"id": 2}, {"value": 3}]
+            >>> executor._wrap_primitives([[1, 2], 3])
+            [{"value": [1, 2]}, {"value": 3}]
+            >>> executor._wrap_primitives({"id": 1})
+            {"id": 1}  # unchanged
+        """
+        if data is None:
+            return None
+
+        # Handle primitive scalars
+        if isinstance(data, (bool, str, int, float)):
+            return {"value": data}
+
+        # Handle lists - wrap non-dict elements
+        if isinstance(data, list):
+            if not data:
+                return []  # Empty list unchanged
+
+            wrapped = []
+            for item in data:
+                if isinstance(item, dict):
+                    wrapped.append(item)
+                else:
+                    wrapped.append({"value": item})
+            return wrapped
+
+        # Dict - return unchanged
+        if isinstance(data, dict):
+            return data
+
+        # Unknown type - wrap for safety
+        return {"value": data}
+
     def _extract_records(
         self,
-        response_data: dict[str, Any],
+        response_data: Any,
         endpoint: EndpointDefinition,
-    ) -> dict[str, Any] | list[Any] | None:
+    ) -> dict[str, Any] | list[dict[str, Any]] | None:
         """Extract records from response using record extractor.
 
         Type inference based on action:
         - list, search: Returns array ([] if not found)
         - get, create, update, delete: Returns single record (None if not found)
 
+        Automatically wraps primitive values (int, str, float, bool) in {"value": primitive}
+        format to ensure consistent dict-based responses for downstream code.
+
         Args:
-            response_data: Full API response
+            response_data: Full API response (can be dict, list, primitive, or None)
             endpoint: Endpoint with optional record extractor and action
 
         Returns:
             - Extracted data if extractor configured and path found
             - [] or None if path not found (based on action)
             - Original response if no extractor configured or on error
+            - Primitives are wrapped as {"value": primitive}
         """
         # Check if endpoint has record extractor
         extractor = endpoint.record_extractor
         if not extractor:
-            return response_data
+            return self._wrap_primitives(response_data)
 
         # Determine if this action returns array or single record
         action = endpoint.action
         if not action:
-            return response_data
+            return self._wrap_primitives(response_data)
 
-        is_array_action = action in (Action.LIST, Action.SEARCH)
+        is_array_action = action in (Action.LIST, Action.API_SEARCH)
 
         try:
             # Parse and apply JSONPath expression
@@ -1140,17 +1197,19 @@ class LocalExecutor:
                 # Path not found - return empty based on action
                 return [] if is_array_action else None
 
-            # Return extracted data
+            # Return extracted data with primitive wrapping
             if is_array_action:
                 # For array actions, return the array (or list of matches)
-                return matches[0] if len(matches) == 1 else matches
+                result = matches[0] if len(matches) == 1 else matches
             else:
                 # For single record actions, return first match
-                return matches[0]
+                result = matches[0]
+
+            return self._wrap_primitives(result)
 
         except Exception as e:
             logging.warning(f"Failed to apply record extractor '{extractor}': {e}. Returning original response.")
-            return response_data
+            return self._wrap_primitives(response_data)
 
     def _extract_metadata(
         self,
@@ -1235,7 +1294,7 @@ class LocalExecutor:
 
         if missing_fields:
             raise MissingParameterError(
-                f"Missing required body fields for {entity}.{action.value}: {missing_fields}. " f"Provided parameters: {list(params.keys())}"
+                f"Missing required body fields for {entity}.{action.value}: {missing_fields}. Provided parameters: {list(params.keys())}"
             )
 
     async def close(self):
@@ -1259,7 +1318,7 @@ class LocalExecutor:
 
 
 class _StandardOperationHandler:
-    """Handler for standard REST operations (GET, LIST, CREATE, UPDATE, DELETE, SEARCH, AUTHORIZE)."""
+    """Handler for standard REST operations (GET, LIST, CREATE, UPDATE, DELETE, API_SEARCH, AUTHORIZE)."""
 
     def __init__(self, context: _OperationContext):
         self.ctx = context
@@ -1272,7 +1331,7 @@ class _StandardOperationHandler:
             Action.CREATE,
             Action.UPDATE,
             Action.DELETE,
-            Action.SEARCH,
+            Action.API_SEARCH,
             Action.AUTHORIZE,
         }
 

airbyte_agent_zendesk_support/_vendored/connector_sdk/extensions.py

@@ -527,8 +527,8 @@ class ActionType(str, Enum):
     DELETE = "delete"
     """Delete a record"""
 
-    SEARCH = "search"
-    """Search for records matching specific query criteria"""
+    API_SEARCH = "api_search"
+    """Search for records matching specific query criteria via API"""
 
     DOWNLOAD = "download"
     """Download file content from a URL specified in the metadata response"""
@@ -546,7 +546,7 @@ class BodyType(str, Enum):
 
 
 # Type alias for use in Pydantic models
-ActionTypeLiteral = Literal["get", "list", "create", "update", "delete", "search", "download"]
+ActionTypeLiteral = Literal["get", "list", "create", "update", "delete", "api_search", "download"]
 
 
 # =============================================================================
@@ -666,8 +666,7 @@ EXTENSION_REGISTRY = {
         "type": "dict[str, str]",
         "required": False,
         "description": (
-            "Dictionary mapping field names to JSONPath expressions for extracting metadata "
-            "(pagination, request IDs, etc.) from response envelopes"
+            "Dictionary mapping field names to JSONPath expressions for extracting metadata (pagination, request IDs, etc.) from response envelopes"
         ),
     },
     AIRBYTE_FILE_URL: {

airbyte_agent_zendesk_support/_vendored/connector_sdk/http/response.py

@@ -80,6 +80,8 @@ class HTTPResponse:
             HTTPStatusError: For 4xx or 5xx status codes.
         """
         if 400 <= self._status_code < 600:
+            # NOTE: Import here intentionally to avoid circular import.
+            # exceptions.py imports HTTPResponse for type hints.
             from .exceptions import HTTPStatusError
 
             raise HTTPStatusError(

airbyte_agent_zendesk_support/_vendored/connector_sdk/introspection.py

@@ -232,7 +232,7 @@ def generate_tool_description(model: ConnectorModelProtocol) -> str:
     # Response structure (brief, includes pagination hint)
     lines.append("")
     lines.append("RESPONSE STRUCTURE:")
-    lines.append("  - list/search: {data: [...], meta: {has_more: bool}}")
+    lines.append("  - list/api_search: {data: [...], meta: {has_more: bool}}")
     lines.append("  - get: Returns entity directly (no envelope)")
     lines.append("  To paginate: pass starting_after=<last_id> while has_more is true")