airbyte-agent-zendesk-chat 0.1.15__tar.gz → 0.1.20__tar.gz

{airbyte_agent_zendesk_chat-0.1.15 → airbyte_agent_zendesk_chat-0.1.20}/AUTH.md

@@ -10,10 +10,15 @@ In open source mode, you provide API credentials directly to the connector.
 
 #### OAuth
 
+`credentials` fields you need:
+
+
 | Field Name | Type | Required | Description |
 |------------|------|----------|-------------|
 | `access_token` | `str` | Yes | Your Zendesk Chat OAuth 2.0 access token |
 
+Example request:
+
 ```python
 from airbyte_agent_zendesk-chat import ZendeskChatConnector
 from airbyte_agent_zendesk-chat.models import ZendeskChatAuthConfig
@@ -33,19 +38,36 @@ This authentication method isn't available for this connector.
 In hosted mode, you first create a connector via the Airbyte API (providing your OAuth or Token credentials), then execute operations using either the Python SDK or API. If you need a step-by-step guide, see the [hosted execution tutorial](https://docs.airbyte.com/ai-agents/quickstarts/tutorial-hosted).
 
 #### OAuth
+Create a connector with OAuth credentials.
+
+`credentials` fields you need:
 
-Create a connector with OAuth credentials:
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `access_token` | `str` | Yes | Your Zendesk Chat OAuth 2.0 access token |
+
+`replication_config` fields you need:
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `start_date` | `str (date-time)` | Yes | The date from which to start replicating data, in the format YYYY-MM-DDT00:00:00Z. |
+
+Example request:
 
 ```bash
-curl -X POST 'https://api.airbyte.ai/v1/integrations/connectors' \
-  -H 'Authorization: Bearer <SCOPED_TOKEN>' \
-  -H 'Content-Type: application/json' \
+curl -X POST "https://api.airbyte.ai/v1/integrations/connectors" \
+  -H "Authorization: Bearer <SCOPED_TOKEN>" \
+  -H "Content-Type: application/json" \
   -d '{
     "external_user_id": "<EXTERNAL_USER_ID>",
     "connector_type": "Zendesk-Chat",
     "name": "My Zendesk-Chat Connector",
     "credentials": {
       "access_token": "<Your Zendesk Chat OAuth 2.0 access token>"
+    },
+    "replication_config": {
+      "start_date": "<The date from which to start replicating data, in the format YYYY-MM-DDT00:00:00Z.>"
     }
   }'
 ```

{airbyte_agent_zendesk_chat-0.1.15 → airbyte_agent_zendesk_chat-0.1.20}/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Zendesk Chat changelog
 
+## [0.1.20] - 2026-01-28
+- Updated connector definition (YAML version 0.1.6)
+- Source commit: f6c6fca2
+- SDK version: 0.1.0
+
+## [0.1.19] - 2026-01-28
+- Updated connector definition (YAML version 0.1.6)
+- Source commit: 9aef9bd2
+- SDK version: 0.1.0
+
+## [0.1.18] - 2026-01-28
+- Updated connector definition (YAML version 0.1.5)
+- Source commit: 71f48c10
+- SDK version: 0.1.0
+
+## [0.1.17] - 2026-01-27
+- Updated connector definition (YAML version 0.1.5)
+- Source commit: 0f5e1914
+- SDK version: 0.1.0
+
+## [0.1.16] - 2026-01-27
+- Updated connector definition (YAML version 0.1.5)
+- Source commit: a01f6b16
+- SDK version: 0.1.0
+
 ## [0.1.15] - 2026-01-27
 - Updated connector definition (YAML version 0.1.5)
 - Source commit: c9b05509

{airbyte_agent_zendesk_chat-0.1.15 → airbyte_agent_zendesk_chat-0.1.20}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: airbyte-agent-zendesk-chat
-Version: 0.1.15
+Version: 0.1.20
 Summary: Airbyte Zendesk-Chat Connector for AI platforms
 Project-URL: Homepage, https://github.com/airbytehq/airbyte-agent-connectors
 Project-URL: Documentation, https://docs.airbyte.com/ai-agents/
@@ -130,13 +130,11 @@ async def zendesk-chat_execute(entity: str, action: str, params: dict | None = N
     return await connector.execute(entity, action, params or {})
 ```
 
