airbyte-agent-zendesk-support 0.18.29__tar.gz → 0.18.37__tar.gz

{airbyte_agent_zendesk_support-0.18.29 → airbyte_agent_zendesk_support-0.18.37}/CHANGELOG.md

@@ -1,5 +1,45 @@
 # Zendesk Support changelog
 
+## [0.18.37] - 2026-01-14
+- Updated connector definition (YAML version 0.1.4)
+- Source commit: e6285db5
+- SDK version: 0.1.0
+
+## [0.18.36] - 2026-01-14
+- Updated connector definition (YAML version 0.1.4)
+- Source commit: 31de238d
+- SDK version: 0.1.0
+
+## [0.18.35] - 2026-01-13
+- Updated connector definition (YAML version 0.1.4)
+- Source commit: e80a226e
+- SDK version: 0.1.0
+
+## [0.18.34] - 2026-01-13
+- Updated connector definition (YAML version 0.1.4)
+- Source commit: 78b1be67
+- SDK version: 0.1.0
+
+## [0.18.33] - 2026-01-11
+- Updated connector definition (YAML version 0.1.4)
+- Source commit: e519b73d
+- SDK version: 0.1.0
+
+## [0.18.32] - 2026-01-09
+- Updated connector definition (YAML version 0.1.4)
+- Source commit: 3c7bfdfd
+- SDK version: 0.1.0
+
+## [0.18.31] - 2026-01-09
+- Updated connector definition (YAML version 0.1.4)
+- Source commit: 3bcb33e8
+- SDK version: 0.1.0
+
+## [0.18.30] - 2026-01-09
+- Updated connector definition (YAML version 0.1.4)
+- Source commit: da9b741b
+- SDK version: 0.1.0
+
 ## [0.18.29] - 2026-01-07
 - Updated connector definition (YAML version 0.1.4)
 - Source commit: d023e05f

{airbyte_agent_zendesk_support-0.18.29 → airbyte_agent_zendesk_support-0.18.37}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: airbyte-agent-zendesk-support
-Version: 0.18.29
+Version: 0.18.37
 Summary: Airbyte Zendesk-Support Connector for AI platforms
 Project-URL: Homepage, https://github.com/airbytehq/airbyte-embedded
 Project-URL: Documentation, https://github.com/airbytehq/airbyte-embedded/tree/main/integrations
@@ -13,13 +13,9 @@ Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: Other/Proprietary License
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.9
+Requires-Python: >=3.13
 Requires-Dist: httpx>=0.24.0
 Requires-Dist: jinja2>=3.0.0
 Requires-Dist: jsonpath-ng>=1.6.1
@@ -141,6 +137,6 @@ For the service's official API docs, see the [Zendesk-Support API reference](htt
 
 ## Version information
 
-- **Package version:** 0.18.29
+- **Package version:** 0.18.37
 - **Connector version:** 0.1.4
-- **Generated with Connector SDK commit SHA:** d023e05f2b7a1ddabf81fab7640c64de1e0aa6a1
+- **Generated with Connector SDK commit SHA:** e6285db53fdc1d0dd43d30ef752a009226e47d48

{airbyte_agent_zendesk_support-0.18.29 → airbyte_agent_zendesk_support-0.18.37}/README.md

@@ -107,6 +107,6 @@ For the service's official API docs, see the [Zendesk-Support API reference](htt
 
 ## Version information
 
-- **Package version:** 0.18.29
+- **Package version:** 0.18.37
 - **Connector version:** 0.1.4
-- **Generated with Connector SDK commit SHA:** d023e05f2b7a1ddabf81fab7640c64de1e0aa6a1
+- **Generated with Connector SDK commit SHA:** e6285db53fdc1d0dd43d30ef752a009226e47d48

{airbyte_agent_zendesk_support-0.18.29 → airbyte_agent_zendesk_support-0.18.37}/airbyte_agent_zendesk_support/_vendored/connector_sdk/__init__.py

@@ -13,7 +13,6 @@ from __future__ import annotations
 from .auth_strategies import AuthStrategy
 from .connector_model_loader import load_connector_model
 from .constants import SDK_VERSION
