airbyte-agent-slack 0.1.32__tar.gz → 0.1.38__tar.gz

{airbyte_agent_slack-0.1.32 → airbyte_agent_slack-0.1.38}/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Slack changelog
 
+## [0.1.38] - 2026-01-30
+- Updated connector definition (YAML version 0.1.12)
+- Source commit: 40765c71
+- SDK version: 0.1.0
+
+## [0.1.37] - 2026-01-30
+- Updated connector definition (YAML version 0.1.11)
+- Source commit: 5f65d643
+- SDK version: 0.1.0
+
+## [0.1.36] - 2026-01-30
+- Updated connector definition (YAML version 0.1.10)
+- Source commit: 5b20f488
+- SDK version: 0.1.0
+
+## [0.1.35] - 2026-01-30
+- Updated connector definition (YAML version 0.1.10)
+- Source commit: a3729d85
+- SDK version: 0.1.0
+
+## [0.1.34] - 2026-01-29
+- Updated connector definition (YAML version 0.1.10)
+- Source commit: 43200eed
+- SDK version: 0.1.0
+
+## [0.1.33] - 2026-01-29
+- Updated connector definition (YAML version 0.1.10)
+- Source commit: c718c683
+- SDK version: 0.1.0
+
 ## [0.1.32] - 2026-01-28
 - Updated connector definition (YAML version 0.1.10)
 - Source commit: 97007bbd

{airbyte_agent_slack-0.1.32 → airbyte_agent_slack-0.1.38}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: airbyte-agent-slack
-Version: 0.1.32
+Version: 0.1.38
 Summary: Airbyte Slack Connector for AI platforms
 Project-URL: Homepage, https://github.com/airbytehq/airbyte-agent-connectors
 Project-URL: Documentation, https://docs.airbyte.com/ai-agents/
