airbyte-agent-slack 0.1.20__py3-none-any.whl → 0.1.21__py3-none-any.whl

airbyte_agent_slack/__init__.py

@@ -18,8 +18,8 @@ from .models import (
     ChannelsListResponse,
     ChannelResponse,
     Reaction,
-    Attachment,
     File,
+    Attachment,
     Message,
     Thread,
     EditedInfo,
@@ -50,7 +50,13 @@ from .models import (
     UsersListResult,
     ChannelsListResult,
     ChannelMessagesListResult,
-    ThreadsListResult
+    ThreadsListResult,
+    AirbyteSearchHit,
+    AirbyteSearchResult,
+    ChannelsSearchData,
+    ChannelsSearchResult,
+    UsersSearchData,
+    UsersSearchResult
 )
 from .types import (
     UsersListParams,
@@ -65,7 +71,15 @@ from .types import (
     ChannelsUpdateParams,
     ChannelTopicsCreateParams,
     ChannelPurposesCreateParams,
-    ReactionsCreateParams
+    ReactionsCreateParams,
+    AirbyteSearchParams,
+    AirbyteSortOrder,
+    ChannelsSearchFilter,
+    ChannelsSearchQuery,
+    ChannelsCondition,
+    UsersSearchFilter,
+    UsersSearchQuery,
+    UsersCondition
 )
 
 __all__ = [
@@ -82,8 +96,8 @@ __all__ = [
     "ChannelsListResponse",
     "ChannelResponse",
     "Reaction",
-    "Attachment",
     "File",
+    "Attachment",
     "Message",
     "Thread",
     "EditedInfo",
@@ -115,6 +129,12 @@ __all__ = [
     "ChannelsListResult",
     "ChannelMessagesListResult",
     "ThreadsListResult",
+    "AirbyteSearchHit",
+    "AirbyteSearchResult",
+    "ChannelsSearchData",
+    "ChannelsSearchResult",
+    "UsersSearchData",
+    "UsersSearchResult",
     "UsersListParams",
     "UsersGetParams",
     "ChannelsListParams",
@@ -128,4 +148,12 @@ __all__ = [
     "ChannelTopicsCreateParams",
     "ChannelPurposesCreateParams",
     "ReactionsCreateParams",
+    "AirbyteSearchParams",
+    "AirbyteSortOrder",
+    "ChannelsSearchFilter",
+    "ChannelsSearchQuery",
+    "ChannelsCondition",
+    "UsersSearchFilter",
+    "UsersSearchQuery",
+    "UsersCondition",
 ]

airbyte_agent_slack/_vendored/connector_sdk/executor/local_executor.py

@@ -1032,7 +1032,9 @@ class LocalExecutor:
         if "variables" in graphql_config and graphql_config["variables"]:
             variables = self._interpolate_variables(graphql_config["variables"], params, param_defaults)
             # Filter out None values (optional fields not provided) - matches REST _extract_body() behavior
-            body["variables"] = {k: v for k, v in variables.items() if v is not None}
+            # But preserve None for variables explicitly marked as nullable (e.g., to unassign a user)
+            nullable_vars = set(graphql_config.get("x-airbyte-nullable-variables") or [])
+            body["variables"] = {k: v for k, v in variables.items() if v is not None or k in nullable_vars}
 
         # Add operation name if specified
         if "operationName" in graphql_config:

airbyte_agent_slack/_vendored/connector_sdk/schema/components.py

@@ -134,6 +134,11 @@ class GraphQLBodyConfig(BaseModel):
         None,
         description="Default fields to select if not provided in request parameters. Can be a string or array of field names.",
     )
+    nullable_variables: List[str] | None = Field(
+        default=None,
+        alias="x-airbyte-nullable-variables",
+        description="Variable names that can be explicitly set to null (e.g., to unassign a user)",
+    )
 
 
 # Union type for all body type configs (extensible for future types like XML, SOAP, etc.)

airbyte_agent_slack/connector.py

@@ -27,6 +27,11 @@ from .types import (
     ThreadsListParams,
     UsersGetParams,
     UsersListParams,
+    AirbyteSearchParams,
+    ChannelsSearchFilter,
+    ChannelsSearchQuery,
+    UsersSearchFilter,
+    UsersSearchQuery,
 )
 if TYPE_CHECKING:
     from .models import SlackAuthConfig
@@ -46,6 +51,12 @@ from .models import (
     ReactionAddResponse,
     Thread,
     User,
+    AirbyteSearchHit,
+    AirbyteSearchResult,
+    ChannelsSearchData,
+    ChannelsSearchResult,
+    UsersSearchData,
+    UsersSearchResult,
 )
 
 # TypeVar for decorator type preservation
@@ -61,7 +72,7 @@ class SlackConnector:
     """
 
     connector_name = "slack"
-    connector_version = "0.1.7"
+    connector_version = "0.1.8"
     vendored_sdk_version = "0.1.0"  # Version of vendored connector-sdk
 
     # Map of (entity, action) -> needs_envelope for envelope wrapping decision
@@ -522,6 +533,82 @@ class UsersQuery:
 
 
 
+    async def search(
+        self,
+        query: UsersSearchQuery,
+        limit: int | None = None,
+        cursor: str | None = None,
+        fields: list[list[str]] | None = None,
+    ) -> UsersSearchResult:
+        """
+        Search users records from Airbyte cache.
+
+        This operation searches cached data from Airbyte syncs.
+        Only available in hosted execution mode.
+
+        Available filter fields (UsersSearchFilter):
+        - color: The color assigned to the user for visual purposes.
+        - deleted: Indicates if the user is deleted or not.
+        - has_2fa: Flag indicating if the user has two-factor authentication enabled.
+        - id: Unique identifier for the user.
+        - is_admin: Flag specifying if the user is an admin or not.
+        - is_app_user: Specifies if the user is an app user.
+        - is_bot: Indicates if the user is a bot account.
+        - is_email_confirmed: Flag indicating if the user's email is confirmed.
+        - is_forgotten: Specifies if the user is marked as forgotten.
+        - is_invited_user: Indicates if the user is invited or not.
+        - is_owner: Flag indicating if the user is an owner.
+        - is_primary_owner: Specifies if the user is the primary owner.
+        - is_restricted: Flag specifying if the user is restricted.
+        - is_ultra_restricted: Indicates if the user has ultra-restricted access.
+        - name: The username of the user.
+        - profile: User's profile information containing detailed details.
+        - real_name: The real name of the user.
+        - team_id: Unique identifier for the team the user belongs to.
+        - tz: Timezone of the user.
+        - tz_label: Label representing the timezone of the user.
+        - tz_offset: Offset of the user's timezone.
+        - updated: Timestamp of when the user's information was last updated.
+        - who_can_share_contact_card: Specifies who can share the user's contact card.
+
+        Args:
+            query: Filter and sort conditions. Supports operators like eq, neq, gt, gte, lt, lte,
+                   in, like, fuzzy, keyword, not, and, or. Example: {"filter": {"eq": {"status": "active"}}}
+            limit: Maximum results to return (default 1000)
+            cursor: Pagination cursor from previous response's next_cursor
+            fields: Field paths to include in results. Each path is a list of keys for nested access.
+                    Example: [["id"], ["user", "name"]] returns id and user.name fields.
+
+        Returns:
+            UsersSearchResult with hits (list of AirbyteSearchHit[UsersSearchData]) and pagination info
+
+        Raises:
+            NotImplementedError: If called in local execution mode
+        """
+        params: dict[str, Any] = {"query": query}
+        if limit is not None:
+            params["limit"] = limit
+        if cursor is not None:
+            params["cursor"] = cursor
+        if fields is not None:
+            params["fields"] = fields
+
+        result = await self._connector.execute("users", "search", params)
+
+        # Parse response into typed result
+        return UsersSearchResult(
+            hits=[
+                AirbyteSearchHit[UsersSearchData](
+                    id=hit.get("id"),
+                    score=hit.get("score"),
+                    data=UsersSearchData(**hit.get("data", {}))
+                )
+                for hit in result.get("hits", [])
+            ],
+            next_cursor=result.get("next_cursor"),
+            took_ms=result.get("took_ms")
+        )
+
 class ChannelsQuery:
     """
     Query class for Channels entity operations.
@@ -650,6 +737,90 @@ class ChannelsQuery:
 
 
 
+    async def search(
+        self,
+        query: ChannelsSearchQuery,
+        limit: int | None = None,
+        cursor: str | None = None,
+        fields: list[list[str]] | None = None,
+    ) -> ChannelsSearchResult:
+        """
+        Search channels records from Airbyte cache.
+
+        This operation searches cached data from Airbyte syncs.
+        Only available in hosted execution mode.
+
+        Available filter fields (ChannelsSearchFilter):
+        - context_team_id: The unique identifier of the team context in which the channel exists.
+        - created: The timestamp when the channel was created.
+        - creator: The ID of the user who created the channel.
+        - id: The unique identifier of the channel.
+        - is_archived: Indicates if the channel is archived.
+        - is_channel: Indicates if the entity is a channel.
+        - is_ext_shared: Indicates if the channel is externally shared.
+        - is_general: Indicates if the channel is a general channel in the workspace.
+        - is_group: Indicates if the channel is a group (private channel) rather than a regular channel.
+        - is_im: Indicates if the entity is a direct message (IM) channel.
+        - is_member: Indicates if the calling user is a member of the channel.
+        - is_mpim: Indicates if the entity is a multiple person direct message (MPIM) channel.
+        - is_org_shared: Indicates if the channel is organization-wide shared.
+        - is_pending_ext_shared: Indicates if the channel is pending external shared.
+        - is_private: Indicates if the channel is a private channel.
+        - is_read_only: Indicates if the channel is read-only.
+        - is_shared: Indicates if the channel is shared.
+        - last_read: The timestamp of the user's last read message in the channel.
+        - locale: The locale of the channel.
+        - name: The name of the channel.
+        - name_normalized: The normalized name of the channel.
+        - num_members: The number of members in the channel.
+        - parent_conversation: The parent conversation of the channel.
+        - pending_connected_team_ids: The IDs of teams that are pending to be connected to the channel.
+        - pending_shared: The list of pending shared items of the channel.
+        - previous_names: The previous names of the channel.
+        - purpose: The purpose of the channel.
+        - shared_team_ids: The IDs of teams with which the channel is shared.
+        - topic: The topic of the channel.
+        - unlinked: Indicates if the channel is unlinked.
+        - updated: The timestamp when the channel was last updated.
+
+        Args:
+            query: Filter and sort conditions. Supports operators like eq, neq, gt, gte, lt, lte,
+                   in, like, fuzzy, keyword, not, and, or. Example: {"filter": {"eq": {"status": "active"}}}
+            limit: Maximum results to return (default 1000)
+            cursor: Pagination cursor from previous response's next_cursor
+            fields: Field paths to include in results. Each path is a list of keys for nested access.
+                    Example: [["id"], ["user", "name"]] returns id and user.name fields.
+
+        Returns:
+            ChannelsSearchResult with hits (list of AirbyteSearchHit[ChannelsSearchData]) and pagination info
+
+        Raises:
+            NotImplementedError: If called in local execution mode
+        """
+        params: dict[str, Any] = {"query": query}
+        if limit is not None:
+            params["limit"] = limit
+        if cursor is not None:
+            params["cursor"] = cursor
+        if fields is not None:
+            params["fields"] = fields
+
+        result = await self._connector.execute("channels", "search", params)
+
+        # Parse response into typed result
+        return ChannelsSearchResult(
+            hits=[
+                AirbyteSearchHit[ChannelsSearchData](
+                    id=hit.get("id"),
+                    score=hit.get("score"),
+                    data=ChannelsSearchData(**hit.get("data", {}))
+                )
+                for hit in result.get("hits", [])
+            ],
+            next_cursor=result.get("next_cursor"),
+            took_ms=result.get("took_ms")
+        )
+
 class ChannelMessagesQuery:
     """
     Query class for ChannelMessages entity operations.

airbyte_agent_slack/connector_model.py

@@ -27,7 +27,7 @@ from uuid import (
 SlackConnectorModel: ConnectorModel = ConnectorModel(
     id=UUID('c2281cee-86f9-4a86-bb48-d23286b4c7bd'),
     name='slack',
-    version='0.1.7',
+    version='0.1.8',
     base_url='https://slack.com/api',
     auth=AuthConfig(
         options=[

airbyte_agent_slack/models.py

@@ -184,27 +184,6 @@ class Reaction(BaseModel):
     users: Union[list[str] | None, Any] = Field(default=None)
     count: Union[int | None, Any] = Field(default=None)
 
-class Attachment(BaseModel):
-    """Message attachment"""
-    model_config = ConfigDict(extra="allow", populate_by_name=True)
-
-    id: Union[int | None, Any] = Field(default=None)
-    fallback: Union[str | None, Any] = Field(default=None)
-    color: Union[str | None, Any] = Field(default=None)
-    pretext: Union[str | None, Any] = Field(default=None)
-    author_name: Union[str | None, Any] = Field(default=None)
-    author_link: Union[str | None, Any] = Field(default=None)
-    author_icon: Union[str | None, Any] = Field(default=None)
-    title: Union[str | None, Any] = Field(default=None)
-    title_link: Union[str | None, Any] = Field(default=None)
-    text: Union[str | None, Any] = Field(default=None)
-    fields: Union[list[dict[str, Any]] | None, Any] = Field(default=None)
-    image_url: Union[str | None, Any] = Field(default=None)
-    thumb_url: Union[str | None, Any] = Field(default=None)
-    footer: Union[str | None, Any] = Field(default=None)
-    footer_icon: Union[str | None, Any] = Field(default=None)
-    ts: Union[Any, Any] = Field(default=None)
-
 class File(BaseModel):
     """File object"""
     model_config = ConfigDict(extra="allow", populate_by_name=True)
@@ -229,6 +208,27 @@ class File(BaseModel):
     created: Union[int | None, Any] = Field(default=None)
     timestamp: Union[int | None, Any] = Field(default=None)
 
+class Attachment(BaseModel):
+    """Message attachment"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    id: Union[int | None, Any] = Field(default=None)
+    fallback: Union[str | None, Any] = Field(default=None)
+    color: Union[str | None, Any] = Field(default=None)
+    pretext: Union[str | None, Any] = Field(default=None)
+    author_name: Union[str | None, Any] = Field(default=None)
+    author_link: Union[str | None, Any] = Field(default=None)
+    author_icon: Union[str | None, Any] = Field(default=None)
+    title: Union[str | None, Any] = Field(default=None)
+    title_link: Union[str | None, Any] = Field(default=None)
+    text: Union[str | None, Any] = Field(default=None)
+    fields: Union[list[dict[str, Any]] | None, Any] = Field(default=None)
+    image_url: Union[str | None, Any] = Field(default=None)
+    thumb_url: Union[str | None, Any] = Field(default=None)
+    footer: Union[str | None, Any] = Field(default=None)
+    footer_icon: Union[str | None, Any] = Field(default=None)
+    ts: Union[Any, Any] = Field(default=None)
+
 class Message(BaseModel):
     """Slack message object"""
     model_config = ConfigDict(extra="allow", populate_by_name=True)
@@ -496,6 +496,166 @@ class SlackExecuteResultWithMeta(SlackExecuteResult[T], Generic[T, S]):
     meta: S
     """Metadata about the response (e.g., pagination cursors, record counts)."""
 
+# ===== SEARCH DATA MODELS =====
+# Entity-specific Pydantic models for search result data
+
+# Type variable for search data generic
+D = TypeVar('D')
+
+class ChannelsSearchData(BaseModel):
+    """Search result data for channels entity."""
+    model_config = ConfigDict(extra="allow")
+
+    context_team_id: str | None = None
+    """The unique identifier of the team context in which the channel exists."""
+    created: int | None = None
+    """The timestamp when the channel was created."""
+    creator: str | None = None
+    """The ID of the user who created the channel."""
+    id: str | None = None
+    """The unique identifier of the channel."""
+    is_archived: bool | None = None
+    """Indicates if the channel is archived."""
+    is_channel: bool | None = None
+    """Indicates if the entity is a channel."""
+    is_ext_shared: bool | None = None
+    """Indicates if the channel is externally shared."""
+    is_general: bool | None = None
+    """Indicates if the channel is a general channel in the workspace."""
+    is_group: bool | None = None
+    """Indicates if the channel is a group (private channel) rather than a regular channel."""
+    is_im: bool | None = None
+    """Indicates if the entity is a direct message (IM) channel."""
+    is_member: bool | None = None
+    """Indicates if the calling user is a member of the channel."""
+    is_mpim: bool | None = None
+    """Indicates if the entity is a multiple person direct message (MPIM) channel."""
+    is_org_shared: bool | None = None
+    """Indicates if the channel is organization-wide shared."""
+    is_pending_ext_shared: bool | None = None
+    """Indicates if the channel is pending external shared."""
+    is_private: bool | None = None
+    """Indicates if the channel is a private channel."""
+    is_read_only: bool | None = None
+    """Indicates if the channel is read-only."""
+    is_shared: bool | None = None
+    """Indicates if the channel is shared."""
+    last_read: str | None = None
+    """The timestamp of the user's last read message in the channel."""
+    locale: str | None = None
+    """The locale of the channel."""
+    name: str | None = None
+    """The name of the channel."""
+    name_normalized: str | None = None
+    """The normalized name of the channel."""
+    num_members: int | None = None
+    """The number of members in the channel."""
+    parent_conversation: str | None = None
+    """The parent conversation of the channel."""
+    pending_connected_team_ids: list[Any] | None = None
+    """The IDs of teams that are pending to be connected to the channel."""
+    pending_shared: list[Any] | None = None
+    """The list of pending shared items of the channel."""
+    previous_names: list[Any] | None = None
+    """The previous names of the channel."""
+    purpose: dict[str, Any] | None = None
+    """The purpose of the channel."""
+    shared_team_ids: list[Any] | None = None
+    """The IDs of teams with which the channel is shared."""
+    topic: dict[str, Any] | None = None
+    """The topic of the channel."""
+    unlinked: int | None = None
+    """Indicates if the channel is unlinked."""
+    updated: int | None = None
+    """The timestamp when the channel was last updated."""
+
+
+class UsersSearchData(BaseModel):
+    """Search result data for users entity."""
+    model_config = ConfigDict(extra="allow")
+
+    color: str | None = None
+    """The color assigned to the user for visual purposes."""
+    deleted: bool | None = None
+    """Indicates if the user is deleted or not."""
+    has_2fa: bool | None = None
+    """Flag indicating if the user has two-factor authentication enabled."""
+    id: str | None = None
+    """Unique identifier for the user."""
+    is_admin: bool | None = None
+    """Flag specifying if the user is an admin or not."""
+    is_app_user: bool | None = None
+    """Specifies if the user is an app user."""
+    is_bot: bool | None = None
+    """Indicates if the user is a bot account."""
+    is_email_confirmed: bool | None = None
+    """Flag indicating if the user's email is confirmed."""
+    is_forgotten: bool | None = None
+    """Specifies if the user is marked as forgotten."""
+    is_invited_user: bool | None = None
+    """Indicates if the user is invited or not."""
+    is_owner: bool | None = None
+    """Flag indicating if the user is an owner."""
+    is_primary_owner: bool | None = None
+    """Specifies if the user is the primary owner."""
+    is_restricted: bool | None = None
+    """Flag specifying if the user is restricted."""
+    is_ultra_restricted: bool | None = None
+    """Indicates if the user has ultra-restricted access."""
+    name: str | None = None
+    """The username of the user."""
+    profile: dict[str, Any] | None = None
+    """User's profile information containing detailed details."""
+    real_name: str | None = None
+    """The real name of the user."""
+    team_id: str | None = None
+    """Unique identifier for the team the user belongs to."""
+    tz: str | None = None
+    """Timezone of the user."""
+    tz_label: str | None = None
+    """Label representing the timezone of the user."""
+    tz_offset: int | None = None
+    """Offset of the user's timezone."""
+    updated: int | None = None
+    """Timestamp of when the user's information was last updated."""
+    who_can_share_contact_card: str | None = None
+    """Specifies who can share the user's contact card."""
+
+
+# ===== GENERIC SEARCH RESULT TYPES =====
+
+class AirbyteSearchHit(BaseModel, Generic[D]):
+    """A single search result with typed data."""
+    model_config = ConfigDict(extra="allow")
+
+    id: str | None = None
+    """Unique identifier for the record."""
+    score: float | None = None
+    """Relevance score for the match."""
+    data: D
+    """The matched record data."""
+
+
+class AirbyteSearchResult(BaseModel, Generic[D]):
+    """Result from Airbyte cache search operations with typed hits."""
+    model_config = ConfigDict(extra="allow")
+
+    hits: list[AirbyteSearchHit[D]] = Field(default_factory=list)
+    """List of matching records."""
+    next_cursor: str | None = None
+    """Cursor for fetching the next page of results."""
+    took_ms: int | None = None
+    """Time taken to execute the search in milliseconds."""
+
+
+# ===== ENTITY-SPECIFIC SEARCH RESULT TYPE ALIASES =====
+
+ChannelsSearchResult = AirbyteSearchResult[ChannelsSearchData]
+"""Search result type for channels entity."""
+
+UsersSearchResult = AirbyteSearchResult[UsersSearchData]
+"""Search result type for users entity."""
+
 
 
 # ===== OPERATION RESULT TYPE ALIASES =====