airbyte-agent-slack 0.1.0__tar.gz → 0.1.26__tar.gz

airbyte_agent_slack-0.1.26/AUTH.md

@@ -0,0 +1,120 @@
+# Slack authentication and configuration
+
+This page documents the authentication and configuration options for the Slack agent connector.
+
+## Authentication
+
+### Open source execution
+
+In open source mode, you provide API credentials directly to the connector.
+
+#### OAuth
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `client_id` | `str` | Yes | Your Slack App's Client ID |
+| `client_secret` | `str` | Yes | Your Slack App's Client Secret |
+| `access_token` | `str` | Yes | OAuth access token (bot token from oauth.v2.access response) |
+
+```python
+from airbyte_agent_slack import SlackConnector
+from airbyte_agent_slack.models import SlackOauth20AuthenticationAuthConfig
+
+connector = SlackConnector(
+    auth_config=SlackOauth20AuthenticationAuthConfig(
+        client_id="<Your Slack App's Client ID>",
+        client_secret="<Your Slack App's Client Secret>",
+        access_token="<OAuth access token (bot token from oauth.v2.access response)>"
+    )
+)
+```
+
+#### Token
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `api_token` | `str` | Yes | Your Slack Bot Token (xoxb-) or User Token (xoxp-) |
+
+```python
+from airbyte_agent_slack import SlackConnector
+from airbyte_agent_slack.models import SlackTokenAuthenticationAuthConfig
+
+connector = SlackConnector(
+    auth_config=SlackTokenAuthenticationAuthConfig(
+        api_token="<Your Slack Bot Token (xoxb-) or User Token (xoxp-)>"
+    )
+)
+```
+
+### Hosted execution
+
+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:
+
+```bash
+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": "Slack",
+    "name": "My Slack Connector",
+    "credentials": {
+      "client_id": "<Your Slack App's Client ID>",
+      "client_secret": "<Your Slack App's Client Secret>",
+      "access_token": "<OAuth access token (bot token from oauth.v2.access response)>"
+    }
+  }'
+```
+
+#### Token
+
+Create a connector with Token credentials:
+
+```bash
+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": "Slack",
+    "credentials": {
+      "api_token": "<Your Slack Bot Token (xoxb-) or User Token (xoxp-)>"
+    }
+  }'
+```
+
+#### Execution
+
+After creating the connector, execute operations using either the Python SDK or API.
+
+**Python SDK**
+
+```python
+from airbyte_agent_slack import SlackConnector
+
+connector = SlackConnector(
+    external_user_id="<your_external_user_id>",
+    airbyte_client_id="<your-client-id>",
+    airbyte_client_secret="<your-client-secret>"
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@SlackConnector.tool_utils
+async def slack_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+**API**
+
+```bash
+curl -X POST 'https://api.airbyte.ai/api/v1/connectors/sources/<connector_id>/execute' \
+  -H 'Authorization: Bearer <SCOPED_TOKEN>' \
+  -H 'Content-Type: application/json' \
+  -d '{"entity": "<entity>", "action": "<action>", "params": {}}'
+```
+
+

airbyte_agent_slack-0.1.26/CHANGELOG.md

@@ -0,0 +1,136 @@
+# Slack changelog
+
+## [0.1.26] - 2026-01-27
+- Updated connector definition (YAML version 0.1.9)
+- Source commit: c9b05509
+- SDK version: 0.1.0
+
+## [0.1.25] - 2026-01-27
+- Updated connector definition (YAML version 0.1.8)
+- Source commit: 4bded58d
+- SDK version: 0.1.0
+
+## [0.1.24] - 2026-01-26
+- Updated connector definition (YAML version 0.1.8)
+- Source commit: 74809153
+- SDK version: 0.1.0
+
+## [0.1.23] - 2026-01-26
+- Updated connector definition (YAML version 0.1.8)
+- Source commit: b73c71e0
+- SDK version: 0.1.0
+
+## [0.1.22] - 2026-01-24
+- Updated connector definition (YAML version 0.1.8)
+- Source commit: 609c1d86
+- SDK version: 0.1.0
+
+## [0.1.21] - 2026-01-23
+- Updated connector definition (YAML version 0.1.8)
+- Source commit: 32c5ef46
+- SDK version: 0.1.0
+
+## [0.1.20] - 2026-01-23
+- Updated connector definition (YAML version 0.1.7)
+- Source commit: 049f6ad5
+- SDK version: 0.1.0
+
+## [0.1.19] - 2026-01-23
+- Updated connector definition (YAML version 0.1.6)
+- Source commit: a035ad48
+- SDK version: 0.1.0
+
+## [0.1.18] - 2026-01-23
+- Updated connector definition (YAML version 0.1.5)
+- Source commit: 416466da
+- SDK version: 0.1.0
+
+## [0.1.17] - 2026-01-23
+- Updated connector definition (YAML version 0.1.5)
+- Source commit: f17cdd8c
+- SDK version: 0.1.0
+
+## [0.1.16] - 2026-01-22
+- Updated connector definition (YAML version 0.1.5)
+- Source commit: 49e6dfe9
+- SDK version: 0.1.0
+
+## [0.1.15] - 2026-01-22
+- Updated connector definition (YAML version 0.1.5)
+- Source commit: b27328e2
+- SDK version: 0.1.0
+
+## [0.1.14] - 2026-01-22
+- Updated connector definition (YAML version 0.1.5)
+- Source commit: 1da193dd
+- SDK version: 0.1.0
+
+## [0.1.13] - 2026-01-22
+- Updated connector definition (YAML version 0.1.5)
+- Source commit: c713ec48
+- SDK version: 0.1.0
+
+## [0.1.12] - 2026-01-22
+- Updated connector definition (YAML version 0.1.5)
+- Source commit: 0cd3e79e
+- SDK version: 0.1.0
+
+## [0.1.11] - 2026-01-21
+- Updated connector definition (YAML version 0.1.4)
+- Source commit: d9dfd306
+- SDK version: 0.1.0
+
+## [0.1.10] - 2026-01-21
+- Updated connector definition (YAML version 0.1.3)
+- Source commit: c7dab975
+- SDK version: 0.1.0
+
+## [0.1.9] - 2026-01-21
+- Updated connector definition (YAML version 0.1.3)
+- Source commit: 3e52abfa
+- SDK version: 0.1.0
+
+## [0.1.8] - 2026-01-20
+- Updated connector definition (YAML version 0.1.2)
+- Source commit: 3d42e4e8
+- SDK version: 0.1.0
+
+## [0.1.7] - 2026-01-19
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 529cebb7
+- SDK version: 0.1.0
+
+## [0.1.6] - 2026-01-16
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: a50c8f71
+- SDK version: 0.1.0
+
+## [0.1.5] - 2026-01-16
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 49673b7b
+- SDK version: 0.1.0
+
+## [0.1.4] - 2026-01-16
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: ca5acdda
+- SDK version: 0.1.0
+
+## [0.1.3] - 2026-01-15
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: fa9a3b02
+- SDK version: 0.1.0
+
+## [0.1.2] - 2026-01-15
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 61a2e822
+- SDK version: 0.1.0
+
+## [0.1.1] - 2026-01-15
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 35211193
+- SDK version: 0.1.0
+
+## [0.1.0] - 2026-01-15
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 8b64ece5
+- SDK version: 0.1.0

airbyte_agent_slack-0.1.26/PKG-INFO

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: airbyte-agent-slack
+Version: 0.1.26
+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/
+Project-URL: Repository, https://github.com/airbytehq/airbyte-agent-connectors
+Project-URL: Issues, https://github.com/airbytehq/airbyte-agent-connectors/issues
+Author-email: Airbyte <contact@airbyte.io>
+License: Elastic-2.0
+Keywords: agent,ai,airbyte,api,connector,data-integration,llm,mcp,slack
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: jinja2>=3.0.0
+Requires-Dist: jsonpath-ng>=1.6.1
+Requires-Dist: jsonref>=1.1.0
+Requires-Dist: opentelemetry-api>=1.37.0
+Requires-Dist: opentelemetry-sdk>=1.37.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: segment-analytics-python>=2.2.0
+Description-Content-Type: text/markdown
+
+# Slack agent connector
+
+Slack is a business communication platform that offers messaging, file sharing, and integrations
+with other tools. This connector provides read access to users, channels, channel members, channel
+messages, and threads for workspace analytics. It also supports write operations including sending
+and updating messages, creating and renaming channels, setting channel topics and purposes, and
+adding reactions to messages.
+
+
+## Example questions
+
+The Slack connector is optimized to handle prompts like these.
+
+- List all users in my Slack workspace
+- Show me all public channels
+- Who are the members of channel \{channel_id\}?
+- Get messages from channel \{channel_id\}
+- Show me the thread replies for message \{ts\} in channel \{channel_id\}
+- List all channels I have access to
+- Get user details for user \{user_id\}
+- What messages were posted in channel \{channel_id\} last week?
+- Show me the conversation history for channel \{channel_id\}
+- List channel members for the general channel
+- Send a message to channel \{channel_id\} saying 'Hello team!'
+- Post a message in the general channel
+- Update the message with timestamp \{ts\} in channel \{channel_id\}
+- Create a new public channel called 'project-updates'
+- Create a private channel named 'team-internal'
+- Rename channel \{channel_id\} to 'new-channel-name'
+- Set the topic for channel \{channel_id\} to 'Daily standup notes'
+- Update the purpose of channel \{channel_id\}
+- Add a thumbsup reaction to message \{ts\} in channel \{channel_id\}
+- React with :rocket: to the latest message in channel \{channel_id\}
+- Reply to thread \{ts\} in channel \{channel_id\} with 'Thanks for the update!'
+
+## Unsupported questions
+
+The Slack connector isn't currently able to handle prompts like these.
+
+- Delete a message from channel \{channel_id\}
+- Remove a reaction from a message
+- Archive channel \{channel_id\}
+- Invite user \{user_id\} to channel \{channel_id\}
+- Remove user \{user_id\} from channel \{channel_id\}
+- Delete channel \{channel_id\}
+- Create a new user in the workspace
+- Update user profile information
+
+## Installation
+
+```bash
+uv pip install airbyte-agent-slack
+```
+
+## Usage
+
+Connectors can run in open source or hosted mode.
+
+### Open source
+
+In open source mode, you provide API credentials directly to the connector.
+
+```python
+from airbyte_agent_slack import SlackConnector
+from airbyte_agent_slack.models import SlackTokenAuthenticationAuthConfig
+
+connector = SlackConnector(
+    auth_config=SlackTokenAuthenticationAuthConfig(
+        api_token="<Your Slack Bot Token (xoxb-) or User Token (xoxp-)>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@SlackConnector.tool_utils
+async def slack_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+### Hosted
+
+In hosted mode, API credentials are stored securely in Airbyte Cloud. You provide your Airbyte credentials instead. 
+
+This example assumes you've already authenticated your connector with Airbyte. See [Authentication](AUTH.md) to learn more about authenticating. If you need a step-by-step guide, see the [hosted execution tutorial](https://docs.airbyte.com/ai-agents/quickstarts/tutorial-hosted).
+
+```python
+from airbyte_agent_slack import SlackConnector
+
+connector = SlackConnector(
+    external_user_id="<your_external_user_id>",
+    airbyte_client_id="<your-client-id>",
+    airbyte_client_secret="<your-client-secret>"
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@SlackConnector.tool_utils
+async def slack_execute(entity: str, action: str, params: dict | None = None):
+    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.
+
+| Entity | Actions |
+|--------|---------|
+| Users | [List](./REFERENCE.md#users-list), [Get](./REFERENCE.md#users-get) |
+| Channels | [List](./REFERENCE.md#channels-list), [Get](./REFERENCE.md#channels-get), [Create](./REFERENCE.md#channels-create), [Update](./REFERENCE.md#channels-update) |
+| Channel Messages | [List](./REFERENCE.md#channel-messages-list) |
+| Threads | [List](./REFERENCE.md#threads-list) |
+| Messages | [Create](./REFERENCE.md#messages-create), [Update](./REFERENCE.md#messages-update) |
+| Channel Topics | [Create](./REFERENCE.md#channel-topics-create) |
+| Channel Purposes | [Create](./REFERENCE.md#channel-purposes-create) |
+| Reactions | [Create](./REFERENCE.md#reactions-create) |
+
+
+For all authentication 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).
+
+For the service's official API docs, see the [Slack API reference](https://api.slack.com/methods).
+
+## Version information
+
+- **Package version:** 0.1.26
+- **Connector version:** 0.1.9
+- **Generated with Connector SDK commit SHA:** c9b05509eb899e313055660f378d9c1f1e9129c7

airbyte_agent_slack-0.1.26/README.md

@@ -0,0 +1,130 @@
+# Slack agent connector
+
+Slack is a business communication platform that offers messaging, file sharing, and integrations
+with other tools. This connector provides read access to users, channels, channel members, channel
+messages, and threads for workspace analytics. It also supports write operations including sending
+and updating messages, creating and renaming channels, setting channel topics and purposes, and
+adding reactions to messages.
+
+
+## Example questions
+
+The Slack connector is optimized to handle prompts like these.
+
+- List all users in my Slack workspace
+- Show me all public channels
+- Who are the members of channel \{channel_id\}?
+- Get messages from channel \{channel_id\}
+- Show me the thread replies for message \{ts\} in channel \{channel_id\}
+- List all channels I have access to
+- Get user details for user \{user_id\}
+- What messages were posted in channel \{channel_id\} last week?
+- Show me the conversation history for channel \{channel_id\}
+- List channel members for the general channel
+- Send a message to channel \{channel_id\} saying 'Hello team!'
+- Post a message in the general channel
+- Update the message with timestamp \{ts\} in channel \{channel_id\}
+- Create a new public channel called 'project-updates'
+- Create a private channel named 'team-internal'
+- Rename channel \{channel_id\} to 'new-channel-name'
+- Set the topic for channel \{channel_id\} to 'Daily standup notes'
+- Update the purpose of channel \{channel_id\}
+- Add a thumbsup reaction to message \{ts\} in channel \{channel_id\}
+- React with :rocket: to the latest message in channel \{channel_id\}
+- Reply to thread \{ts\} in channel \{channel_id\} with 'Thanks for the update!'
+
+## Unsupported questions
+
+The Slack connector isn't currently able to handle prompts like these.
+
+- Delete a message from channel \{channel_id\}
+- Remove a reaction from a message
+- Archive channel \{channel_id\}
+- Invite user \{user_id\} to channel \{channel_id\}
+- Remove user \{user_id\} from channel \{channel_id\}
+- Delete channel \{channel_id\}
+- Create a new user in the workspace
+- Update user profile information
+
+## Installation
+
+```bash
+uv pip install airbyte-agent-slack
+```
+
+## Usage
+
+Connectors can run in open source or hosted mode.
+
+### Open source
+
+In open source mode, you provide API credentials directly to the connector.
+
+```python
+from airbyte_agent_slack import SlackConnector
+from airbyte_agent_slack.models import SlackTokenAuthenticationAuthConfig
+
+connector = SlackConnector(
+    auth_config=SlackTokenAuthenticationAuthConfig(
+        api_token="<Your Slack Bot Token (xoxb-) or User Token (xoxp-)>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@SlackConnector.tool_utils
+async def slack_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+### Hosted
+
+In hosted mode, API credentials are stored securely in Airbyte Cloud. You provide your Airbyte credentials instead. 
+
+This example assumes you've already authenticated your connector with Airbyte. See [Authentication](AUTH.md) to learn more about authenticating. If you need a step-by-step guide, see the [hosted execution tutorial](https://docs.airbyte.com/ai-agents/quickstarts/tutorial-hosted).
+
+```python
+from airbyte_agent_slack import SlackConnector
+
+connector = SlackConnector(
+    external_user_id="<your_external_user_id>",
+    airbyte_client_id="<your-client-id>",
+    airbyte_client_secret="<your-client-secret>"
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@SlackConnector.tool_utils
+async def slack_execute(entity: str, action: str, params: dict | None = None):
+    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.
+
+| Entity | Actions |
+|--------|---------|
+| Users | [List](./REFERENCE.md#users-list), [Get](./REFERENCE.md#users-get) |
+| Channels | [List](./REFERENCE.md#channels-list), [Get](./REFERENCE.md#channels-get), [Create](./REFERENCE.md#channels-create), [Update](./REFERENCE.md#channels-update) |
+| Channel Messages | [List](./REFERENCE.md#channel-messages-list) |
+| Threads | [List](./REFERENCE.md#threads-list) |
+| Messages | [Create](./REFERENCE.md#messages-create), [Update](./REFERENCE.md#messages-update) |
+| Channel Topics | [Create](./REFERENCE.md#channel-topics-create) |
+| Channel Purposes | [Create](./REFERENCE.md#channel-purposes-create) |
+| Reactions | [Create](./REFERENCE.md#reactions-create) |
+
+
+For all authentication 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).
+
+For the service's official API docs, see the [Slack API reference](https://api.slack.com/methods).
+
+## Version information
+
+- **Package version:** 0.1.26
+- **Connector version:** 0.1.9
+- **Generated with Connector SDK commit SHA:** c9b05509eb899e313055660f378d9c1f1e9129c7