-from .decorators import airbyte_description
 from .exceptions import (
     AuthenticationError,
     HTTPClientError,
@@ -80,6 +79,4 @@ __all__ = [
     "instrument",
     # Utilities
     "save_download",
-    # Decorators for AI integration
-    "airbyte_description",
 ]

{airbyte_agent_zendesk_support-0.18.29 → airbyte_agent_zendesk_support-0.18.37}/airbyte_agent_zendesk_support/_vendored/connector_sdk/connector_model_loader.py

@@ -393,16 +393,24 @@ def convert_openapi_to_connector_model(spec: OpenAPIConnector) -> ConnectorModel
     for entity_name, endpoints_dict in entities_map.items():
         actions = list(endpoints_dict.keys())
 
-        # Get schema from components if available
+        # Get schema and stream_name from components if available
         schema = None
+        entity_stream_name = None
         if spec.components:
             # Look for a schema matching the entity name
             for schema_name, schema_def in spec.components.schemas.items():
                 if schema_def.x_airbyte_entity_name == entity_name or schema_name.lower() == entity_name.lower():
                     schema = schema_def.model_dump(by_alias=True)
+                    entity_stream_name = schema_def.x_airbyte_stream_name
                     break
 
-        entity = EntityDefinition(name=entity_name, actions=actions, endpoints=endpoints_dict, schema=schema)
+        entity = EntityDefinition(
+            name=entity_name,
+            stream_name=entity_stream_name,
+            actions=actions,
+            endpoints=endpoints_dict,
+            schema=schema,
+        )
         entities.append(entity)
 
     # Extract retry config from x-airbyte-retry-config extension

{airbyte_agent_zendesk_support-0.18.29 → airbyte_agent_zendesk_support-0.18.37}/airbyte_agent_zendesk_support/_vendored/connector_sdk/constants.py

@@ -74,5 +74,5 @@ except PackageNotFoundError:
     SDK_VERSION = "0.0.0-dev"
 """Current version of the Airbyte SDK."""
 
-MINIMUM_PYTHON_VERSION = "3.9"
+MINIMUM_PYTHON_VERSION = "3.13"
 """Minimum Python version required to run the SDK."""

{airbyte_agent_zendesk_support-0.18.29 → airbyte_agent_zendesk_support-0.18.37}/airbyte_agent_zendesk_support/_vendored/connector_sdk/executor/local_executor.py

@@ -844,10 +844,58 @@ class LocalExecutor:
             return self._extract_body(endpoint.body_fields, params)
         return None
 
+    def _flatten_form_data(self, data: dict[str, Any], parent_key: str = "") -> dict[str, Any]:
+        """Flatten nested dict/list structures into bracket notation for form encoding.
+
+        Stripe and similar APIs require nested arrays/objects to be encoded using bracket
+        notation when using application/x-www-form-urlencoded content type.
+
+        Args:
+            data: Nested dict with arrays/objects to flatten
+            parent_key: Parent key for nested structures (used in recursion)
+
+        Returns:
+            Flattened dict with bracket notation keys
+
+        Examples:
+            >>> _flatten_form_data({"items": [{"price": "p1", "qty": 1}]})
+            {"items[0][price]": "p1", "items[0][qty]": 1}
+
+            >>> _flatten_form_data({"customer": "cus_123", "metadata": {"key": "value"}})
+            {"customer": "cus_123", "metadata[key]": "value"}
+        """
+        flattened = {}
+
+        for key, value in data.items():
+            new_key = f"{parent_key}[{key}]" if parent_key else key
+
+            if isinstance(value, dict):
+                # Recursively flatten nested dicts
+                flattened.update(self._flatten_form_data(value, new_key))
+            elif isinstance(value, list):
+                # Flatten arrays with indexed bracket notation
+                for i, item in enumerate(value):
+                    indexed_key = f"{new_key}[{i}]"
+                    if isinstance(item, dict):
+                        # Nested dict in array - recurse
+                        flattened.update(self._flatten_form_data(item, indexed_key))
+                    elif isinstance(item, list):
+                        # Nested list in array - recurse
+                        flattened.update(self._flatten_form_data({str(i): item}, new_key))
+                    else:
+                        # Primitive value in array
+                        flattened[indexed_key] = item
+            else:
+                # Primitive value - add directly
+                flattened[new_key] = value
+
+        return flattened
+
     def _determine_request_format(self, endpoint: EndpointDefinition, body: dict[str, Any] | None) -> dict[str, Any]:
         """Determine json/data parameters for HTTP request.
 
         GraphQL always uses JSON, regardless of content_type setting.
+        For form-encoded requests, nested structures are flattened into bracket notation.
 
         Args:
             endpoint: Endpoint definition
@@ -864,7 +912,9 @@ class LocalExecutor:
         if is_graphql or endpoint.content_type.value == "application/json":
             return {"json": body}
         elif endpoint.content_type.value == "application/x-www-form-urlencoded":
-            return {"data": body}
+            # Flatten nested structures for form encoding
+            flattened_body = self._flatten_form_data(body)
+            return {"data": flattened_body}
 
         return {}
 
@@ -1079,7 +1129,7 @@ class LocalExecutor:
         if not action:
             return 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
@@ -1209,7 +1259,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
@@ -1222,7 +1272,7 @@ class _StandardOperationHandler:
             Action.CREATE,
             Action.UPDATE,
             Action.DELETE,
-            Action.SEARCH,
+            Action.API_SEARCH,
             Action.AUTHORIZE,
         }
 

{airbyte_agent_zendesk_support-0.18.29 → airbyte_agent_zendesk_support-0.18.37}/airbyte_agent_zendesk_support/_vendored/connector_sdk/extensions.py

@@ -159,6 +159,38 @@ Example:
     ```
 """
 
+AIRBYTE_STREAM_NAME = "x-airbyte-stream-name"
+"""
+Extension: x-airbyte-stream-name
+Location: Schema object (in components.schemas)
+Type: string
+Required: No
+
+Description:
+    Specifies the Airbyte stream name for cache lookup purposes. This maps the entity
+    to the corresponding Airbyte stream, enabling cache-based data retrieval. When
+    specified, the EntityDefinition.stream_name field will be populated with this value.
+
+    This extension is placed on Schema objects alongside x-airbyte-entity-name, following
+    the same pattern. The stream name is an entity-level property (not operation-level)
+    since an entity maps to exactly one Airbyte stream.
+
+Example:
+    ```yaml
+    components:
+      schemas:
+        Customer:
+          type: object
+          x-airbyte-entity-name: customers
+          x-airbyte-stream-name: customers
+          properties:
+            id:
+              type: string
+            name:
+              type: string
+    ```
+"""
+
 AIRBYTE_TOKEN_PATH = "x-airbyte-token-path"
 """
 Extension: x-airbyte-token-path
@@ -495,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"""
@@ -514,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"]
 
 
 # =============================================================================
@@ -548,6 +580,7 @@ def get_all_extension_names() -> list[str]:
         AIRBYTE_ENTITY,
         AIRBYTE_ACTION,
         AIRBYTE_ENTITY_NAME,
+        AIRBYTE_STREAM_NAME,
         AIRBYTE_TOKEN_PATH,
         AIRBYTE_BODY_TYPE,
         AIRBYTE_PATH_OVERRIDE,
@@ -594,6 +627,12 @@ EXTENSION_REGISTRY = {
         "required": False,
         "description": "Links schema to an entity/stream",
     },
+    AIRBYTE_STREAM_NAME: {
+        "location": "schema",
+        "type": "string",
+        "required": False,
+        "description": "Maps entity to Airbyte stream for cache lookup",
+    },
     AIRBYTE_TOKEN_PATH: {
         "location": "securityScheme",
         "type": "string",

{airbyte_agent_zendesk_support-0.18.29 → airbyte_agent_zendesk_support-0.18.37}/airbyte_agent_zendesk_support/_vendored/connector_sdk/introspection.py

@@ -203,7 +203,7 @@ def generate_tool_description(model: ConnectorModelProtocol) -> str:
     - Response structure documentation with pagination hints
     - Example questions if available in the OpenAPI spec
 
-    This is used by the @airbyte_description decorator to populate
+    This is used by the Connector.describe class method decorator to populate
     function docstrings for AI framework integration.
 
     Args:
@@ -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")
 

airbyte_agent_zendesk_support-0.18.37/airbyte_agent_zendesk_support/_vendored/connector_sdk/observability/config.py

@@ -0,0 +1,179 @@
+"""Unified configuration for connector-sdk."""
+
+import logging
+import os
+import tempfile
+import uuid
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Any, Optional
+
+import yaml
+
+logger = logging.getLogger(__name__)
+
+# New config location
+CONFIG_DIR = Path.home() / ".airbyte" / "connector-sdk"
+CONFIG_PATH = CONFIG_DIR / "config.yaml"
+
+# Legacy file locations (for migration)
+LEGACY_USER_ID_PATH = Path.home() / ".airbyte" / "ai_sdk_user_id"
+LEGACY_INTERNAL_MARKER_PATH = Path.home() / ".airbyte" / "internal_user"
+
+
+@dataclass
+class SDKConfig:
+    """Connector SDK configuration."""
+
+    user_id: str = field(default_factory=lambda: str(uuid.uuid4()))
+    is_internal_user: bool = False
+
+    def to_dict(self) -> dict[str, Any]:
+        """Convert to dictionary for YAML serialization."""
+        return {
+            "user_id": self.user_id,
+            "is_internal_user": self.is_internal_user,
+        }
+
+
+def _delete_legacy_files() -> None:
+    """
+    Delete legacy config files after successful migration.
+
+    Removes:
+    - ~/.airbyte/ai_sdk_user_id
+    - ~/.airbyte/internal_user
+    """
+    for legacy_path in [LEGACY_USER_ID_PATH, LEGACY_INTERNAL_MARKER_PATH]:
+        try:
+            if legacy_path.exists():
+                legacy_path.unlink()
+                logger.debug(f"Deleted legacy config file: {legacy_path}")
+        except Exception as e:
+            logger.debug(f"Could not delete legacy file {legacy_path}: {e}")
+
+
+def _migrate_legacy_config() -> Optional[SDKConfig]:
+    """
+    Migrate from legacy file-based config to new YAML format.
+
+    Reads from:
+    - ~/.airbyte/ai_sdk_user_id (user_id)
+    - ~/.airbyte/internal_user (is_internal_user marker)
+
+    Returns SDKConfig if migration was successful, None otherwise.
+    """
+    user_id = None
+    is_internal = False
+
+    # Try to read legacy user_id
+    try:
+        if LEGACY_USER_ID_PATH.exists():
+            user_id = LEGACY_USER_ID_PATH.read_text().strip()
+            if not user_id:
+                user_id = None
+    except Exception:
+        pass
+
+    # Check legacy internal_user marker
+    try:
+        is_internal = LEGACY_INTERNAL_MARKER_PATH.exists()
+    except Exception:
+        pass
+
+    if user_id or is_internal:
+        return SDKConfig(
+            user_id=user_id or str(uuid.uuid4()),
+            is_internal_user=is_internal,
+        )
+
+    return None
+
+
+def load_config() -> SDKConfig:
+    """
+    Load SDK configuration from config file.
+
+    Checks (in order):
+    1. New config file at ~/.airbyte/connector-sdk/config.yaml
+    2. Legacy files at ~/.airbyte/ai_sdk_user_id and ~/.airbyte/internal_user
+    3. Creates new config with generated user_id if nothing exists
+
+    Environment variable AIRBYTE_INTERNAL_USER can override is_internal_user.
+
+    Returns:
+        SDKConfig with user_id and is_internal_user
+    """
+    config = None
+
+    # Try to load from new config file
+    try:
+        if CONFIG_PATH.exists():
+            content = CONFIG_PATH.read_text()
+            data = yaml.safe_load(content) or {}
+            config = SDKConfig(
+                user_id=data.get("user_id", str(uuid.uuid4())),
+                is_internal_user=data.get("is_internal_user", False),
+            )
+            # Always clean up legacy files if they exist (even if new config exists)
+            _delete_legacy_files()
+    except Exception as e:
+        logger.debug(f"Could not load config from {CONFIG_PATH}: {e}")
+
+    # Try to migrate from legacy files if new config doesn't exist
+    if config is None:
+        config = _migrate_legacy_config()
+        if config:
+            # Save migrated config to new location
+            try:
+                save_config(config)
+                logger.debug("Migrated legacy config to new location")
+                # Delete legacy files after successful migration
+                _delete_legacy_files()
+            except Exception as e:
+                logger.debug(f"Could not save migrated config: {e}")
+
+    # Create new config if nothing exists
+    if config is None:
+        config = SDKConfig()
+        try:
+            save_config(config)
+        except Exception as e:
+            logger.debug(f"Could not save new config: {e}")
+
+    # Environment variable override for is_internal_user
+    env_value = os.getenv("AIRBYTE_INTERNAL_USER", "").lower()
+    if env_value in ("true", "1", "yes"):
+        config.is_internal_user = True
+    elif env_value:
+        # Any other non-empty value (including "false", "0", "no") defaults to False
+        config.is_internal_user = False
+
+    return config
+
+
+def save_config(config: SDKConfig) -> None:
+    """
+    Save SDK configuration to config file.
+
+    Creates the config directory if it doesn't exist.
+    Uses atomic writes to prevent corruption from concurrent access.
+
+    Args:
+        config: SDKConfig to save
+    """
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+
+    # Use atomic write: write to temp file then rename (atomic on POSIX)
+    fd, temp_path = tempfile.mkstemp(dir=CONFIG_DIR, suffix=".tmp")
+    try:
+        with os.fdopen(fd, "w") as f:
+            yaml.dump(config.to_dict(), f, default_flow_style=False)
+        os.rename(temp_path, CONFIG_PATH)
+    except Exception:
+        # Clean up temp file on failure
+        try:
+            os.unlink(temp_path)
+        except OSError:
+            pass
+        raise

{airbyte_agent_zendesk_support-0.18.29 → airbyte_agent_zendesk_support-0.18.37}/airbyte_agent_zendesk_support/_vendored/connector_sdk/observability/session.py

@@ -3,46 +3,40 @@
 import logging
 import uuid
 from datetime import UTC, datetime
-from pathlib import Path
 from typing import Any, Dict, Optional
 
+from .config import SDKConfig, load_config
+
 logger = logging.getLogger(__name__)
 
+# Cache the config at module level to avoid repeated reads
+_cached_config: Optional[SDKConfig] = None
+
+
+def _get_config() -> SDKConfig:
+    """Get cached SDK config or load from file."""
+    global _cached_config
+    if _cached_config is None:
+        _cached_config = load_config()
+    return _cached_config
+
+
+def _clear_config_cache() -> None:
+    """Clear the cached config. Used for testing."""
+    global _cached_config
+    _cached_config = None
+
 
 def get_persistent_user_id() -> str:
     """
-    Get or create an anonymous user ID stored in the home directory.
+    Get the persistent anonymous user ID.
 
-    The ID is stored in ~/.airbyte/ai_sdk_user_id and persists across all sessions.
-    If the file doesn't exist, a new UUID is generated and saved.
+    Now reads from ~/.airbyte/connector-sdk/config.yaml
 
     Returns:
         An anonymous UUID string that uniquely identifies this user across sessions.
     """
-    try:
-        # Create .airbyte directory in home folder if it doesn't exist
-        airbyte_dir = Path.home() / ".airbyte"
-        airbyte_dir.mkdir(exist_ok=True)
-
-        # Path to user ID file
-        user_id_file = airbyte_dir / "ai_sdk_user_id"
-
-        # Try to read existing user ID
-        if user_id_file.exists():
-            user_id = user_id_file.read_text().strip()
-            if user_id:  # Validate it's not empty
-                return user_id
-
-        # Generate new user ID if file doesn't exist or is empty
-        user_id = str(uuid.uuid4())
-        user_id_file.write_text(user_id)
-        logger.debug(f"Generated new anonymous user ID: {user_id}")
-
-        return user_id
-    except Exception as e:
-        # If we can't read/write the file, generate a session-only ID
-        logger.debug(f"Could not access anonymous user ID file: {e}")
-        return str(uuid.uuid4())
+    return _get_config().user_id
 
 
 def get_public_ip() -> Optional[str]:
@@ -65,6 +59,18 @@ def get_public_ip() -> Optional[str]:
         return None
 
 
+def get_is_internal_user() -> bool:
+    """
+    Check if the current user is an internal Airbyte user.
+
+    Now reads from ~/.airbyte/connector-sdk/config.yaml
+    Environment variable AIRBYTE_INTERNAL_USER can override.
+
+    Returns False if not set or on any error.
+    """
+    return _get_config().is_internal_user
+
+
 class ObservabilitySession:
     """Shared session context for both logging and telemetry."""
 
@@ -84,6 +90,7 @@ class ObservabilitySession:
         self.operation_count = 0
         self.metadata: Dict[str, Any] = {}
         self.public_ip = get_public_ip()
+        self.is_internal_user = get_is_internal_user()
 
     def increment_operations(self):
         """Increment the operation counter."""

{airbyte_agent_zendesk_support-0.18.29 → airbyte_agent_zendesk_support-0.18.37}/airbyte_agent_zendesk_support/_vendored/connector_sdk/schema/components.py

@@ -65,8 +65,9 @@ class Schema(BaseModel):
     write_only: Optional[bool] = Field(None, alias="writeOnly")
     deprecated: Optional[bool] = None
 
-    # Airbyte extension
+    # Airbyte extensions
     x_airbyte_entity_name: Optional[str] = Field(None, alias="x-airbyte-entity-name")
+    x_airbyte_stream_name: Optional[str] = Field(None, alias="x-airbyte-stream-name")
 
 
 class Parameter(BaseModel):

{airbyte_agent_zendesk_support-0.18.29 → airbyte_agent_zendesk_support-0.18.37}/airbyte_agent_zendesk_support/_vendored/connector_sdk/schema/operations.py

@@ -61,7 +61,7 @@ class Operation(BaseModel):
         description=(
             "JSONPath expression to extract records from API response envelopes. "
             "When specified, executor extracts data at this path instead of returning "
-            "full response. Returns array for list/search actions, single record for "
+            "full response. Returns array for list/api_search actions, single record for "
             "get/create/update/delete actions."
         ),
     )

{airbyte_agent_zendesk_support-0.18.29 → airbyte_agent_zendesk_support-0.18.37}/airbyte_agent_zendesk_support/_vendored/connector_sdk/schema/security.py

@@ -77,6 +77,10 @@ class AuthConfigOption(BaseModel):
         default_factory=dict,
         description="Mapping from auth parameters (e.g., 'username', 'password', 'token') to template strings using ${field} syntax",
     )
