airbyte-agent-gitlab 0.1.0__tar.gz

airbyte_agent_gitlab-0.1.0/.gitignore

@@ -0,0 +1,34 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Virtual environments
+.venv/
+venv/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db
+
+.env
+configured_connectors.yaml
+
+# Claude Code development symlink
+# Contributors: Create this symlink locally for skill testing
+# mkdir -p .claude/skills && ln -s ../../skills/airbyte-agent-connectors .claude/skills/airbyte-agent-connectors
+.claude/skills/airbyte-agent-connectors

airbyte_agent_gitlab-0.1.0/AUTH.md

@@ -0,0 +1,223 @@
+# Gitlab authentication
+
+This page documents the authentication and configuration options for the Gitlab agent connector.
+
+## Authentication
+
+### Open source execution
+
+In open source mode, you provide API credentials directly to the connector.
+
+#### OAuth
+
+`credentials` fields you need:
+
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `client_id` | `str` | Yes | The API ID of the GitLab developer application. |
+| `client_secret` | `str` | Yes | The API Secret of the GitLab developer application. |
+| `access_token` | `str` | Yes | Access Token for making authenticated requests. |
+| `refresh_token` | `str` | Yes | The key to refresh the expired access token. |
+
+Example request:
+
+```python
+from airbyte_agent_gitlab import GitlabConnector
+from airbyte_agent_gitlab.models import GitlabOauth20AuthConfig
+
+connector = GitlabConnector(
+    auth_config=GitlabOauth20AuthConfig(
+        client_id="<The API ID of the GitLab developer application.>",
+        client_secret="<The API Secret of the GitLab developer application.>",
+        access_token="<Access Token for making authenticated requests.>",
+        refresh_token="<The key to refresh the expired access token.>"
+    )
+)
+```
+
+#### Token
+
+`credentials` fields you need:
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `access_token` | `str` | Yes | Log into your GitLab account and generate a personal access token. |
+
+Example request:
+
+```python
+from airbyte_agent_gitlab import GitlabConnector
+from airbyte_agent_gitlab.models import GitlabPersonalAccessTokenAuthConfig
+
+connector = GitlabConnector(
+    auth_config=GitlabPersonalAccessTokenAuthConfig(
+        access_token="<Log into your GitLab account and generate a personal access token.>"
+    )
+)
+```
+
+### 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.
+
+`credentials` fields you need:
+
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `client_id` | `str` | Yes | The API ID of the GitLab developer application. |
+| `client_secret` | `str` | Yes | The API Secret of the GitLab developer application. |
+| `access_token` | `str` | Yes | Access Token for making authenticated requests. |
+| `refresh_token` | `str` | Yes | The key to refresh the expired access token. |
+
+`replication_config` fields you need:
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `start_date` | `str (date-time)` | No | UTC date and time in the format YYYY-MM-DDTHH:mm:ssZ from which to start replicating data. If not set, all data will be replicated. |
+
+Example request:
+
+```bash
+curl -X POST "https://api.airbyte.ai/api/v1/integrations/connectors" \
+  -H "Authorization: Bearer <YOUR_BEARER_TOKEN>" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "customer_name": "<CUSTOMER_NAME>",
+    "connector_type": "Gitlab",
+    "name": "My Gitlab Connector",
+    "credentials": {
+      "client_id": "<The API ID of the GitLab developer application.>",
+      "client_secret": "<The API Secret of the GitLab developer application.>",
+      "access_token": "<Access Token for making authenticated requests.>",
+      "refresh_token": "<The key to refresh the expired access token.>"
+    },
+    "replication_config": {
+      "start_date": "<UTC date and time in the format YYYY-MM-DDTHH:mm:ssZ from which to start replicating data. If not set, all data will be replicated.>"
+    }
+  }'
+```
+
+
+
+#### Bring your own OAuth flow
+To implement your own OAuth flow, use Airbyte's server-side OAuth API endpoints. For a complete guide, see [Build your own OAuth flow](https://docs.airbyte.com/ai-agents/platform/authenticate/build-auth/build-your-own).
+
+##### Step 1: Initiate the OAuth flow
+
+Request a consent URL for your user.
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `customer_name` | `string` | Yes | Your unique identifier for the customer |
+| `connector_type` | `string` | Yes | The connector type (e.g., "Gitlab") |
+| `redirect_url` | `string` | Yes | URL to redirect to after OAuth authorization |
+
+Example request:
+
+```bash
+curl -X POST "https://api.airbyte.ai/api/v1/integrations/connectors/oauth/initiate" \
+  -H "Authorization: Bearer <YOUR_BEARER_TOKEN>" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "customer_name": "<CUSTOMER_NAME>",
+    "connector_type": "Gitlab",
+    "redirect_url": "https://yourapp.com/oauth/callback"
+  }'
+```
+
+Redirect your user to the `consent_url` from the response.
+
+##### Step 2: Handle the callback
+
+After the user authorizes access, Airbyte automatically creates the connector and redirects them to your `redirect_url` with a `connector_id` query parameter. You don't need to make a separate API call to create the connector.
+
+```text
+https://yourapp.com/oauth/callback?connector_id=<connector_id>
+```
+
+Extract the `connector_id` from the callback URL and store it for future operations. For error handling and a complete implementation example, see [Build your own OAuth flow](https://docs.airbyte.com/ai-agents/platform/authenticate/build-auth/build-your-own#part-3-handle-the-callback).
+
+#### Token
+Create a connector with Token credentials.
+
+
+`credentials` fields you need:
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `access_token` | `str` | Yes | Log into your GitLab account and generate a personal access token. |
+
+`replication_config` fields you need:
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `start_date` | `str (date-time)` | No | UTC date and time in the format YYYY-MM-DDTHH:mm:ssZ from which to start replicating data. If not set, all data will be replicated. |
+
+Example request:
+
+
+```bash
+curl -X POST "https://api.airbyte.ai/api/v1/integrations/connectors" \
+  -H "Authorization: Bearer <YOUR_BEARER_TOKEN>" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "customer_name": "<CUSTOMER_NAME>",
+    "connector_type": "Gitlab",
+    "name": "My Gitlab Connector",
+    "credentials": {
+      "access_token": "<Log into your GitLab account and generate a personal access token.>"
+    },
+    "replication_config": {
+      "start_date": "<UTC date and time in the format YYYY-MM-DDTHH:mm:ssZ from which to start replicating data. If not set, all data will be replicated.>"
+    }
+  }'
+```
+
+#### Execution
+
+After creating the connector, execute operations using either the Python SDK or API.
+If your Airbyte client can access multiple organizations, include `organization_id` in `AirbyteAuthConfig` and `X-Organization-Id` in raw API calls.
+
+**Python SDK**
+
+```python
+from airbyte_agent_gitlab import GitlabConnector, AirbyteAuthConfig
+
+connector = GitlabConnector(
+    auth_config=AirbyteAuthConfig(
+        customer_name="<your_customer_name>",
+        organization_id="<your_organization_id>",  # Optional for multi-org clients
+        airbyte_client_id="<your-client-id>",
+        airbyte_client_secret="<your-client-secret>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@GitlabConnector.tool_utils
+async def gitlab_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/integrations/connectors/<connector_id>/execute' \
+  -H 'Authorization: Bearer <YOUR_BEARER_TOKEN>' \
+  -H 'X-Organization-Id: <YOUR_ORGANIZATION_ID>' \
+  -H 'Content-Type: application/json' \
+  -d '{"entity": "<entity>", "action": "<action>", "params": {}}'
+```
+
+
+## Configuration
+
+The Gitlab connector requires the following configuration variables. These variables are used to construct the base API URL. Pass them via the `config` parameter when initializing the connector.
+
+| Variable | Type | Required | Default | Description |
+|----------|------|----------|---------|-------------|
+| `api_url` | `string` | Yes | gitlab.com | GitLab instance hostname |

airbyte_agent_gitlab-0.1.0/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Gitlab changelog
+
+## [0.1.0] - 2026-03-05
+- Updated connector definition (YAML version 1.0.1)
+- Source commit: 61c1d075
+- SDK version: 0.1.0

airbyte_agent_gitlab-0.1.0/PKG-INFO

@@ -0,0 +1,159 @@
+Metadata-Version: 2.4
+Name: airbyte-agent-gitlab
+Version: 0.1.0
+Summary: Airbyte Gitlab 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,gitlab,llm,mcp
+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
+
+# Gitlab
+
+The Gitlab agent connector is a Python package that equips AI agents to interact with Gitlab through strongly typed, well-documented tools. It's ready to use directly in your Python app, in an agent framework, or exposed through an MCP.
+
+Connector for the GitLab REST API (v4). Provides access to projects, issues, merge requests, commits, pipelines, groups, branches, releases, tags, members, milestones, and users. Supports both Personal Access Token and OAuth2 authentication.
+
+
+## Example questions
+
+The Gitlab connector is optimized to handle prompts like these.
+
+- List all projects I have access to
+- Get the details of a specific project
+- List all open issues in a project
+- Show merge requests for a project
+- List all groups I belong to
+- Show recent commits in a project
+- List pipelines for a project
+- Show all branches in a project
+- Find issues updated in the last week
+- What are the most active projects?
+- Show merge requests that are still open
+- List projects with the most commits
+
+## Unsupported questions
+
+The Gitlab connector isn't currently able to handle prompts like these.
+
+- Create a new project
+- Delete an issue
+- Merge a merge request
+- Trigger a pipeline
+
+## Installation
+
+```bash
+uv pip install airbyte-agent-gitlab
+```
+
+## 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_gitlab import GitlabConnector
+from airbyte_agent_gitlab.models import GitlabPersonalAccessTokenAuthConfig
+
+connector = GitlabConnector(
+    auth_config=GitlabPersonalAccessTokenAuthConfig(
+        access_token="<Log into your GitLab account and generate a personal access token.>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@GitlabConnector.tool_utils
+async def gitlab_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. 
+If your Airbyte client can access multiple organizations, also set `organization_id`.
+
+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_gitlab import GitlabConnector, AirbyteAuthConfig
+
+connector = GitlabConnector(
+    auth_config=AirbyteAuthConfig(
+        customer_name="<your_customer_name>",
+        organization_id="<your_organization_id>",  # Optional for multi-org clients
+        airbyte_client_id="<your-client-id>",
+        airbyte_client_secret="<your-client-secret>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@GitlabConnector.tool_utils
+async def gitlab_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+## Full documentation
+
+### 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 |
+|--------|---------|
+| Projects | [List](./REFERENCE.md#projects-list), [Get](./REFERENCE.md#projects-get), [Search](./REFERENCE.md#projects-search) |
+| Issues | [List](./REFERENCE.md#issues-list), [Get](./REFERENCE.md#issues-get), [Search](./REFERENCE.md#issues-search) |
+| Merge Requests | [List](./REFERENCE.md#merge-requests-list), [Get](./REFERENCE.md#merge-requests-get), [Search](./REFERENCE.md#merge-requests-search) |
+| Users | [List](./REFERENCE.md#users-list), [Get](./REFERENCE.md#users-get), [Search](./REFERENCE.md#users-search) |
+| Commits | [List](./REFERENCE.md#commits-list), [Get](./REFERENCE.md#commits-get), [Search](./REFERENCE.md#commits-search) |
+| Groups | [List](./REFERENCE.md#groups-list), [Get](./REFERENCE.md#groups-get), [Search](./REFERENCE.md#groups-search) |
+| Branches | [List](./REFERENCE.md#branches-list), [Get](./REFERENCE.md#branches-get), [Search](./REFERENCE.md#branches-search) |
+| Pipelines | [List](./REFERENCE.md#pipelines-list), [Get](./REFERENCE.md#pipelines-get), [Search](./REFERENCE.md#pipelines-search) |
+| Group Members | [List](./REFERENCE.md#group-members-list), [Get](./REFERENCE.md#group-members-get), [Search](./REFERENCE.md#group-members-search) |
+| Project Members | [List](./REFERENCE.md#project-members-list), [Get](./REFERENCE.md#project-members-get), [Search](./REFERENCE.md#project-members-search) |
+| Releases | [List](./REFERENCE.md#releases-list), [Get](./REFERENCE.md#releases-get), [Search](./REFERENCE.md#releases-search) |
+| Tags | [List](./REFERENCE.md#tags-list), [Get](./REFERENCE.md#tags-get), [Search](./REFERENCE.md#tags-search) |
+| Group Milestones | [List](./REFERENCE.md#group-milestones-list), [Get](./REFERENCE.md#group-milestones-get), [Search](./REFERENCE.md#group-milestones-search) |
+| Project Milestones | [List](./REFERENCE.md#project-milestones-list), [Get](./REFERENCE.md#project-milestones-get), [Search](./REFERENCE.md#project-milestones-search) |
+
+
+### Authentication
+
+For all authentication options, see the connector's [authentication documentation](AUTH.md).
+
+### Gitlab API docs
+
+See the official [Gitlab API reference](https://docs.gitlab.com/ee/api/rest/).
+
+## Version information
+
+- **Package version:** 0.1.0
+- **Connector version:** 1.0.1
+- **Generated with Connector SDK commit SHA:** 61c1d075030e7c6e84f9e5f04149b8f8ab4a14ae
+- **Changelog:** [View changelog](https://github.com/airbytehq/airbyte-agent-connectors/blob/main/connectors/gitlab/CHANGELOG.md)

airbyte_agent_gitlab-0.1.0/README.md

@@ -0,0 +1,126 @@
+# Gitlab
+
+The Gitlab agent connector is a Python package that equips AI agents to interact with Gitlab through strongly typed, well-documented tools. It's ready to use directly in your Python app, in an agent framework, or exposed through an MCP.
+
+Connector for the GitLab REST API (v4). Provides access to projects, issues, merge requests, commits, pipelines, groups, branches, releases, tags, members, milestones, and users. Supports both Personal Access Token and OAuth2 authentication.
+
+
+## Example questions
+
+The Gitlab connector is optimized to handle prompts like these.
+
+- List all projects I have access to
+- Get the details of a specific project
+- List all open issues in a project
+- Show merge requests for a project
+- List all groups I belong to
+- Show recent commits in a project
+- List pipelines for a project
+- Show all branches in a project
+- Find issues updated in the last week
+- What are the most active projects?
+- Show merge requests that are still open
+- List projects with the most commits
+
+## Unsupported questions
+
+The Gitlab connector isn't currently able to handle prompts like these.
+
+- Create a new project
+- Delete an issue
+- Merge a merge request
+- Trigger a pipeline
+
+## Installation
+
+```bash
+uv pip install airbyte-agent-gitlab
+```
+
+## 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_gitlab import GitlabConnector
+from airbyte_agent_gitlab.models import GitlabPersonalAccessTokenAuthConfig
+
+connector = GitlabConnector(
+    auth_config=GitlabPersonalAccessTokenAuthConfig(
+        access_token="<Log into your GitLab account and generate a personal access token.>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@GitlabConnector.tool_utils
+async def gitlab_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. 
+If your Airbyte client can access multiple organizations, also set `organization_id`.
+
+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_gitlab import GitlabConnector, AirbyteAuthConfig
+
+connector = GitlabConnector(
+    auth_config=AirbyteAuthConfig(
+        customer_name="<your_customer_name>",
+        organization_id="<your_organization_id>",  # Optional for multi-org clients
+        airbyte_client_id="<your-client-id>",
+        airbyte_client_secret="<your-client-secret>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@GitlabConnector.tool_utils
+async def gitlab_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+## Full documentation
+
+### 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 |
+|--------|---------|
+| Projects | [List](./REFERENCE.md#projects-list), [Get](./REFERENCE.md#projects-get), [Search](./REFERENCE.md#projects-search) |
+| Issues | [List](./REFERENCE.md#issues-list), [Get](./REFERENCE.md#issues-get), [Search](./REFERENCE.md#issues-search) |
+| Merge Requests | [List](./REFERENCE.md#merge-requests-list), [Get](./REFERENCE.md#merge-requests-get), [Search](./REFERENCE.md#merge-requests-search) |
+| Users | [List](./REFERENCE.md#users-list), [Get](./REFERENCE.md#users-get), [Search](./REFERENCE.md#users-search) |
+| Commits | [List](./REFERENCE.md#commits-list), [Get](./REFERENCE.md#commits-get), [Search](./REFERENCE.md#commits-search) |
+| Groups | [List](./REFERENCE.md#groups-list), [Get](./REFERENCE.md#groups-get), [Search](./REFERENCE.md#groups-search) |
+| Branches | [List](./REFERENCE.md#branches-list), [Get](./REFERENCE.md#branches-get), [Search](./REFERENCE.md#branches-search) |
+| Pipelines | [List](./REFERENCE.md#pipelines-list), [Get](./REFERENCE.md#pipelines-get), [Search](./REFERENCE.md#pipelines-search) |
+| Group Members | [List](./REFERENCE.md#group-members-list), [Get](./REFERENCE.md#group-members-get), [Search](./REFERENCE.md#group-members-search) |
+| Project Members | [List](./REFERENCE.md#project-members-list), [Get](./REFERENCE.md#project-members-get), [Search](./REFERENCE.md#project-members-search) |
+| Releases | [List](./REFERENCE.md#releases-list), [Get](./REFERENCE.md#releases-get), [Search](./REFERENCE.md#releases-search) |
+| Tags | [List](./REFERENCE.md#tags-list), [Get](./REFERENCE.md#tags-get), [Search](./REFERENCE.md#tags-search) |
+| Group Milestones | [List](./REFERENCE.md#group-milestones-list), [Get](./REFERENCE.md#group-milestones-get), [Search](./REFERENCE.md#group-milestones-search) |
+| Project Milestones | [List](./REFERENCE.md#project-milestones-list), [Get](./REFERENCE.md#project-milestones-get), [Search](./REFERENCE.md#project-milestones-search) |
+
+
+### Authentication
+
+For all authentication options, see the connector's [authentication documentation](AUTH.md).
+
+### Gitlab API docs
+
+See the official [Gitlab API reference](https://docs.gitlab.com/ee/api/rest/).
+
+## Version information
+
+- **Package version:** 0.1.0
+- **Connector version:** 1.0.1
+- **Generated with Connector SDK commit SHA:** 61c1d075030e7c6e84f9e5f04149b8f8ab4a14ae
+- **Changelog:** [View changelog](https://github.com/airbytehq/airbyte-agent-connectors/blob/main/connectors/gitlab/CHANGELOG.md)