@@ -158,6 +158,7 @@ See the official [Slack API reference](https://api.slack.com/methods).
 
 ## Version information
 
-- **Package version:** 0.1.32
-- **Connector version:** 0.1.10
-- **Generated with Connector SDK commit SHA:** 97007bbdad3a6ac982ee2c0cdd667acdb5c12d3c
+- **Package version:** 0.1.38
+- **Connector version:** 0.1.12
+- **Generated with Connector SDK commit SHA:** 40765c717093dffed8c5e9ed8d5b3a6fbbe9b181
+- **Changelog:** [View changelog](https://github.com/airbytehq/airbyte-agent-connectors/blob/main/connectors/slack/CHANGELOG.md)

{airbyte_agent_slack-0.1.32 → airbyte_agent_slack-0.1.38}/README.md

@@ -125,6 +125,7 @@ See the official [Slack API reference](https://api.slack.com/methods).
 
 ## Version information
 
-- **Package version:** 0.1.32
-- **Connector version:** 0.1.10
-- **Generated with Connector SDK commit SHA:** 97007bbdad3a6ac982ee2c0cdd667acdb5c12d3c
+- **Package version:** 0.1.38
+- **Connector version:** 0.1.12
+- **Generated with Connector SDK commit SHA:** 40765c717093dffed8c5e9ed8d5b3a6fbbe9b181
+- **Changelog:** [View changelog](https://github.com/airbytehq/airbyte-agent-connectors/blob/main/connectors/slack/CHANGELOG.md)

{airbyte_agent_slack-0.1.32 → airbyte_agent_slack-0.1.38}/airbyte_agent_slack/__init__.py

@@ -17,9 +17,9 @@ from .models import (
     ChannelPurpose,
     ChannelsListResponse,
     ChannelResponse,
-    File,
     Reaction,
     Attachment,
+    File,
     Message,
     Thread,
     EditedInfo,
@@ -45,6 +45,7 @@ from .models import (
     ChannelsListResultMeta,
     ChannelMessagesListResultMeta,
     ThreadsListResultMeta,
+    SlackCheckResult,
     SlackExecuteResult,
     SlackExecuteResultWithMeta,
     UsersListResult,
@@ -95,9 +96,9 @@ __all__ = [
     "ChannelPurpose",
     "ChannelsListResponse",
     "ChannelResponse",
-    "File",
     "Reaction",
     "Attachment",
+    "File",
     "Message",
     "Thread",
     "EditedInfo",
@@ -123,6 +124,7 @@ __all__ = [
     "ChannelsListResultMeta",
     "ChannelMessagesListResultMeta",
     "ThreadsListResultMeta",
+    "SlackCheckResult",
     "SlackExecuteResult",
     "SlackExecuteResultWithMeta",
     "UsersListResult",

{airbyte_agent_slack-0.1.32 → airbyte_agent_slack-0.1.38}/airbyte_agent_slack/_vendored/connector_sdk/connector_model_loader.py

@@ -496,6 +496,9 @@ def convert_openapi_to_connector_model(spec: OpenAPIConnector) -> ConnectorModel
             # Extract untested flag
             untested = getattr(operation, "x_airbyte_untested", None) or False
 
+            # Extract preferred_for_check flag
+            preferred_for_check = getattr(operation, "x_airbyte_preferred_for_check", None) or False
+
             # Create endpoint definition
             endpoint = EndpointDefinition(
                 method=method_name.upper(),
@@ -520,6 +523,7 @@ def convert_openapi_to_connector_model(spec: OpenAPIConnector) -> ConnectorModel
                 graphql_body=graphql_body,
                 file_field=file_field,
                 untested=untested,
+                preferred_for_check=preferred_for_check,
             )
 
             # Add to entities map
@@ -1010,6 +1014,7 @@ def _parse_security_scheme_to_option(scheme_name: str, scheme: Any) -> AuthOptio
         type=single_auth.type,
         config=single_auth.config,
         user_config_spec=single_auth.user_config_spec,
+        untested=getattr(scheme, "x_airbyte_untested", False),
     )
 
 

{airbyte_agent_slack-0.1.32 → airbyte_agent_slack-0.1.38}/airbyte_agent_slack/_vendored/connector_sdk/executor/hosted_executor.py

@@ -164,6 +164,11 @@ class HostedExecutor:
                 span.record_exception(e)
                 raise
 
+    async def check(self) -> ExecutionResult:
+        """Perform a health check via the cloud API."""
+        config = ExecutionConfig(entity="*", action="check", params={})
+        return await self.execute(config)
+
     def _parse_execution_result(self, response: dict) -> ExecutionResult:
         """Parse API response into ExecutionResult.
 

{airbyte_agent_slack-0.1.32 → airbyte_agent_slack-0.1.38}/airbyte_agent_slack/_vendored/connector_sdk/executor/local_executor.py

@@ -36,6 +36,7 @@ from ..types import (
     EndpointDefinition,
     EntityDefinition,
 )
+from ..utils import find_matching_auth_options
 
 from .models import (
     ActionNotSupportedError,
@@ -70,6 +71,14 @@ class _OperationContext:
         self.validate_required_body_fields = executor._validate_required_body_fields
         self.extract_records = executor._extract_records
 
+    @property
+    def standard_handler(self) -> _StandardOperationHandler | None:
+        """Return the standard operation handler, or None if not registered."""
+        for h in self.executor._operation_handlers:
+            if isinstance(h, _StandardOperationHandler):
+                return h
+        return None
+
 
 class _OperationHandler(Protocol):
     """Protocol for operation handlers."""
@@ -348,8 +357,8 @@ class LocalExecutor:
     ) -> tuple[AuthOption, dict[str, SecretStr]]:
         """Infer authentication scheme from provided credentials.
 
-        Matches user credentials against each auth option's required fields
-        to determine which scheme to use.
+        Uses shared utility find_matching_auth_options to match credentials
+        against each auth option's required fields.
 
         Args:
             user_credentials: User-provided credentials
@@ -367,16 +376,8 @@ class LocalExecutor:
         # Get the credential keys provided by the user
         provided_keys = set(user_credentials.keys())
 
-        # Find all options where all required fields are present
-        matching_options: list[AuthOption] = []
-        for option in options:
-            if option.user_config_spec and option.user_config_spec.required:
-                required_fields = set(option.user_config_spec.required)
-                if required_fields.issubset(provided_keys):
-                    matching_options.append(option)
-            elif not option.user_config_spec or not option.user_config_spec.required:
-                # Option has no required fields - it matches any credentials
-                matching_options.append(option)
+        # Use shared utility to find matching options
+        matching_options = find_matching_auth_options(provided_keys, options)
 
         # Handle matching results
         if len(matching_options) == 0:
@@ -544,6 +545,80 @@ class LocalExecutor:
             # These are "expected" execution errors - return them in ExecutionResult
             return ExecutionResult(success=False, data={}, error=str(e))
 
+    async def check(self) -> ExecutionResult:
+        """Perform a health check by running a lightweight list operation.
+
+        Finds the operation marked with preferred_for_check=True, or falls back
+        to the first list operation. Executes it with limit=1 to verify
+        connectivity and credentials.
+
+        Returns:
+            ExecutionResult with data containing status, error, and checked operation details.
+        """
+        check_entity = None
+        check_endpoint = None
+
+        # Look for preferred check operation
+        for (ent_name, op_action), endpoint in self._operation_index.items():
+            if getattr(endpoint, "preferred_for_check", False):
+                check_entity = ent_name
+                check_endpoint = endpoint
+                break
+
+        # Fallback to first list operation
+        if check_endpoint is None:
+            for (ent_name, op_action), endpoint in self._operation_index.items():
+                if op_action == Action.LIST:
+                    check_entity = ent_name
+                    check_endpoint = endpoint
+                    break
+
+        if check_endpoint is None or check_entity is None:
+            return ExecutionResult(
+                success=True,
+                data={
+                    "status": "skipped",
+                    "error": "No list operation available for health check",
+                },
+            )
+
+        # Find the standard handler to execute the list operation
+        standard_handler = next(
+            (h for h in self._operation_handlers if isinstance(h, _StandardOperationHandler)),
+            None,
+        )
+
+        if standard_handler is None:
+            return ExecutionResult(
+                success=True,
+                data={
+                    "status": "skipped",
+                    "error": "No standard handler available",
+                },
+            )
+
+        try:
+            await standard_handler.execute_operation(check_entity, Action.LIST, {"limit": 1})
+            return ExecutionResult(
+                success=True,
+                data={
+                    "status": "healthy",
+                    "checked_entity": check_entity,
+                    "checked_action": "list",
+                },
+            )
+        except Exception as e:
+            return ExecutionResult(
+                success=False,
+                data={
+                    "status": "unhealthy",
+                    "error": str(e),
+                    "checked_entity": check_entity,
+                    "checked_action": "list",
+                },
+                error=str(e),
+            )
+
     async def _execute_operation(
         self,
         entity: str,

{airbyte_agent_slack-0.1.32 → airbyte_agent_slack-0.1.38}/airbyte_agent_slack/_vendored/connector_sdk/executor/models.py

@@ -154,6 +154,18 @@ class ExecutorProtocol(Protocol):
         """
         ...
 
+    async def check(self) -> ExecutionResult:
+        """Perform a health check to verify connectivity and credentials.
+
+        Returns:
+            ExecutionResult with data containing:
+                - status: "healthy" or "unhealthy"
+                - error: Error message if unhealthy
+                - checked_entity: Entity used for the check
+                - checked_action: Action used for the check
+        """
+        ...
+
 
 # ============================================================================
 # Executor Exceptions

{airbyte_agent_slack-0.1.32 → airbyte_agent_slack-0.1.38}/airbyte_agent_slack/_vendored/connector_sdk/http/adapters/httpx_adapter.py

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

{airbyte_agent_slack-0.1.32 → airbyte_agent_slack-0.1.38}/airbyte_agent_slack/_vendored/connector_sdk/schema/base.py

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

{airbyte_agent_slack-0.1.32 → airbyte_agent_slack-0.1.38}/airbyte_agent_slack/_vendored/connector_sdk/schema/operations.py

@@ -86,6 +86,16 @@ class Operation(BaseModel):
             "Validation will generate a warning instead of an error when cassettes are missing."
         ),
     )
+    x_airbyte_preferred_for_check: bool | None = Field(
+        None,
+        alias="x-airbyte-preferred-for-check",
+        description=(
+            "Mark this list operation as the preferred operation for health checks. "
+            "When the CHECK action is executed, this operation will be used instead of "
+            "falling back to the first available list operation. Choose a lightweight, "
+            "always-available endpoint (e.g., users, accounts)."
+        ),
+    )
 
     # Future extensions (commented out, defined for future use)
     # from .extensions import PaginationConfig

{airbyte_agent_slack-0.1.32 → airbyte_agent_slack-0.1.38}/airbyte_agent_slack/_vendored/connector_sdk/schema/security.py

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

{airbyte_agent_slack-0.1.32 → airbyte_agent_slack-0.1.38}/airbyte_agent_slack/_vendored/connector_sdk/telemetry/tracker.py

@@ -3,7 +3,7 @@
 import logging
 import platform
 import sys
-from datetime import datetime
+from datetime import UTC, datetime
 
 from ..observability import ObservabilitySession
 
@@ -56,7 +56,7 @@ class SegmentTracker:
 
         try:
             event = ConnectorInitEvent(
-                timestamp=datetime.utcnow(),
+                timestamp=datetime.now(UTC),
                 session_id=self.session.session_id,
                 user_id=self.session.user_id,
                 execution_context=self.session.execution_context,
@@ -99,7 +99,7 @@ class SegmentTracker:
 
         try:
             event = OperationEvent(
-                timestamp=datetime.utcnow(),
+                timestamp=datetime.now(UTC),
                 session_id=self.session.session_id,
                 user_id=self.session.user_id,
                 execution_context=self.session.execution_context,
@@ -129,7 +129,7 @@ class SegmentTracker:
 
         try:
             event = SessionEndEvent(
-                timestamp=datetime.utcnow(),
+                timestamp=datetime.now(UTC),
                 session_id=self.session.session_id,
                 user_id=self.session.user_id,
                 execution_context=self.session.execution_context,

{airbyte_agent_slack-0.1.32 → airbyte_agent_slack-0.1.38}/airbyte_agent_slack/_vendored/connector_sdk/types.py

@@ -15,7 +15,16 @@ from .schema.security import AirbyteAuthConfig
 
 
 class Action(str, Enum):
-    """Supported actions for Entity operations."""
+    """Supported actions for Entity operations.
+
+    Standard CRUD actions:
+        GET, CREATE, UPDATE, DELETE, LIST
+
+    Special actions:
+        API_SEARCH - Search via API endpoint
+        DOWNLOAD - Download file content
+        AUTHORIZE - OAuth authorization flow
+    """
 
     GET = "get"
     CREATE = "create"
@@ -81,6 +90,10 @@ class AuthOption(BaseModel):
         None,
         description="User-facing credential specification from x-airbyte-auth-config",
     )
+    untested: bool = Field(
+        False,
+        description="Mark this auth scheme as untested to skip cassette coverage validation",
+    )
 
 
 class AuthConfig(BaseModel):
@@ -223,6 +236,12 @@ class EndpointDefinition(BaseModel):
         description="Mark operation as untested to skip cassette validation (from x-airbyte-untested extension)",
     )
 
+    # Health check support (Airbyte extension)
+    preferred_for_check: bool = Field(
+        False,
+        description="Mark this list operation as preferred for health checks (from x-airbyte-preferred-for-check extension)",
+    )
+
 
 class EntityDefinition(BaseModel):
     """Definition of an API entity."""

airbyte_agent_slack-0.1.38/airbyte_agent_slack/_vendored/connector_sdk/utils.py

@@ -0,0 +1,127 @@
+"""Utility functions for working with connectors."""
+
+from __future__ import annotations
+
+from collections.abc import AsyncIterator
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from .types import AuthOption
+
+
+async def save_download(
+    download_iterator: AsyncIterator[bytes],
+    path: str | Path,
+    *,
+    overwrite: bool = False,
+) -> Path:
+    """Save a download iterator to a file.
+
+    Args:
+        download_iterator: AsyncIterator[bytes] from a download operation
+        path: File path where content should be saved
+        overwrite: Whether to overwrite existing file (default: False)
+
+    Returns:
+        Absolute Path to the saved file
+
+    Raises:
+        FileExistsError: If file exists and overwrite=False
+        OSError: If file cannot be written
+
+    Example:
+        >>> from .utils import save_download
+        >>>
+        >>> # Download and save a file
+        >>> result = await connector.download_article_attachment(id="123")
+        >>> file_path = await save_download(result, "./downloads/attachment.pdf")
+        >>> print(f"Downloaded to {file_path}")
+        Downloaded to /absolute/path/to/downloads/attachment.pdf
+        >>>
+        >>> # Overwrite existing file
+        >>> file_path = await save_download(result, "./downloads/attachment.pdf", overwrite=True)
+    """
+    # Convert to Path object
+    file_path = Path(path).expanduser().resolve()
+
+    # Check if file exists
+    if file_path.exists() and not overwrite:
+        raise FileExistsError(f"File already exists: {file_path}. Use overwrite=True to replace it.")
+
+    # Create parent directories if needed
+    file_path.parent.mkdir(parents=True, exist_ok=True)
+
+    # Stream content to file
+    try:
+        with open(file_path, "wb") as f:
+            async for chunk in download_iterator:
+                f.write(chunk)
+    except Exception as e:
+        # Clean up partial file on error
+        if file_path.exists():
+            file_path.unlink()
+        raise OSError(f"Failed to write file {file_path}: {e}") from e
+
+    return file_path
+
+
+def find_matching_auth_options(
+    provided_keys: set[str],
+    auth_options: list[AuthOption],
+) -> list[AuthOption]:
+    """Find auth options that match the provided credential keys.
+
+    This is the single source of truth for auth scheme inference logic,
+    used by both the executor (at runtime) and validation (for cassettes).
+
+    Matching logic:
+    - An option matches if all its required fields are present in provided_keys
+    - Options with no required fields match any credentials
+
+    Args:
+        provided_keys: Set of credential/auth_config keys
+        auth_options: List of AuthOption from the connector model
+
+    Returns:
+        List of AuthOption that match the provided keys
+    """
+    matching_options: list[AuthOption] = []
+
+    for option in auth_options:
+        if option.user_config_spec and option.user_config_spec.required:
+            required_fields = set(option.user_config_spec.required)
+            if required_fields.issubset(provided_keys):
+                matching_options.append(option)
+        elif not option.user_config_spec or not option.user_config_spec.required:
+            # Option has no required fields - it matches any credentials
+            matching_options.append(option)
+
+    return matching_options
+
+
+def infer_auth_scheme_name(
+    provided_keys: set[str],
+    auth_options: list[AuthOption],
+) -> str | None:
+    """Infer the auth scheme name from provided credential keys.
+
+    Uses find_matching_auth_options to find matches, then returns
+    the scheme name only if exactly one option matches.
+
+    Args:
+        provided_keys: Set of credential/auth_config keys
+        auth_options: List of AuthOption from the connector model
+
+    Returns:
+        The scheme_name if exactly one match, None otherwise
+    """
+    if not provided_keys or not auth_options:
+        return None
+
+    matching = find_matching_auth_options(provided_keys, auth_options)
+
+    if len(matching) == 1:
+        return matching[0].scheme_name
+
+    return None