+    replication_auth_key_mapping: Optional[Dict[str, str]] = Field(
+        None,
+        description="Mapping from source config paths (e.g., 'credentials.api_key') to auth config keys for direct connectors",
+    )
 
 
 class AirbyteAuthConfig(BaseModel):
@@ -99,6 +103,12 @@ class AirbyteAuthConfig(BaseModel):
     properties: Optional[Dict[str, AuthConfigFieldSpec]] = None
     auth_mapping: Optional[Dict[str, str]] = None
 
+    # Replication connector auth mapping
+    replication_auth_key_mapping: Optional[Dict[str, str]] = Field(
+        None,
+        description="Mapping from source config paths (e.g., 'credentials.api_key') to auth config keys for direct connectors",
+    )
+
     # Multiple options (oneOf)
     one_of: Optional[List[AuthConfigOption]] = Field(None, alias="oneOf")
 

{airbyte_agent_zendesk_support-0.18.29 → airbyte_agent_zendesk_support-0.18.37}/airbyte_agent_zendesk_support/_vendored/connector_sdk/telemetry/events.py

@@ -1,6 +1,6 @@
 """Telemetry event models."""
 
-from dataclasses import asdict, dataclass
+from dataclasses import asdict, dataclass, field
 from datetime import datetime
 from typing import Any, Dict, Optional
 
