airbyte-agent-zendesk-support 0.18.29__py3-none-any.whl → 0.18.31__py3-none-any.whl

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/_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/_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
@@ -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/_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:

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/_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/_vendored/connector_sdk/types.py

@@ -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/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\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.dist-info → airbyte_agent_zendesk_support-0.18.31.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: airbyte-agent-zendesk-support
-Version: 0.18.29
+Version: 0.18.31
 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
@@ -141,6 +141,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.31
 - **Connector version:** 0.1.4
-- **Generated with Connector SDK commit SHA:** d023e05f2b7a1ddabf81fab7640c64de1e0aa6a1
+- **Generated with Connector SDK commit SHA:** 3bcb33e8122bbe7f7e52f786cc94c8d2f3ba9e12

{airbyte_agent_zendesk_support-0.18.29.dist-info → airbyte_agent_zendesk_support-0.18.31.dist-info}/RECORD

@@ -1,21 +1,20 @@
 airbyte_agent_zendesk_support/__init__.py,sha256=MPz4HU055DRA3-1qgbGXh2E0YHmhcexQCFl-Tz21gm4,6227
-airbyte_agent_zendesk_support/connector.py,sha256=-myr_jxv7k37t-j3Gk0FaTL9ZuLOG1uxr0fcavTNuww,65663
+airbyte_agent_zendesk_support/connector.py,sha256=VYOTY7bEtXsvjyZSggoeS4lbSbGUsnVmtq3B2awkW5o,67058
 airbyte_agent_zendesk_support/connector_model.py,sha256=SAEWsLhW517Gc5eajkkYV1fQEGpsLlMALs2pTJ9BcPk,241131
 airbyte_agent_zendesk_support/models.py,sha256=31bsOmf4nBdf8EXN3JpYzXW8mx6gv1xaZjeuEBgSzws,36399
 airbyte_agent_zendesk_support/types.py,sha256=3CxJ8HosRMyzNEbVmRbybNCTVj9Ycxr7io25TP3YcCQ,6337
 airbyte_agent_zendesk_support/_vendored/__init__.py,sha256=ILl7AHXMui__swyrjxrh9yRa4dLiwBvV6axPWFWty80,38
-airbyte_agent_zendesk_support/_vendored/connector_sdk/__init__.py,sha256=wcf0bwjYCV6fZtMtkugUjsuUbMUl_8LjM7ojgh32eNI,2056
+airbyte_agent_zendesk_support/_vendored/connector_sdk/__init__.py,sha256=T5o7roU6NSpH-lCAGZ338sE5dlh4ZU6i6IkeG1zpems,1949
 airbyte_agent_zendesk_support/_vendored/connector_sdk/auth_strategies.py,sha256=0BfIISVzuvZTAYZjQFOOhKTpw0QuKDlLQBQ1PQo-V2M,39967
 airbyte_agent_zendesk_support/_vendored/connector_sdk/auth_template.py,sha256=vKnyA21Jp33EuDjkIUAf1PGicwk4t9kZAPJuAgAZKzU,4458
-airbyte_agent_zendesk_support/_vendored/connector_sdk/connector_model_loader.py,sha256=BeX4QykMUQZk5qY--WuwxXClI7FBDxxbGguqcztAd8A,34663
+airbyte_agent_zendesk_support/_vendored/connector_sdk/connector_model_loader.py,sha256=nKrXfe-FAyvNMkW7AqGzxrp5wXdaHiqC0yIFJoIVwlY,34890
 airbyte_agent_zendesk_support/_vendored/connector_sdk/constants.py,sha256=uH4rjBX6WsBP8M0jt7AUJI9w5Adn4wvJwib7Gdfkr1M,2736
-airbyte_agent_zendesk_support/_vendored/connector_sdk/decorators.py,sha256=849qEYLCbEI7bPbpnKaB_hYyb5SrFoWe4XMwg_vzc7Q,4376
 airbyte_agent_zendesk_support/_vendored/connector_sdk/exceptions.py,sha256=ss5MGv9eVPmsbLcLWetuu3sDmvturwfo6Pw3M37Oq5k,481
-airbyte_agent_zendesk_support/_vendored/connector_sdk/extensions.py,sha256=iWA2i0kiiGZY84H8P25A6QmfbuZwu7euMcj4-Vx2DOQ,20185
+airbyte_agent_zendesk_support/_vendored/connector_sdk/extensions.py,sha256=fWy9uwGUCjPO1KDYuGZo9nkrNU35P-dLcqi4K6UF4uA,21371
 airbyte_agent_zendesk_support/_vendored/connector_sdk/http_client.py,sha256=NdccrrBHI5rW56XnXcP54arCwywIVKnMeSQPas6KlOM,27466
-airbyte_agent_zendesk_support/_vendored/connector_sdk/introspection.py,sha256=_fdhYJIX-BsH3c55wDD7Nos2Fa6CEVmGHr-i5hEAInU,10320
+airbyte_agent_zendesk_support/_vendored/connector_sdk/introspection.py,sha256=6v3YNdca8qe8qIz3m97GZ_ll_Ih3oUKMrqrdipPcpRk,10331
 airbyte_agent_zendesk_support/_vendored/connector_sdk/secrets.py,sha256=UWcO9fP-vZwcfkAuvlZahlOCTOwdNN860BIwe8X4jxw,6868