-## Replication Configuration
-
-This connector supports replication configuration for MULTI mode sources. See the [full reference documentation](./REFERENCE.md#replication-configuration) for details on available options like `start_date`.
-
 ## Full documentation
 
-This connector supports the following entities and actions.
+### Entities and actions
+
+This connector supports the following entities and actions. For more details, see this connector's [full reference documentation](REFERENCE.md).
 
 | Entity | Actions |
 |--------|---------|
@@ -154,14 +152,16 @@ This connector supports the following entities and actions.
 | Triggers | [List](./REFERENCE.md#triggers-list) |
 
 
-For all authentication options, see the connector's [authentication documentation](AUTH.md).
+### Authentication and configuration
+
+For all authentication and configuration options, see the connector's [authentication documentation](AUTH.md).
 
-For detailed documentation on available actions and parameters, see this connector's [full reference documentation](./REFERENCE.md).
+### Zendesk-Chat API docs
 
-For the service's official API docs, see the [Zendesk-Chat API reference](https://developer.zendesk.com/api-reference/live-chat/chat-api/introduction/).
+See the official [Zendesk-Chat API reference](https://developer.zendesk.com/api-reference/live-chat/chat-api/introduction/).
 
 ## Version information
 
-- **Package version:** 0.1.15
-- **Connector version:** 0.1.5
-- **Generated with Connector SDK commit SHA:** c9b05509eb899e313055660f378d9c1f1e9129c7
+- **Package version:** 0.1.20
+- **Connector version:** 0.1.6
+- **Generated with Connector SDK commit SHA:** f6c6fca292b291b200b31e4056856465129ae703

{airbyte_agent_zendesk_chat-0.1.15 → airbyte_agent_zendesk_chat-0.1.20}/README.md

@@ -97,13 +97,11 @@ async def zendesk-chat_execute(entity: str, action: str, params: dict | None = N
     return await connector.execute(entity, action, params or {})
 ```
 
-## Replication Configuration
-
-This connector supports replication configuration for MULTI mode sources. See the [full reference documentation](./REFERENCE.md#replication-configuration) for details on available options like `start_date`.
-
 ## Full documentation
 
-This connector supports the following entities and actions.
+### Entities and actions
+
+This connector supports the following entities and actions. For more details, see this connector's [full reference documentation](REFERENCE.md).
 
 | Entity | Actions |
 |--------|---------|
@@ -121,14 +119,16 @@ This connector supports the following entities and actions.
 | Triggers | [List](./REFERENCE.md#triggers-list) |
 
 
-For all authentication options, see the connector's [authentication documentation](AUTH.md).
+### Authentication and configuration
+
+For all authentication and configuration options, see the connector's [authentication documentation](AUTH.md).
 
-For detailed documentation on available actions and parameters, see this connector's [full reference documentation](./REFERENCE.md).
+### Zendesk-Chat API docs
 
-For the service's official API docs, see the [Zendesk-Chat API reference](https://developer.zendesk.com/api-reference/live-chat/chat-api/introduction/).
+See the official [Zendesk-Chat API reference](https://developer.zendesk.com/api-reference/live-chat/chat-api/introduction/).
 
 ## Version information
 
-- **Package version:** 0.1.15
-- **Connector version:** 0.1.5
-- **Generated with Connector SDK commit SHA:** c9b05509eb899e313055660f378d9c1f1e9129c7
+- **Package version:** 0.1.20
+- **Connector version:** 0.1.6
+- **Generated with Connector SDK commit SHA:** f6c6fca292b291b200b31e4056856465129ae703

{airbyte_agent_zendesk_chat-0.1.15 → airbyte_agent_zendesk_chat-0.1.20}/REFERENCE.md

@@ -1467,35 +1467,3 @@ curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_i
 
 </details>
 
-
-
-## Replication Configuration
-
-Settings for data replication from Zendesk Chat
-
-These settings control how data is replicated from the source. Pass them via the `replication_config` parameter when creating a source.
-
-| Field Name | Type | Required | Description |
-|------------|------|----------|-------------|
-| `start_date` | `str (date-time)` | Yes | The date from which to start replicating data, in the format YYYY-MM-DDT00:00:00Z. |
-
-### Example
-
-**API**
-
-```bash
-curl --location 'https://api.airbyte.ai/integrations/connectors' \
---header 'Content-Type: application/json' \
---header 'Authorization: Bearer {your_auth_token}' \
---data '{
-  "external_user_id": "{your_external_user_id}",
-  "connector_type": "zendesk-chat",
-  "credentials": {
-    ...
-  },
-  "replication_config": {
-    "start_date": "<The date from which to start replicating data, in the format YYYY-MM-DDT00:00:00Z.>"
-  },
-  "name": "My Zendesk-Chat Connector"
-}'
-```

{airbyte_agent_zendesk_chat-0.1.15 → airbyte_agent_zendesk_chat-0.1.20}/airbyte_agent_zendesk_chat/__init__.py

@@ -14,10 +14,10 @@ from .models import (
     AgentRoles,
     AgentTimeline,
     Ban,
+    ChatEngagement,
     ChatHistoryItem,
     ChatConversion,
     WebpathItem,
-    ChatEngagement,
     Chat,
     Visitor,
     ChatSession,
@@ -109,10 +109,10 @@ __all__ = [
     "AgentRoles",
     "AgentTimeline",
     "Ban",
+    "ChatEngagement",
     "ChatHistoryItem",
     "ChatConversion",
     "WebpathItem",
-    "ChatEngagement",
     "Chat",
     "Visitor",
     "ChatSession",

{airbyte_agent_zendesk_chat-0.1.15 → airbyte_agent_zendesk_chat-0.1.20}/airbyte_agent_zendesk_chat/_vendored/connector_sdk/http_client.py

@@ -490,7 +490,7 @@ class HTTPClient:
 
                 if not response_text.strip():
                     response_data = {}
-                elif "application/json" in content_type or not content_type:
+                elif "application/json" in content_type or "+json" in content_type or not content_type:
                     response_data = await response.json()
                 else:
                     error_msg = f"Expected JSON response for {method.upper()} {url}, got content-type: {content_type}"

{airbyte_agent_zendesk_chat-0.1.15 → airbyte_agent_zendesk_chat-0.1.20}/airbyte_agent_zendesk_chat/_vendored/connector_sdk/introspection.py

@@ -380,7 +380,11 @@ def describe_entities(model: ConnectorModelProtocol) -> list[dict[str, Any]]:
     return entities
 
 
-def generate_tool_description(model: ConnectorModelProtocol) -> str:
+def generate_tool_description(
+    model: ConnectorModelProtocol,
+    *,
+    enable_hosted_mode_features: bool = True,
+) -> str:
     """Generate AI tool description from connector metadata.
 
     Produces a detailed description that includes:
@@ -393,6 +397,7 @@ def generate_tool_description(model: ConnectorModelProtocol) -> str:
 
     Args:
         model: Object conforming to ConnectorModelProtocol (e.g., ConnectorModel)
+        enable_hosted_mode_features: When False, omit hosted-mode search guidance from the docstring.
 
     Returns:
         Formatted description string suitable for AI tool documentation
@@ -402,8 +407,9 @@ def generate_tool_description(model: ConnectorModelProtocol) -> str:
     # at the first empty line and only keeps the initial section.
 
     # Entity/action parameter details (including pagination params like limit, starting_after)
-    search_field_paths = _collect_search_field_paths(model)
-    lines.append("ENTITIES AND PARAMETERS:")
+    search_field_paths = _collect_search_field_paths(model) if enable_hosted_mode_features else {}
+    # Avoid a "PARAMETERS:" header because some docstring parsers treat it as a params section marker.
+    lines.append("ENTITIES (ACTIONS + PARAMS):")
     for entity in model.entities:
         lines.append(f"  {entity.name}:")
         actions = getattr(entity, "actions", []) or []
@@ -427,8 +433,9 @@ def generate_tool_description(model: ConnectorModelProtocol) -> str:
     lines.append("  To paginate: pass starting_after=<last_id> while has_more is true")
 
     lines.append("GUIDELINES:")
-    lines.append('  - Prefer cached search over direct API calls when using execute(): action="search" whenever possible.')
-    lines.append("  - Direct API actions (list/get/download) are slower and should be used only if search cannot answer the query.")
+    if enable_hosted_mode_features:
+        lines.append('  - Prefer cached search over direct API calls when using execute(): action="search" whenever possible.')
+        lines.append("  - Direct API actions (list/get/download) are slower and should be used only if search cannot answer the query.")
     lines.append("  - Keep results small: use params.fields, params.query.filter, small params.limit, and cursor pagination.")
     lines.append("  - If output is too large, refine the query with tighter filters/fields/limit.")
 

{airbyte_agent_zendesk_chat-0.1.15 → airbyte_agent_zendesk_chat-0.1.20}/airbyte_agent_zendesk_chat/connector.py

@@ -136,7 +136,7 @@ class ZendeskChatConnector:
     """
 
     connector_name = "zendesk-chat"
-    connector_version = "0.1.5"
+    connector_version = "0.1.6"
     vendored_sdk_version = "0.1.0"  # Version of vendored connector-sdk
 
     # Map of (entity, action) -> needs_envelope for envelope wrapping decision
@@ -520,6 +520,7 @@ class ZendeskChatConnector:
         func: _F | None = None,
         *,
         update_docstring: bool = True,
+        enable_hosted_mode_features: bool = True,
         max_output_chars: int | None = DEFAULT_MAX_OUTPUT_CHARS,
     ) -> _F | Callable[[_F], _F]:
         """
@@ -538,12 +539,16 @@ class ZendeskChatConnector:
 
         Args:
             update_docstring: When True, append connector capabilities to __doc__.
+            enable_hosted_mode_features: When False, omit hosted-mode search sections from docstrings.
             max_output_chars: Max serialized output size before raising. Use None to disable.
         """
 
         def decorate(inner: _F) -> _F:
             if update_docstring:
-                description = generate_tool_description(ZendeskChatConnectorModel)
+                description = generate_tool_description(
+                    ZendeskChatConnectorModel,
+                    enable_hosted_mode_features=enable_hosted_mode_features,
+                )
                 original_doc = inner.__doc__ or ""
                 if original_doc.strip():
                     full_doc = f"{original_doc.strip()}\n{description}"

{airbyte_agent_zendesk_chat-0.1.15 → airbyte_agent_zendesk_chat-0.1.20}/airbyte_agent_zendesk_chat/connector_model.py

@@ -26,7 +26,7 @@ from uuid import (
 ZendeskChatConnectorModel: ConnectorModel = ConnectorModel(
     id=UUID('40d24d0f-b8f9-4fe0-9e6c-b06c0f3f45e4'),
     name='zendesk-chat',
-    version='0.1.5',
+    version='0.1.6',
     base_url='https://{subdomain}.zendesk.com/api/v2/chat',
     auth=AuthConfig(
         type=AuthType.BEARER,

{airbyte_agent_zendesk_chat-0.1.15 → airbyte_agent_zendesk_chat-0.1.20}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "airbyte-agent-zendesk-chat"
-version = "0.1.15"
+version = "0.1.20"
 description = "Airbyte Zendesk-Chat Connector for AI platforms"
 readme = "README.md"
 requires-python = ">=3.13"

{airbyte_agent_zendesk_chat-0.1.15 → airbyte_agent_zendesk_chat-0.1.20}/airbyte_agent_zendesk_chat/models.py

@@ -132,6 +132,27 @@ class Ban(BaseModel):
     reason: Union[str | None, Any] = Field(default=None)
     created_at: Union[str | None, Any] = Field(default=None)
 
+class ChatEngagement(BaseModel):
+    """ChatEngagement type definition"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    id: Union[str | None, Any] = Field(default=None)
+    agent_id: Union[str | None, Any] = Field(default=None)
+    agent_name: Union[str | None, Any] = Field(default=None)
+    agent_full_name: Union[str | None, Any] = Field(default=None)
+    department_id: Union[int | None, Any] = Field(default=None)
+    timestamp: Union[str | None, Any] = Field(default=None)
+    duration: Union[float | None, Any] = Field(default=None)
+    accepted: Union[bool | None, Any] = Field(default=None)
+    assigned: Union[bool | None, Any] = Field(default=None)
+    started_by: Union[str | None, Any] = Field(default=None)
+    rating: Union[str | None, Any] = Field(default=None)
+    comment: Union[str | None, Any] = Field(default=None)
+    count: Union[Any, Any] = Field(default=None)
+    response_time: Union[Any, Any] = Field(default=None)
+    skills_requested: Union[list[int] | None, Any] = Field(default=None)
+    skills_fulfilled: Union[bool | None, Any] = Field(default=None)
+
 class ChatHistoryItem(BaseModel):
     """ChatHistoryItem type definition"""
     model_config = ConfigDict(extra="allow", populate_by_name=True)
@@ -168,27 +189,6 @@ class WebpathItem(BaseModel):
     from_: Union[str | None, Any] = Field(default=None, alias="from")
     timestamp: Union[str | None, Any] = Field(default=None)
 
-class ChatEngagement(BaseModel):
-    """ChatEngagement type definition"""
-    model_config = ConfigDict(extra="allow", populate_by_name=True)
-
-    id: Union[str | None, Any] = Field(default=None)
-    agent_id: Union[str | None, Any] = Field(default=None)
-    agent_name: Union[str | None, Any] = Field(default=None)
-    agent_full_name: Union[str | None, Any] = Field(default=None)
-    department_id: Union[int | None, Any] = Field(default=None)
-    timestamp: Union[str | None, Any] = Field(default=None)
-    duration: Union[float | None, Any] = Field(default=None)
-    accepted: Union[bool | None, Any] = Field(default=None)
-    assigned: Union[bool | None, Any] = Field(default=None)
-    started_by: Union[str | None, Any] = Field(default=None)
-    rating: Union[str | None, Any] = Field(default=None)
-    comment: Union[str | None, Any] = Field(default=None)
-    count: Union[Any, Any] = Field(default=None)
-    response_time: Union[Any, Any] = Field(default=None)
-    skills_requested: Union[list[int] | None, Any] = Field(default=None)
-    skills_fulfilled: Union[bool | None, Any] = Field(default=None)
-
 class Chat(BaseModel):
     """Chat conversation transcript"""
     model_config = ConfigDict(extra="allow", populate_by_name=True)