@@ -13,6 +13,7 @@ class BaseEvent:
     session_id: str
     user_id: str
     execution_context: str
+    is_internal_user: bool = field(default=False, kw_only=True)
 
     def to_dict(self) -> Dict[str, Any]:
         """Convert event to dictionary with ISO formatted timestamp."""

{airbyte_agent_zendesk_support-0.18.29 → airbyte_agent_zendesk_support-0.18.37}/airbyte_agent_zendesk_support/_vendored/connector_sdk/telemetry/tracker.py

@@ -59,6 +59,7 @@ class SegmentTracker:
                 session_id=self.session.session_id,
                 user_id=self.session.user_id,
                 execution_context=self.session.execution_context,
+                is_internal_user=self.session.is_internal_user,
                 public_ip=self.session.public_ip,
                 connector_name=self.session.connector_name,
                 connector_version=connector_version,
@@ -101,6 +102,7 @@ class SegmentTracker:
                 session_id=self.session.session_id,
                 user_id=self.session.user_id,
                 execution_context=self.session.execution_context,
+                is_internal_user=self.session.is_internal_user,
                 public_ip=self.session.public_ip,
                 connector_name=self.session.connector_name,
                 entity=entity,
@@ -130,6 +132,7 @@ class SegmentTracker:
                 session_id=self.session.session_id,
                 user_id=self.session.user_id,
                 execution_context=self.session.execution_context,