-airbyte_agent_zendesk_support/_vendored/connector_sdk/types.py,sha256=sS9olOyT-kVemHmcFll2ePFRhTdGMbWcz7bSgV-MuSw,8114
+airbyte_agent_zendesk_support/_vendored/connector_sdk/types.py,sha256=TI-O7EyWAoppGc9G7kXHwceYWekt_sxXmXKxD1xC_7U,8285
 airbyte_agent_zendesk_support/_vendored/connector_sdk/utils.py,sha256=G4LUXOC2HzPoND2v4tQW68R9uuPX9NQyCjaGxb7Kpl0,1958
 airbyte_agent_zendesk_support/_vendored/connector_sdk/validation.py,sha256=CDjCux1eg35a0Y4BegSivzIwZjiTqOxYWotWNLqTSVU,31792
 airbyte_agent_zendesk_support/_vendored/connector_sdk/cloud_utils/__init__.py,sha256=4799Hv9f2zxDVj1aLyQ8JpTEuFTp_oOZMRz-NZCdBJg,134
@@ -43,15 +42,15 @@ airbyte_agent_zendesk_support/_vendored/connector_sdk/performance/instrumentatio
 airbyte_agent_zendesk_support/_vendored/connector_sdk/performance/metrics.py,sha256=3-wPwlJyfVLUIG3y7ESxk0avhkILk3z8K7zSrnlZf5U,2833
 airbyte_agent_zendesk_support/_vendored/connector_sdk/schema/__init__.py,sha256=Uymu-QuzGJuMxexBagIvUxpVAigIuIhz3KeBl_Vu4Ko,1638
 airbyte_agent_zendesk_support/_vendored/connector_sdk/schema/base.py,sha256=eN6YfHwsYNz_0CE-S715Me8x3gQWTtaRk1vhFjEZF8I,4799
-airbyte_agent_zendesk_support/_vendored/connector_sdk/schema/components.py,sha256=2ivMNhUAcovw88qvDkW221ILf1L63eXteztTDZL46us,7989
+airbyte_agent_zendesk_support/_vendored/connector_sdk/schema/components.py,sha256=4clYbIJNqfmFj7Te31ZqC3Rr5E2v33BeXyQx1wp3oj0,8076
 airbyte_agent_zendesk_support/_vendored/connector_sdk/schema/connector.py,sha256=VFBOzIkLgYBR1XUTmyrPGqBkX8PP-zsG8avQcdJUqXs,3864
 airbyte_agent_zendesk_support/_vendored/connector_sdk/schema/extensions.py,sha256=LdoCuMLNdCj68O47qAL4v8xmqGz5tJgRiNZL5JnL9uw,3311
 airbyte_agent_zendesk_support/_vendored/connector_sdk/schema/operations.py,sha256=zInMjx9iOEVZo-CCWw06Uk2SFg7HtUAXXpO5kFGUwNk,5825
-airbyte_agent_zendesk_support/_vendored/connector_sdk/schema/security.py,sha256=Jtrhb58d1zssN5yR7LhLJi-QK0PsZKT7uIvPqanF0co,8114
+airbyte_agent_zendesk_support/_vendored/connector_sdk/schema/security.py,sha256=Xo6Z0-NCryMY4EDZgvg8ABSPglskpXANvm_iI34meV8,8588
 airbyte_agent_zendesk_support/_vendored/connector_sdk/telemetry/__init__.py,sha256=RaLgkBU4dfxn1LC5Y0Q9rr2PJbrwjxvPgBLmq8_WafE,211
 airbyte_agent_zendesk_support/_vendored/connector_sdk/telemetry/config.py,sha256=tLmQwAFD0kP1WyBGWBS3ysaudN9H3e-3EopKZi6cGKg,885
 airbyte_agent_zendesk_support/_vendored/connector_sdk/telemetry/events.py,sha256=NvqjlUbkm6cbGh4ffKxYxtjdwwgzfPF4MKJ2GfgWeFg,1285
 airbyte_agent_zendesk_support/_vendored/connector_sdk/telemetry/tracker.py,sha256=KacNdbHatvPPhnNrycp5YUuD5xpkp56AFcHd-zguBgk,5247
-airbyte_agent_zendesk_support-0.18.29.dist-info/METADATA,sha256=_xUrBuX_Yo44RTyD4LjQ4x_QhRbf-cjlLjg7zRM2L-c,6267
-airbyte_agent_zendesk_support-0.18.29.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-airbyte_agent_zendesk_support-0.18.29.dist-info/RECORD,,
+airbyte_agent_zendesk_support-0.18.31.dist-info/METADATA,sha256=E1EP_SjDCza1bGz6jJhjkEizLuAZEvNwcfBl8cuFswY,6267
+airbyte_agent_zendesk_support-0.18.31.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+airbyte_agent_zendesk_support-0.18.31.dist-info/RECORD,,

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