airbyte-agent-slack 0.1.19__tar.gz → 0.1.21__tar.gz

{airbyte_agent_slack-0.1.19 → airbyte_agent_slack-0.1.21}/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Slack changelog
 
+## [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

{airbyte_agent_slack-0.1.19 → airbyte_agent_slack-0.1.21}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: airbyte-agent-slack
-Version: 0.1.19
+Version: 0.1.21
 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/
@@ -130,6 +130,10 @@ 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.
@@ -154,6 +158,6 @@ For the service's official API docs, see the [Slack API reference](https://api.s
 
 ## Version information
 
-- **Package version:** 0.1.19
-- **Connector version:** 0.1.6
-- **Generated with Connector SDK commit SHA:** a035ad482faa8ceae3c296a0651e914e1dae140e
+- **Package version:** 0.1.21
+- **Connector version:** 0.1.8
+- **Generated with Connector SDK commit SHA:** 32c5ef4692be2243558faa20132b3ece7d573aed

{airbyte_agent_slack-0.1.19 → airbyte_agent_slack-0.1.21}/README.md

@@ -97,6 +97,10 @@ 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.
@@ -121,6 +125,6 @@ For the service's official API docs, see the [Slack API reference](https://api.s
 
 ## Version information
 
-- **Package version:** 0.1.19
-- **Connector version:** 0.1.6
-- **Generated with Connector SDK commit SHA:** a035ad482faa8ceae3c296a0651e914e1dae140e
+- **Package version:** 0.1.21
+- **Connector version:** 0.1.8
+- **Generated with Connector SDK commit SHA:** 32c5ef4692be2243558faa20132b3ece7d573aed

{airbyte_agent_slack-0.1.19 → airbyte_agent_slack-0.1.21}/REFERENCE.md

@@ -8,8 +8,8 @@ The Slack connector supports the following entities and actions.
 
 | Entity | Actions |
 |--------|---------|