+                is_internal_user=self.session.is_internal_user,
                 public_ip=self.session.public_ip,
                 connector_name=self.session.connector_name,
                 duration_seconds=self.session.duration_seconds(),

{airbyte_agent_zendesk_support-0.18.29 → airbyte_agent_zendesk_support-0.18.37}/airbyte_agent_zendesk_support/_vendored/connector_sdk/types.py

@@ -22,7 +22,7 @@ class Action(str, Enum):
     UPDATE = "update"
     DELETE = "delete"
     LIST = "list"
-    SEARCH = "search"
+    API_SEARCH = "api_search"
     DOWNLOAD = "download"
     AUTHORIZE = "authorize"
 
@@ -221,6 +221,10 @@ class EntityDefinition(BaseModel):
     model_config = {"populate_by_name": True}
 
     name: str
+    stream_name: str | None = Field(
+        default=None,
+        description="Airbyte stream name for cache lookup (from x-airbyte-stream-name schema extension)",
+    )
     actions: list[Action]
     endpoints: dict[Action, EndpointDefinition]
     entity_schema: dict[str, Any] | None = Field(default=None, alias="schema")

{airbyte_agent_zendesk_support-0.18.29 → airbyte_agent_zendesk_support-0.18.37}/airbyte_agent_zendesk_support/connector.py

@@ -5,15 +5,14 @@ zendesk-support connector.
 from __future__ import annotations
 
 import logging
-from typing import TYPE_CHECKING, Any, AsyncIterator, overload
+from typing import TYPE_CHECKING, Any, Callable, TypeVar, AsyncIterator, overload
 try:
     from typing import Literal
 except ImportError:
     from typing_extensions import Literal
 
 from .connector_model import ZendeskSupportConnectorModel
-from ._vendored.connector_sdk.introspection import describe_entities
-
+from ._vendored.connector_sdk.introspection import describe_entities, generate_tool_description
 from .types import (
     ArticleAttachmentsDownloadParams,
     ArticleAttachmentsGetParams,
@@ -55,7 +54,6 @@ from .types import (
     ViewsGetParams,
     ViewsListParams,
 )
-
 if TYPE_CHECKING:
     from .models import ZendeskSupportAuthConfig
 # Import specific auth config classes for multi-auth isinstance checks
@@ -104,6 +102,9 @@ from .models import (
     ArticleAttachmentsGetResult,
 )
 
+# TypeVar for decorator type preservation
+_F = TypeVar("_F", bound=Callable[..., Any])
+
 
 class ZendeskSupportConnector:
     """
@@ -716,9 +717,46 @@ class ZendeskSupportConnector:
 
     # ===== INTROSPECTION METHODS =====
 
-    def describe(self) -> list[dict[str, Any]]:
+    @classmethod
+    def describe(cls, func: _F) -> _F:
+        """
+        Decorator that populates a function's docstring with connector capabilities.
+
+        This class method can be used as a decorator to automatically generate
+        comprehensive documentation for AI tool functions.
+
+        Usage:
+            @mcp.tool()
+            @ZendeskSupportConnector.describe
+            async def execute(entity: str, action: str, params: dict):
+                '''Execute operations.'''
+                ...
+
+        The decorated function's __doc__ will be updated with:
+        - Available entities and their actions
+        - Parameter signatures with required (*) and optional (?) markers
+        - Response structure documentation
+        - Example questions (if available in OpenAPI spec)
+
+        Args:
+            func: The function to decorate
+
+        Returns:
+            The same function with updated __doc__
+        """
+        description = generate_tool_description(ZendeskSupportConnectorModel)
+
+        original_doc = func.__doc__ or ""
+        if original_doc.strip():
+            func.__doc__ = f"{original_doc.strip()}\n{description}"
+        else:
+            func.__doc__ = description
+
+        return func
+
+    def list_entities(self) -> list[dict[str, Any]]:
         """
-        Describe available entities, actions, and parameters.
+        Get structured data about available entities, actions, and parameters.
 
         Returns a list of entity descriptions with:
         - entity_name: Name of the entity (e.g., "contacts", "deals")
@@ -727,7 +765,7 @@ class ZendeskSupportConnector:
         - parameters: Dict mapping action -> list of parameter dicts
 
         Example:
-            entities = connector.describe()
+            entities = connector.list_entities()
             for entity in entities:
                 print(f"{entity['entity_name']}: {entity['available_actions']}")
         """

{airbyte_agent_zendesk_support-0.18.29 → airbyte_agent_zendesk_support-0.18.37}/airbyte_agent_zendesk_support/connector_model.py

@@ -60,6 +60,7 @@ ZendeskSupportConnectorModel: ConnectorModel = ConnectorModel(
                         ),
                     },
                     auth_mapping={'access_token': '${access_token}', 'refresh_token': '${refresh_token}'},
+                    replication_auth_key_mapping={'access_token': 'access_token'},
                 ),
             ),
             AuthOption(
@@ -83,6 +84,7 @@ ZendeskSupportConnectorModel: ConnectorModel = ConnectorModel(
                         ),
                     },
                     auth_mapping={'username': '${email}/token', 'password': '${api_token}'},
+                    replication_auth_key_mapping={'email': 'email', 'api_token': 'api_token'},
                 ),
             ),
         ],

{airbyte_agent_zendesk_support-0.18.29 → airbyte_agent_zendesk_support-0.18.37}/airbyte_agent_zendesk_support/types.py

@@ -3,7 +3,7 @@ Type definitions for zendesk-support connector.
 """
 from __future__ import annotations
 
-# Use typing_extensions.TypedDict for Pydantic compatibility on Python < 3.12
+# Use typing_extensions.TypedDict for Pydantic compatibility
 try:
     from typing_extensions import TypedDict, NotRequired
 except ImportError:

{airbyte_agent_zendesk_support-0.18.29 → airbyte_agent_zendesk_support-0.18.37}/pyproject.toml

@@ -1,9 +1,9 @@
 [project]
 name = "airbyte-agent-zendesk-support"
-version = "0.18.29"
+version = "0.18.37"
 description = "Airbyte Zendesk-Support Connector for AI platforms"
 readme = "README.md"
-requires-python = ">=3.9"
+requires-python = ">=3.13"
 license = {text = "Elastic-2.0"}
 authors = [
     {name = "Airbyte", email = "contact@airbyte.io"}
@@ -14,10 +14,6 @@ classifiers = [
     "Intended Audience :: Developers",
     "License :: Other/Proprietary License",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
-    "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Topic :: Software Development :: Libraries :: Python Modules",
 ]

airbyte_agent_zendesk_support-0.18.29/airbyte_agent_zendesk_support/_vendored/connector_sdk/decorators.py

@@ -1,128 +0,0 @@
-"""
-Decorators for AI agent tool integration.
-
-Provides utilities to auto-generate comprehensive tool descriptions
-from connector metadata, enabling easy integration with AI frameworks.
-"""
-
-from __future__ import annotations
-
-import importlib
-from typing import Any, Callable, TypeVar
-
-from .introspection import (
-    MAX_EXAMPLE_QUESTIONS,
-    ConnectorModelProtocol,
-    EndpointProtocol,
-    generate_tool_description,
-)
-
-F = TypeVar("F", bound=Callable[..., Any])
-
-__all__ = [
-    "airbyte_description",
-    "EndpointProtocol",
-    "ConnectorModelProtocol",
-    "MAX_EXAMPLE_QUESTIONS",
-    # Private function exposed for testing
-    "_load_connector_model",
-]
-
-
-def airbyte_description(connector_name: str) -> Callable[[F], F]:
-    """
-    Decorator that generates comprehensive tool descriptions from connector metadata.
-
-    Automatically populates the function's docstring with:
-    - Connector description
-    - Available entities and their actions
-    - Example questions the connector can answer
-
-    Args:
-        connector_name: Name of the connector (e.g., "hubspot", "stripe")
-                       Must match the generated package name pattern:
-                       airbyte_agent_{connector_name}
-
-    Returns:
-        Decorator that updates the function's __doc__ attribute
-
-    Example:
-        from airbyte_agent_hubspot import HubspotConnector
-
-        connector = HubspotConnector(
-            external_user_id=external_user_id,
-            airbyte_client_id=airbyte_client_id,
-            airbyte_client_secret=airbyte_client_secret
-        )
-
-        # IMPORTANT: @airbyte_description must be the INNER decorator (closest to function)
-        # This ensures __doc__ is expanded BEFORE frameworks like FastMCP capture it
-        @agent.tool_plain  # or @mcp.tool() for FastMCP
-        @airbyte_description("hubspot")
-        async def hubspot_exec(entity: str, action: str, params: dict | None = None):
-            '''Execute HubSpot operations.'''
-            return await connector.execute(entity, action, params or {})
-
-    The decorator will update hubspot_exec.__doc__ with a comprehensive
-    description including all available entities, actions, and example questions.
-    """
-
-    def decorator(func: F) -> F:
-        # Load connector model from generated package
-        model = _load_connector_model(connector_name)
-
-        # Generate description using shared introspection module
-        description = generate_tool_description(model)
-
-        # Preserve original docstring if present, append to it
-        original_doc = func.__doc__ or ""
-        if original_doc.strip():
-            func.__doc__ = f"{original_doc.strip()}\n\n{description}"
-        else:
-            func.__doc__ = description
-
-        return func
-
-    return decorator
-
-
-def _load_connector_model(connector_name: str) -> Any:
-    """
-    Load connector model from generated package.
-
-    Args:
-        connector_name: Connector name (e.g., "hubspot")
-
-    Returns:
-        ConnectorModel instance from the generated package
-
-    Raises:
-        ImportError: If connector package is not installed
-        AttributeError: If connector model constant not found
-    """
-    # Normalize connector name to package name
-    package_name = f"airbyte_agent_{connector_name.replace('-', '_')}"
-
-    try:
-        # Import the connector_model module from the generated package
-        module = importlib.import_module(f"{package_name}.connector_model")
-    except ImportError as e:
-        raise ImportError(f"Could not import connector package '{package_name}'. " f"Ensure the package is installed. Error: {e}") from e
-
-    # Find the ConnectorModel constant (named like HubspotConnectorModel)
-    # Convention: {PascalCase connector name}ConnectorModel
-    pascal_name = "".join(word.capitalize() for word in connector_name.replace("-", "_").split("_"))
-    model_name = f"{pascal_name}ConnectorModel"
-
-    model = getattr(module, model_name, None)
-    if model is None:
-        # Fallback: look for any ConnectorModel attribute
-        for attr_name in dir(module):
-            if attr_name.endswith("ConnectorModel"):
-                model = getattr(module, attr_name)
-                break
-
-    if model is None:
-        raise AttributeError(f"Could not find ConnectorModel in {package_name}.connector_model. " f"Expected constant named '{model_name}'")
-
-    return model