-| Users | [List](#users-list), [Get](#users-get) |
-| Channels | [List](#channels-list), [Get](#channels-get), [Create](#channels-create), [Update](#channels-update) |
+| Users | [List](#users-list), [Get](#users-get), [Search](#users-search) |
+| Channels | [List](#channels-list), [Get](#channels-get), [Create](#channels-create), [Update](#channels-update), [Search](#channels-search) |
 | Channel Messages | [List](#channel-messages-list) |
 | Threads | [List](#threads-list) |
 | Messages | [Create](#messages-create), [Update](#messages-update) |
@@ -151,6 +151,109 @@ curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_i
 | `who_can_share_contact_card` | `string \| null` |  |
 
 
+</details>
+
+### Users Search
+
+Search and filter users records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.
+
+#### Python SDK
+
+```python
+await slack.users.search(
+    query={"filter": {"eq": {"color": "<str>"}}}
+)
+```
+
+#### API
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+    "entity": "users",
+    "action": "search",
+    "params": {
+        "query": {"filter": {"eq": {"color": "<str>"}}}
+    }
+}'
+```
+
+#### Parameters
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `query` | `object` | Yes | Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or |
+| `query.filter` | `object` | No | Filter conditions |
+| `query.sort` | `array` | No | Sort conditions |
+| `limit` | `integer` | No | Maximum results to return (default 1000) |
+| `cursor` | `string` | No | Pagination cursor from previous response's next_cursor |
+| `fields` | `array` | No | Field paths to include in results |
+
+#### Searchable Fields
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `color` | `string` | The color assigned to the user for visual purposes. |
+| `deleted` | `boolean` | Indicates if the user is deleted or not. |
+| `has_2fa` | `boolean` | Flag indicating if the user has two-factor authentication enabled. |
+| `id` | `string` | Unique identifier for the user. |
+| `is_admin` | `boolean` | Flag specifying if the user is an admin or not. |
+| `is_app_user` | `boolean` | Specifies if the user is an app user. |
+| `is_bot` | `boolean` | Indicates if the user is a bot account. |
+| `is_email_confirmed` | `boolean` | Flag indicating if the user's email is confirmed. |
+| `is_forgotten` | `boolean` | Specifies if the user is marked as forgotten. |
+| `is_invited_user` | `boolean` | Indicates if the user is invited or not. |
+| `is_owner` | `boolean` | Flag indicating if the user is an owner. |
+| `is_primary_owner` | `boolean` | Specifies if the user is the primary owner. |
+| `is_restricted` | `boolean` | Flag specifying if the user is restricted. |
+| `is_ultra_restricted` | `boolean` | Indicates if the user has ultra-restricted access. |
+| `name` | `string` | The username of the user. |
+| `profile` | `object` | User's profile information containing detailed details. |
+| `real_name` | `string` | The real name of the user. |
+| `team_id` | `string` | Unique identifier for the team the user belongs to. |
+| `tz` | `string` | Timezone of the user. |
+| `tz_label` | `string` | Label representing the timezone of the user. |
+| `tz_offset` | `integer` | Offset of the user's timezone. |
+| `updated` | `integer` | Timestamp of when the user's information was last updated. |
+| `who_can_share_contact_card` | `string` | Specifies who can share the user's contact card. |
+
+<details>
+<summary><b>Response Schema</b></summary>
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `hits` | `array` | List of matching records |
+| `hits[].id` | `string` | Record identifier |
+| `hits[].score` | `number` | Relevance score |
+| `hits[].data` | `object` | Record data containing the searchable fields listed above |
+| `hits[].data.color` | `string` | The color assigned to the user for visual purposes. |
+| `hits[].data.deleted` | `boolean` | Indicates if the user is deleted or not. |
+| `hits[].data.has_2fa` | `boolean` | Flag indicating if the user has two-factor authentication enabled. |
+| `hits[].data.id` | `string` | Unique identifier for the user. |
+| `hits[].data.is_admin` | `boolean` | Flag specifying if the user is an admin or not. |
+| `hits[].data.is_app_user` | `boolean` | Specifies if the user is an app user. |
+| `hits[].data.is_bot` | `boolean` | Indicates if the user is a bot account. |
+| `hits[].data.is_email_confirmed` | `boolean` | Flag indicating if the user's email is confirmed. |
+| `hits[].data.is_forgotten` | `boolean` | Specifies if the user is marked as forgotten. |
+| `hits[].data.is_invited_user` | `boolean` | Indicates if the user is invited or not. |
+| `hits[].data.is_owner` | `boolean` | Flag indicating if the user is an owner. |
+| `hits[].data.is_primary_owner` | `boolean` | Specifies if the user is the primary owner. |
+| `hits[].data.is_restricted` | `boolean` | Flag specifying if the user is restricted. |
+| `hits[].data.is_ultra_restricted` | `boolean` | Indicates if the user has ultra-restricted access. |
+| `hits[].data.name` | `string` | The username of the user. |
+| `hits[].data.profile` | `object` | User's profile information containing detailed details. |
+| `hits[].data.real_name` | `string` | The real name of the user. |
+| `hits[].data.team_id` | `string` | Unique identifier for the team the user belongs to. |
+| `hits[].data.tz` | `string` | Timezone of the user. |
+| `hits[].data.tz_label` | `string` | Label representing the timezone of the user. |
+| `hits[].data.tz_offset` | `integer` | Offset of the user's timezone. |
+| `hits[].data.updated` | `integer` | Timestamp of when the user's information was last updated. |
+| `hits[].data.who_can_share_contact_card` | `string` | Specifies who can share the user's contact card. |
+| `next_cursor` | `string \| null` | Cursor for next page of results |
+| `took_ms` | `number` | Query execution time in milliseconds |
+
 </details>
 
 ## Channels
@@ -471,6 +574,125 @@ curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_i
 | `is_read_only` | `boolean \| null` |  |
 
 
+</details>
+
+### Channels Search
+
+Search and filter channels records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.
+
+#### Python SDK
+
+```python
+await slack.channels.search(
+    query={"filter": {"eq": {"context_team_id": "<str>"}}}
+)
+```
+
+#### API
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+    "entity": "channels",
+    "action": "search",
+    "params": {
+        "query": {"filter": {"eq": {"context_team_id": "<str>"}}}
+    }
+}'
+```
+
+#### Parameters
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `query` | `object` | Yes | Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or |
+| `query.filter` | `object` | No | Filter conditions |
+| `query.sort` | `array` | No | Sort conditions |
+| `limit` | `integer` | No | Maximum results to return (default 1000) |
+| `cursor` | `string` | No | Pagination cursor from previous response's next_cursor |
+| `fields` | `array` | No | Field paths to include in results |
+
+#### Searchable Fields
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `context_team_id` | `string` | The unique identifier of the team context in which the channel exists. |
+| `created` | `integer` | The timestamp when the channel was created. |
+| `creator` | `string` | The ID of the user who created the channel. |
+| `id` | `string` | The unique identifier of the channel. |
+| `is_archived` | `boolean` | Indicates if the channel is archived. |
+| `is_channel` | `boolean` | Indicates if the entity is a channel. |
+| `is_ext_shared` | `boolean` | Indicates if the channel is externally shared. |
+| `is_general` | `boolean` | Indicates if the channel is a general channel in the workspace. |
+| `is_group` | `boolean` | Indicates if the channel is a group (private channel) rather than a regular channel. |
+| `is_im` | `boolean` | Indicates if the entity is a direct message (IM) channel. |
+| `is_member` | `boolean` | Indicates if the calling user is a member of the channel. |
+| `is_mpim` | `boolean` | Indicates if the entity is a multiple person direct message (MPIM) channel. |
+| `is_org_shared` | `boolean` | Indicates if the channel is organization-wide shared. |
+| `is_pending_ext_shared` | `boolean` | Indicates if the channel is pending external shared. |
+| `is_private` | `boolean` | Indicates if the channel is a private channel. |
+| `is_read_only` | `boolean` | Indicates if the channel is read-only. |
+| `is_shared` | `boolean` | Indicates if the channel is shared. |
+| `last_read` | `string` | The timestamp of the user's last read message in the channel. |
+| `locale` | `string` | The locale of the channel. |
+| `name` | `string` | The name of the channel. |
+| `name_normalized` | `string` | The normalized name of the channel. |
+| `num_members` | `integer` | The number of members in the channel. |
+| `parent_conversation` | `string` | The parent conversation of the channel. |
+| `pending_connected_team_ids` | `array` | The IDs of teams that are pending to be connected to the channel. |
+| `pending_shared` | `array` | The list of pending shared items of the channel. |
+| `previous_names` | `array` | The previous names of the channel. |
+| `purpose` | `object` | The purpose of the channel. |
+| `shared_team_ids` | `array` | The IDs of teams with which the channel is shared. |
+| `topic` | `object` | The topic of the channel. |
+| `unlinked` | `integer` | Indicates if the channel is unlinked. |
+| `updated` | `integer` | The timestamp when the channel was last updated. |
+
+<details>
+<summary><b>Response Schema</b></summary>
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `hits` | `array` | List of matching records |
+| `hits[].id` | `string` | Record identifier |
+| `hits[].score` | `number` | Relevance score |
+| `hits[].data` | `object` | Record data containing the searchable fields listed above |
+| `hits[].data.context_team_id` | `string` | The unique identifier of the team context in which the channel exists. |
+| `hits[].data.created` | `integer` | The timestamp when the channel was created. |
+| `hits[].data.creator` | `string` | The ID of the user who created the channel. |
+| `hits[].data.id` | `string` | The unique identifier of the channel. |
+| `hits[].data.is_archived` | `boolean` | Indicates if the channel is archived. |
+| `hits[].data.is_channel` | `boolean` | Indicates if the entity is a channel. |
+| `hits[].data.is_ext_shared` | `boolean` | Indicates if the channel is externally shared. |
+| `hits[].data.is_general` | `boolean` | Indicates if the channel is a general channel in the workspace. |
+| `hits[].data.is_group` | `boolean` | Indicates if the channel is a group (private channel) rather than a regular channel. |
+| `hits[].data.is_im` | `boolean` | Indicates if the entity is a direct message (IM) channel. |
+| `hits[].data.is_member` | `boolean` | Indicates if the calling user is a member of the channel. |
+| `hits[].data.is_mpim` | `boolean` | Indicates if the entity is a multiple person direct message (MPIM) channel. |
+| `hits[].data.is_org_shared` | `boolean` | Indicates if the channel is organization-wide shared. |
+| `hits[].data.is_pending_ext_shared` | `boolean` | Indicates if the channel is pending external shared. |
+| `hits[].data.is_private` | `boolean` | Indicates if the channel is a private channel. |
+| `hits[].data.is_read_only` | `boolean` | Indicates if the channel is read-only. |
+| `hits[].data.is_shared` | `boolean` | Indicates if the channel is shared. |
+| `hits[].data.last_read` | `string` | The timestamp of the user's last read message in the channel. |
+| `hits[].data.locale` | `string` | The locale of the channel. |
+| `hits[].data.name` | `string` | The name of the channel. |
+| `hits[].data.name_normalized` | `string` | The normalized name of the channel. |
+| `hits[].data.num_members` | `integer` | The number of members in the channel. |
+| `hits[].data.parent_conversation` | `string` | The parent conversation of the channel. |
+| `hits[].data.pending_connected_team_ids` | `array` | The IDs of teams that are pending to be connected to the channel. |
+| `hits[].data.pending_shared` | `array` | The list of pending shared items of the channel. |
+| `hits[].data.previous_names` | `array` | The previous names of the channel. |
+| `hits[].data.purpose` | `object` | The purpose of the channel. |
+| `hits[].data.shared_team_ids` | `array` | The IDs of teams with which the channel is shared. |
+| `hits[].data.topic` | `object` | The topic of the channel. |
+| `hits[].data.unlinked` | `integer` | Indicates if the channel is unlinked. |
+| `hits[].data.updated` | `integer` | The timestamp when the channel was last updated. |
+| `next_cursor` | `string \| null` | Cursor for next page of results |
+| `took_ms` | `number` | Query execution time in milliseconds |
+
 </details>
 
 ## Channel Messages
@@ -1065,3 +1287,39 @@ curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_i
 
 </details>
 
+
+
+## Replication Configuration
+
+Settings for data replication from Slack
+
+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 | UTC date and time in the format YYYY-MM-DDTHH:mm:ssZ from which to start replicating data. |
+| `lookback_window` | `int` | Yes | Number of days to look back when syncing data (0-365). |
+| `join_channels` | `bool` | Yes | Whether to automatically join public channels to sync messages. |
+
+### 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": "slack",
+  "credentials": {
+    ...
+  },
+  "replication_config": {
+    "start_date": "<UTC date and time in the format YYYY-MM-DDTHH:mm:ssZ from which to start replicating data.>",
+    "lookback_window": "<Number of days to look back when syncing data (0-365).>",
+    "join_channels": "<Whether to automatically join public channels to sync messages.>"
+  },
+  "name": "My Slack Connector"
+}'
+```

{airbyte_agent_slack-0.1.19 → airbyte_agent_slack-0.1.21}/airbyte_agent_slack/__init__.py

@@ -17,8 +17,8 @@ from .models import (
     ChannelPurpose,
     ChannelsListResponse,
     ChannelResponse,
-    File,
     Reaction,
+    File,
     Attachment,
     Message,
     Thread,
@@ -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__ = [
@@ -81,8 +95,8 @@ __all__ = [
     "ChannelPurpose",
     "ChannelsListResponse",
     "ChannelResponse",
-    "File",
     "Reaction",
+    "File",
     "Attachment",
     "Message",
     "Thread",
@@ -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-0.1.19 → airbyte_agent_slack-0.1.21}/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-0.1.19 → airbyte_agent_slack-0.1.21}/airbyte_agent_slack/_vendored/connector_sdk/schema/base.py

@@ -13,7 +13,7 @@ from uuid import UUID
 from pydantic import BaseModel, ConfigDict, Field, field_validator
 from pydantic_core import Url
 
-from .extensions import CacheConfig, RetryConfig
+from .extensions import CacheConfig, ReplicationConfig, RetryConfig
 
 
 class ExampleQuestions(BaseModel):
@@ -106,6 +106,7 @@ class Info(BaseModel):
     - x-airbyte-retry-config: Retry configuration for transient errors (Airbyte extension)
     - x-airbyte-example-questions: Example questions for AI connector README (Airbyte extension)
     - x-airbyte-cache: Cache configuration for field mapping between API and cache schemas (Airbyte extension)
+    - x-airbyte-replication-config: Replication configuration for MULTI mode connectors (Airbyte extension)
     """
 
     model_config = ConfigDict(populate_by_name=True, extra="forbid")
@@ -124,6 +125,7 @@ class Info(BaseModel):
     x_airbyte_retry_config: RetryConfig | None = Field(None, alias="x-airbyte-retry-config")
     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")
 
 
 class ServerVariable(BaseModel):

{airbyte_agent_slack-0.1.19 → airbyte_agent_slack-0.1.21}/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-0.1.19 → airbyte_agent_slack-0.1.21}/airbyte_agent_slack/_vendored/connector_sdk/schema/extensions.py

@@ -182,6 +182,77 @@ class CacheEntityConfig(BaseModel):
         return self.x_airbyte_name or self.entity
 
 
+class ReplicationConfigProperty(BaseModel):
+    """
+    Property definition for replication configuration fields.
+
+    Defines a single field in the replication configuration with its type,
+    description, and optional default value.
+
+    Example YAML usage:
+        x-airbyte-replication-config:
+          properties:
+            start_date:
+              type: string
+              title: Start Date
+              description: UTC date and time from which to replicate data
+              format: date-time
+    """
+
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+
+    type: str
+    title: str | None = None
+    description: str | None = None
+    format: str | None = None
+    default: str | int | float | bool | None = None
+    enum: list[str] | None = None
+
+
+class ReplicationConfig(BaseModel):
+    """
+    Replication configuration extension (x-airbyte-replication-config).
+
+    Defines replication-specific settings for MULTI mode connectors that need
+    to configure the underlying replication connector. This allows users who
+    use the direct-style API (credentials + environment) to also specify
+    replication settings like start_date, lookback_window, etc.
+
+    This extension is added to the Info model and provides field definitions
+    for replication configuration that gets merged into the source config
+    when creating sources.
+
+    Example YAML usage:
+        info:
+          title: HubSpot API
+          x-airbyte-replication-config:
+            title: Replication Configuration
+            description: Settings for data replication
+            properties:
+              start_date:
+                type: string
+                title: Start Date
+                description: UTC date and time from which to replicate data
+                format: date-time
+            required:
+              - start_date
+            replication_config_key_mapping:
+              start_date: start_date
+    """
+
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+
+    title: str | None = None
+    description: str | None = None
+    properties: dict[str, ReplicationConfigProperty] = Field(default_factory=dict)
+    required: list[str] = Field(default_factory=list)
+    replication_config_key_mapping: dict[str, str] = Field(
+        default_factory=dict,
+        alias="replication_config_key_mapping",
+        description="Mapping from replication_config field names to source_config field names",
+    )
+
+
 class CacheConfig(BaseModel):
     """
     Cache configuration extension (x-airbyte-cache).