vectoramp 0.3.0__tar.gz → 0.4.0__tar.gz

{vectoramp-0.3.0 → vectoramp-0.4.0}/CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to this project will be documented in this file.
 
 This project follows semantic versioning.
 
+## [0.4.0] - 2026-08-20
+
+### Added
+
+- Add `GitHubSource` and `GitLabSource` typed source builders.
+- Add `client.sources.create_github(...)` and `client.sources.create_gitlab(...)`.
+
 ## [0.3.0] - 2026-07-20
 
 ### Added

{vectoramp-0.3.0 → vectoramp-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: vectoramp
-Version: 0.3.0
+Version: 0.4.0
 Summary: Python SDK for the VectorAmp API
 Project-URL: Homepage, https://vectoramp.com
 Project-URL: Documentation, https://docs.vectoramp.com
@@ -332,16 +332,40 @@ gdrive = client.sources.create_google_drive(
     include_shared_drives=True,
 )
 
+github = client.sources.create_github(
+    installation_id=42,                 # from the VectorAmp GitHub App install
+    repositories=["acme/api", "acme/web"],
+    ref_mode="active",                  # server default: recently pushed branches
+    include_pull_requests=True,         # default
+)
+
+gitlab = client.sources.create_gitlab(
+    projects=["mygroup/myproject"],     # and/or groups=["mygroup"]
+    auth_mode="token",                  # defaults to "oauth"
+    access_token="…",
+    gitlab_url="https://gitlab.com",    # override for self-managed
+)
+
 upload_source = client.sources.create_file_upload()
 ```
 
+GitHub sources authenticate through the VectorAmp GitHub App, so the SDK never
+takes a GitHub token. Install the app from the Sources page in the VectorAmp
+app, then pass the `installation_id` it reports along with the `owner/repo`
+names you want ingested. Both connectors ingest repository files plus active
+branches, pull/merge requests, and review discussions; turn parts off with
+`include_pull_requests` / `include_merge_requests`, `include_review_threads`,
+and `include_direct_commits`, and narrow file selection with `include_globs`,
+`exclude_globs`, and `max_file_size_bytes`.
+
 `sync_mode` is omitted unless you set it, so the server applies its default of
 `"incremental"` for the connectors that support it. Pass `sync_mode="full"` to
 force a full re-sync.
 
 The supported typed source classes are `WebSource`, `S3Source`, `GCSSource`,
 `GoogleDriveSource` (`source_type="gdrive"`), `JiraSource`, `ConfluenceSource`,
-and `FileUploadSource` (`source_type="file_upload"`). Use `GenericSource` as an
+`GitHubSource`, `GitLabSource`, and `FileUploadSource`
+(`source_type="file_upload"`). Use `GenericSource` as an
 escape hatch when the API supports a source type before the SDK has a dedicated
 class:
 

{vectoramp-0.3.0 → vectoramp-0.4.0}/README.md

@@ -302,16 +302,40 @@ gdrive = client.sources.create_google_drive(
     include_shared_drives=True,
 )
 
+github = client.sources.create_github(
+    installation_id=42,                 # from the VectorAmp GitHub App install
+    repositories=["acme/api", "acme/web"],
+    ref_mode="active",                  # server default: recently pushed branches
+    include_pull_requests=True,         # default
+)
+
+gitlab = client.sources.create_gitlab(
+    projects=["mygroup/myproject"],     # and/or groups=["mygroup"]
+    auth_mode="token",                  # defaults to "oauth"
+    access_token="…",
+    gitlab_url="https://gitlab.com",    # override for self-managed
+)
+
 upload_source = client.sources.create_file_upload()
 ```
 
+GitHub sources authenticate through the VectorAmp GitHub App, so the SDK never
+takes a GitHub token. Install the app from the Sources page in the VectorAmp
+app, then pass the `installation_id` it reports along with the `owner/repo`
+names you want ingested. Both connectors ingest repository files plus active
+branches, pull/merge requests, and review discussions; turn parts off with
+`include_pull_requests` / `include_merge_requests`, `include_review_threads`,
+and `include_direct_commits`, and narrow file selection with `include_globs`,
+`exclude_globs`, and `max_file_size_bytes`.
+
 `sync_mode` is omitted unless you set it, so the server applies its default of
 `"incremental"` for the connectors that support it. Pass `sync_mode="full"` to
 force a full re-sync.
 
 The supported typed source classes are `WebSource`, `S3Source`, `GCSSource`,
 `GoogleDriveSource` (`source_type="gdrive"`), `JiraSource`, `ConfluenceSource`,
-and `FileUploadSource` (`source_type="file_upload"`). Use `GenericSource` as an
+`GitHubSource`, `GitLabSource`, and `FileUploadSource`
+(`source_type="file_upload"`). Use `GenericSource` as an
 escape hatch when the API supports a source type before the SDK has a dedicated
 class:
 

{vectoramp-0.3.0 → vectoramp-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "vectoramp"
-version = "0.3.0"
+version = "0.4.0"
 description = "Python SDK for the VectorAmp API"
 readme = "README.md"
 requires-python = ">=3.9"

{vectoramp-0.3.0 → vectoramp-0.4.0}/src/vectoramp/__init__.py

@@ -16,6 +16,8 @@ from .sources import (
     FileUploadSource,
     GCSSource,
     GenericSource,
+    GitHubSource,
+    GitLabSource,
     GoogleDriveSource,
     JiraSource,
     S3Source,
@@ -33,6 +35,8 @@ __all__ = [
     "FileUploadSource",
     "GCSSource",
     "GenericSource",
+    "GitHubSource",
+    "GitLabSource",
     "GoogleDriveSource",
     "JiraSource",
     "MetadataFieldType",

{vectoramp-0.3.0 → vectoramp-0.4.0}/src/vectoramp/resources.py

@@ -20,6 +20,8 @@ from .sources import (
     ConfluenceSource,
     FileUploadSource,
     GCSSource,
+    GitHubSource,
+    GitLabSource,
     GoogleDriveSource,
     JiraSource,
     S3Source,
@@ -710,7 +712,7 @@ class DatasetsResource:
         if write_concern is not None:
             body["write_concern"] = dict(write_concern)
         return self._transport.request(
-            "DELETE", f"/api/v1/datasets/{dataset_id}/vectors", json_body=body
+            "DELETE", f"/datasets/{dataset_id}/vectors", json_body=body
         )
 
     def embed(
@@ -1243,6 +1245,123 @@ class IngestionResource:
             )
         )
 
+    def create_github(
+        self,
+        *,
+        installation_id: int,
+        repositories: Sequence[str],
+        name: Optional[str] = None,
+        ref_mode: Optional[str] = None,
+        refs: Optional[Sequence[str]] = None,
+        excluded_refs: Optional[Sequence[str]] = None,
+        active_branch_days: Optional[int] = None,
+        include_pull_requests: Optional[bool] = None,
+        include_review_threads: Optional[bool] = None,
+        include_direct_commits: Optional[bool] = None,
+        include_globs: Optional[Sequence[str]] = None,
+        exclude_globs: Optional[Sequence[str]] = None,
+        max_file_size_bytes: Optional[int] = None,
+        sync_mode: Optional[str] = None,
+        description: Optional[str] = None,
+        metadata: Optional[Mapping[str, Any]] = None,
+        config_extra: Optional[Mapping[str, Any]] = None,
+    ) -> JSON:
+        """Create a GitHub source backed by the VectorAmp GitHub App.
+
+        Install the VectorAmp GitHub App from the app's Sources page first and
+        pass the resulting ``installation_id`` here; the SDK never handles a
+        GitHub token. ``name`` defaults to ``github-{first-repository}``.
+        Optional settings are omitted when ``None`` so the server applies its
+        defaults (``ref_mode="active"``, pull requests, review threads, and
+        direct commits included, ``sync_mode="incremental"``).
+
+        Returns:
+            Created source JSON.
+        """
+        return self.create_source(
+            GitHubSource(
+                name=name,
+                installation_id=installation_id,
+                repositories=repositories,
+                ref_mode=ref_mode,
+                refs=refs,
+                excluded_refs=excluded_refs,
+                active_branch_days=active_branch_days,
+                include_pull_requests=include_pull_requests,
+                include_review_threads=include_review_threads,
+                include_direct_commits=include_direct_commits,
+                include_globs=include_globs,
+                exclude_globs=exclude_globs,
+                max_file_size_bytes=max_file_size_bytes,
+                sync_mode=sync_mode,
+                description=description,
+                metadata=metadata,
+                config_extra=config_extra,
+            )
+        )
+
+    def create_gitlab(
+        self,
+        *,
+        groups: Optional[Sequence[str]] = None,
+        projects: Optional[Sequence[str]] = None,
+        name: Optional[str] = None,
+        auth_mode: str = "oauth",
+        gitlab_url: str = "https://gitlab.com",
+        access_token: Optional[str] = None,
+        connection_id: Optional[str] = None,
+        ref_mode: Optional[str] = None,
+        refs: Optional[Sequence[str]] = None,
+        excluded_refs: Optional[Sequence[str]] = None,
+        active_branch_days: Optional[int] = None,
+        include_merge_requests: Optional[bool] = None,
+        include_review_threads: Optional[bool] = None,
+        include_direct_commits: Optional[bool] = None,
+        include_globs: Optional[Sequence[str]] = None,
+        exclude_globs: Optional[Sequence[str]] = None,
+        max_file_size_bytes: Optional[int] = None,
+        sync_mode: Optional[str] = None,
+        description: Optional[str] = None,
+        metadata: Optional[Mapping[str, Any]] = None,
+        config_extra: Optional[Mapping[str, Any]] = None,
+    ) -> JSON:
+        """Create a GitLab source for gitlab.com or a self-managed instance.
+
+        Pass at least one group or project. Authenticate with
+        ``auth_mode="token"`` plus ``access_token``, or with a stored OAuth
+        ``connection_id``. ``name`` defaults to
+        ``gitlab-{first-project-or-group}``. Optional settings are omitted when
+        ``None`` so the server applies its defaults.
+
+        Returns:
+            Created source JSON.
+        """
+        return self.create_source(
+            GitLabSource(
+                name=name,
+                groups=groups,
+                projects=projects,
+                auth_mode=auth_mode,
+                gitlab_url=gitlab_url,
+                access_token=access_token,
+                connection_id=connection_id,
+                ref_mode=ref_mode,
+                refs=refs,
+                excluded_refs=excluded_refs,
+                active_branch_days=active_branch_days,
+                include_merge_requests=include_merge_requests,
+                include_review_threads=include_review_threads,
+                include_direct_commits=include_direct_commits,
+                include_globs=include_globs,
+                exclude_globs=exclude_globs,
+                max_file_size_bytes=max_file_size_bytes,
+                sync_mode=sync_mode,
+                description=description,
+                metadata=metadata,
+                config_extra=config_extra,
+            )
+        )
+
     def create_file_upload(
         self,
         *,

{vectoramp-0.3.0 → vectoramp-0.4.0}/src/vectoramp/sources.py

@@ -8,7 +8,17 @@ from urllib.parse import urlparse
 
 from .types import JSON
 
-KnownSourceType = Literal["s3", "web", "gcs", "gdrive", "file_upload", "jira", "confluence"]
+KnownSourceType = Literal[
+    "s3",
+    "web",
+    "gcs",
+    "gdrive",
+    "file_upload",
+    "jira",
+    "confluence",
+    "github",
+    "gitlab",
+]
 
 
 @runtime_checkable
@@ -423,6 +433,188 @@ class ConfluenceSource:
         )
 
 
+@dataclass(frozen=True)
+class GitHubSource:
+    """GitHub ingestion source backed by the VectorAmp GitHub App.
+
+    Repositories, active branches, pull requests, and review discussions are
+    read through a GitHub App installation, so no token is passed to the SDK.
+    Install the VectorAmp GitHub App from the app's Sources page first; the
+    ``installation_id`` shown there is the value this builder needs.
+
+    Args:
+        name: Source name. Defaults to ``github-{first-repository}``.
+        installation_id: GitHub App installation id. Required, must be positive.
+        repositories: ``owner/repo`` full names to ingest. At least one required.
+        ref_mode: Branch selection strategy — ``"active"`` (default on the
+            server), ``"default"``, or ``"explicit"``.
+        refs: Explicit branch names, used with ``ref_mode="explicit"``.
+        excluded_refs: Branch names to skip.
+        active_branch_days: How recently a branch must have been pushed to count
+            as active (1–90). Server default is 7.
+        include_pull_requests: Ingest pull requests. Server default is true.
+        include_review_threads: Ingest review discussions. Server default is true.
+        include_direct_commits: Ingest commits pushed outside a pull request.
+            Server default is true.
+        include_globs: Path globs to include. Server default is ``["**/*"]``.
+        exclude_globs: Path globs to skip.
+        max_file_size_bytes: Per-file size ceiling (1–25_000_000). Server
+            default is 1_000_000.
+        sync_mode: Optional sync mode. Omitted from the request when ``None`` so
+            the server applies its default (``"incremental"``).
+        description: Optional source description.
+        metadata: Optional source metadata.
+        config_extra: Optional extra config fields merged into the request.
+    """
+
+    name: Optional[str] = None
+    installation_id: int = 0
+    repositories: Sequence[str] = ()
+    ref_mode: Optional[str] = None
+    refs: Optional[Sequence[str]] = None
+    excluded_refs: Optional[Sequence[str]] = None
+    active_branch_days: Optional[int] = None
+    include_pull_requests: Optional[bool] = None
+    include_review_threads: Optional[bool] = None
+    include_direct_commits: Optional[bool] = None
+    include_globs: Optional[Sequence[str]] = None
+    exclude_globs: Optional[Sequence[str]] = None
+    max_file_size_bytes: Optional[int] = None
+    sync_mode: Optional[str] = None
+    description: Optional[str] = None
+    metadata: Optional[Mapping[str, Any]] = None
+    config_extra: Optional[Mapping[str, Any]] = None
+
+    def to_create_request(self) -> JSON:
+        """Return source-create request fields for this GitHub source."""
+        if not self.installation_id or self.installation_id <= 0:
+            raise ValueError("GitHubSource requires a positive installation_id.")
+        repositories = list(self.repositories)
+        if not repositories:
+            raise ValueError("GitHubSource requires at least one repository.")
+        config: JSON = {
+            "installation_id": int(self.installation_id),
+            "repositories": repositories,
+        }
+        _set_optional(config, "ref_mode", self.ref_mode)
+        _set_optional_sequence(config, "refs", self.refs)
+        _set_optional_sequence(config, "excluded_refs", self.excluded_refs)
+        _set_optional(config, "active_branch_days", self.active_branch_days)
+        _set_optional(config, "include_pull_requests", self.include_pull_requests)
+        _set_optional(config, "include_review_threads", self.include_review_threads)
+        _set_optional(config, "include_direct_commits", self.include_direct_commits)
+        _set_optional_sequence(config, "include_globs", self.include_globs)
+        _set_optional_sequence(config, "exclude_globs", self.exclude_globs)
+        _set_optional(config, "max_file_size_bytes", self.max_file_size_bytes)
+        _set_optional(config, "sync_mode", self.sync_mode)
+        _merge_extra(config, self.config_extra)
+        return _source_body(
+            name=self.name or _default_source_name("github", repositories[0]),
+            source_type="github",
+            config=config,
+            description=self.description,
+            metadata=self.metadata,
+        )
+
+
+@dataclass(frozen=True)
+class GitLabSource:
+    """GitLab ingestion source for gitlab.com or a self-managed instance.
+
+    Projects, active branches, merge requests, and discussions are read with
+    either an access token (``auth_mode="token"`` plus ``access_token``) or a
+    stored OAuth connection (``connection_id``). At least one group or project
+    must be given.
+
+    Args:
+        name: Source name. Defaults to ``gitlab-{first-project-or-group}``.
+        groups: Group paths to ingest, e.g. ``["mygroup"]``. Required unless
+            ``projects`` is given.
+        projects: Project paths with namespace, e.g. ``["mygroup/myproject"]``.
+            Required unless ``groups`` is given.
+        auth_mode: ``"oauth"`` (default) or ``"token"``.
+        gitlab_url: Instance base URL. Defaults to ``"https://gitlab.com"``.
+        access_token: Personal or group access token for ``auth_mode="token"``.
+        connection_id: Id of a stored OAuth connection to authorize the source
+            with, used instead of an inline token.
+        ref_mode: Branch selection strategy — ``"active"`` (default on the
+            server), ``"default"``, or ``"explicit"``.
+        refs: Explicit branch names, used with ``ref_mode="explicit"``.
+        excluded_refs: Branch names to skip.
+        active_branch_days: How recently a branch must have been pushed to count
+            as active (1–90). Server default is 7.
+        include_merge_requests: Ingest merge requests. Server default is true.
+        include_review_threads: Ingest review discussions. Server default is true.
+        include_direct_commits: Ingest commits pushed outside a merge request.
+            Server default is true.
+        include_globs: Path globs to include. Server default is ``["**/*"]``.
+        exclude_globs: Path globs to skip.
+        max_file_size_bytes: Per-file size ceiling (1–25_000_000). Server
+            default is 1_000_000.
+        sync_mode: Optional sync mode. Omitted from the request when ``None`` so
+            the server applies its default (``"incremental"``).
+        description: Optional source description.
+        metadata: Optional source metadata.
+        config_extra: Optional extra config fields merged into the request.
+    """
+
+    name: Optional[str] = None
+    groups: Optional[Sequence[str]] = None
+    projects: Optional[Sequence[str]] = None
+    auth_mode: str = "oauth"
+    gitlab_url: str = "https://gitlab.com"
+    access_token: Optional[str] = None
+    connection_id: Optional[str] = None
+    ref_mode: Optional[str] = None
+    refs: Optional[Sequence[str]] = None
+    excluded_refs: Optional[Sequence[str]] = None
+    active_branch_days: Optional[int] = None
+    include_merge_requests: Optional[bool] = None
+    include_review_threads: Optional[bool] = None
+    include_direct_commits: Optional[bool] = None
+    include_globs: Optional[Sequence[str]] = None
+    exclude_globs: Optional[Sequence[str]] = None
+    max_file_size_bytes: Optional[int] = None
+    sync_mode: Optional[str] = None
+    description: Optional[str] = None
+    metadata: Optional[Mapping[str, Any]] = None
+    config_extra: Optional[Mapping[str, Any]] = None
+
+    def to_create_request(self) -> JSON:
+        """Return source-create request fields for this GitLab source."""
+        groups = list(self.groups or ())
+        projects = list(self.projects or ())
+        if not groups and not projects:
+            raise ValueError("GitLabSource requires at least one group or project.")
+        config: JSON = {"auth_mode": self.auth_mode, "gitlab_url": self.gitlab_url}
+        if groups:
+            config["groups"] = groups
+        if projects:
+            config["projects"] = projects
+        _set_optional(config, "access_token", self.access_token)
+        _set_optional(config, "connection_id", self.connection_id)
+        _set_optional(config, "ref_mode", self.ref_mode)
+        _set_optional_sequence(config, "refs", self.refs)
+        _set_optional_sequence(config, "excluded_refs", self.excluded_refs)
+        _set_optional(config, "active_branch_days", self.active_branch_days)
+        _set_optional(config, "include_merge_requests", self.include_merge_requests)
+        _set_optional(config, "include_review_threads", self.include_review_threads)
+        _set_optional(config, "include_direct_commits", self.include_direct_commits)
+        _set_optional_sequence(config, "include_globs", self.include_globs)
+        _set_optional_sequence(config, "exclude_globs", self.exclude_globs)
+        _set_optional(config, "max_file_size_bytes", self.max_file_size_bytes)
+        _set_optional(config, "sync_mode", self.sync_mode)
+        _merge_extra(config, self.config_extra)
+        hint = projects[0] if projects else groups[0]
+        return _source_body(
+            name=self.name or _default_source_name("gitlab", hint),
+            source_type="gitlab",
+            config=config,
+            description=self.description,
+            metadata=self.metadata,
+        )
+
+
 TypedSource = Union[
     GenericSource,
     WebSource,
@@ -432,6 +624,8 @@ TypedSource = Union[
     FileUploadSource,
     JiraSource,
     ConfluenceSource,
+    GitHubSource,
+    GitLabSource,
 ]
 SourceInput = Union[str, TypedSource]
 

{vectoramp-0.3.0 → vectoramp-0.4.0}/src/vectoramp/transport.py

@@ -157,7 +157,7 @@ class RestTransport(BaseTransport):
         return urljoin(self.base_url, path.lstrip("/"))
 
     def _headers(self, headers: Optional[Mapping[str, str]] = None) -> Dict[str, str]:
-        merged = {"X-API-Key": self.api_key, "User-Agent": "vectoramp-python/0.3.0"}
+        merged = {"X-API-Key": self.api_key, "User-Agent": "vectoramp-python/0.3.1"}
         if headers:
             merged.update(headers)
         return merged

{vectoramp-0.3.0 → vectoramp-0.4.0}/tests/test_client.py

@@ -251,10 +251,10 @@ def test_delete_vectors_payload_and_dataset_helper() -> None:
     assert calls == [
         (
             "DELETE",
-            "/api/v1/datasets/ds_1/vectors",
+            "/datasets/ds_1/vectors",
             {"ids": ["vec-a", 42], "write_concern": {"wait": True}},
         ),
-        ("DELETE", "/api/v1/datasets/ds_1/vectors", {"ids": ["vec-c"]}),
+        ("DELETE", "/datasets/ds_1/vectors", {"ids": ["vec-c"]}),
     ]
 
 

{vectoramp-0.3.0 → vectoramp-0.4.0}/tests/test_connections_and_sources.py

@@ -9,6 +9,8 @@ import pytest
 from vectoramp import (
     ConfluenceSource,
     GCSSource,
+    GitHubSource,
+    GitLabSource,
     GoogleDriveSource,
     JiraSource,
     VectorAmp,
@@ -307,3 +309,217 @@ def test_connect_requires_id() -> None:
     client = make_client(handler)
     with pytest.raises(ValueError):
         client.connections.connect("google_drive", poll_interval=0, timeout=5)
+
+
+# --------------------------------------------------------------------------- #
+# Source-control source builders (GitHub / GitLab)
+# --------------------------------------------------------------------------- #
+
+
+def test_github_source_builds_minimal_config() -> None:
+    body = GitHubSource(installation_id=42, repositories=["octo/hello-world"]).to_create_request()
+
+    assert body == {
+        "name": "github-octo-hello-world",
+        "source_type": "github",
+        "config": {"installation_id": 42, "repositories": ["octo/hello-world"]},
+    }
+
+
+def test_github_source_serializes_all_options() -> None:
+    body = GitHubSource(
+        name="Platform repos",
+        installation_id=7,
+        repositories=["acme/api", "acme/web"],
+        ref_mode="explicit",
+        refs=["main", "release"],
+        excluded_refs=["wip"],
+        active_branch_days=30,
+        include_pull_requests=False,
+        include_review_threads=False,
+        include_direct_commits=False,
+        include_globs=["docs/**"],
+        exclude_globs=["**/*.lock"],
+        max_file_size_bytes=2_000_000,
+        sync_mode="full",
+        description="Platform code",
+        metadata={"team": "platform"},
+        config_extra={"experimental": True},
+    ).to_create_request()
+
+    assert body == {
+        "name": "Platform repos",
+        "source_type": "github",
+        "config": {
+            "installation_id": 7,
+            "repositories": ["acme/api", "acme/web"],
+            "ref_mode": "explicit",
+            "refs": ["main", "release"],
+            "excluded_refs": ["wip"],
+            "active_branch_days": 30,
+            "include_pull_requests": False,
+            "include_review_threads": False,
+            "include_direct_commits": False,
+            "include_globs": ["docs/**"],
+            "exclude_globs": ["**/*.lock"],
+            "max_file_size_bytes": 2_000_000,
+            "sync_mode": "full",
+            "experimental": True,
+        },
+        "description": "Platform code",
+        "metadata": {"team": "platform"},
+    }
+
+
+@pytest.mark.parametrize(
+    "source",
+    [
+        GitHubSource(repositories=["octo/hello-world"]),
+        GitHubSource(installation_id=-1, repositories=["octo/hello-world"]),
+        GitHubSource(installation_id=42),
+    ],
+)
+def test_github_source_requires_installation_and_repositories(source: GitHubSource) -> None:
+    with pytest.raises(ValueError):
+        source.to_create_request()
+
+
+def test_gitlab_source_builds_minimal_config() -> None:
+    body = GitLabSource(projects=["mygroup/myproject"]).to_create_request()
+
+    assert body == {
+        "name": "gitlab-mygroup-myproject",
+        "source_type": "gitlab",
+        "config": {
+            "auth_mode": "oauth",
+            "gitlab_url": "https://gitlab.com",
+            "projects": ["mygroup/myproject"],
+        },
+    }
+
+
+def test_gitlab_source_names_from_group_when_no_project() -> None:
+    body = GitLabSource(groups=["mygroup"]).to_create_request()
+
+    assert body["name"] == "gitlab-mygroup"
+    assert body["config"]["groups"] == ["mygroup"]
+    assert "projects" not in body["config"]
+
+
+def test_gitlab_source_serializes_token_auth_and_options() -> None:
+    body = GitLabSource(
+        name="Self-managed",
+        groups=["platform"],
+        projects=["platform/api"],
+        auth_mode="token",
+        gitlab_url="https://gitlab.example.com",
+        access_token="glpat-secret",
+        ref_mode="active",
+        refs=["main"],
+        excluded_refs=["scratch"],
+        active_branch_days=14,
+        include_merge_requests=False,
+        include_review_threads=False,
+        include_direct_commits=False,
+        include_globs=["src/**"],
+        exclude_globs=["**/*.png"],
+        max_file_size_bytes=500_000,
+        sync_mode="full",
+    ).to_create_request()
+
+    assert body["config"] == {
+        "auth_mode": "token",
+        "gitlab_url": "https://gitlab.example.com",
+        "groups": ["platform"],
+        "projects": ["platform/api"],
+        "access_token": "glpat-secret",
+        "ref_mode": "active",
+        "refs": ["main"],
+        "excluded_refs": ["scratch"],
+        "active_branch_days": 14,
+        "include_merge_requests": False,
+        "include_review_threads": False,
+        "include_direct_commits": False,
+        "include_globs": ["src/**"],
+        "exclude_globs": ["**/*.png"],
+        "max_file_size_bytes": 500_000,
+        "sync_mode": "full",
+    }
+
+
+def test_gitlab_source_supports_connection_id() -> None:
+    config = GitLabSource(projects=["g/p"], connection_id="conn_gl").to_create_request()["config"]
+
+    assert config["connection_id"] == "conn_gl"
+    assert "access_token" not in config
+
+
+def test_gitlab_source_requires_group_or_project() -> None:
+    with pytest.raises(ValueError):
+        GitLabSource().to_create_request()
+
+
+def test_create_github_and_gitlab_post_to_sources() -> None:
+    calls = []
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        calls.append((request.url.path, json.loads(request.content)))
+        return json_response({"id": "src_new"}, status_code=201)
+
+    client = make_client(handler)
+
+    assert client.sources.create_github(
+        installation_id=42, repositories=["octo/hello-world"]
+    ) == {"id": "src_new"}
+    assert client.sources.create_gitlab(
+        projects=["mygroup/myproject"], auth_mode="token", access_token="glpat-secret"
+    ) == {"id": "src_new"}
+
+    assert calls[0] == (
+        "/ingestion/sources",
+        {
+            "name": "github-octo-hello-world",
+            "source_type": "github",
+            "config": {"installation_id": 42, "repositories": ["octo/hello-world"]},
+        },
+    )
+    assert calls[1] == (
+        "/ingestion/sources",
+        {
+            "name": "gitlab-mygroup-myproject",
+            "source_type": "gitlab",
+            "config": {
+                "auth_mode": "token",
+                "gitlab_url": "https://gitlab.com",
+                "projects": ["mygroup/myproject"],
+                "access_token": "glpat-secret",
+            },
+        },
+    )
+
+
+def test_validate_source_accepts_source_control_builders() -> None:
+    calls = []
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        calls.append(json.loads(request.content))
+        return json_response({"valid": True})
+
+    client = make_client(handler)
+
+    client.sources.validate_source(GitHubSource(installation_id=1, repositories=["o/r"]))
+    client.sources.validate_source(GitLabSource(groups=["g"]))
+
+    # Validation bodies carry source_type + config only (no name).
+    assert calls[0] == {
+        "source_type": "github",
+        "config": {"installation_id": 1, "repositories": ["o/r"]},
+    }
+    assert calls[1] == {
+        "source_type": "gitlab",
+        "config": {
+            "auth_mode": "oauth",
+            "gitlab_url": "https://gitlab.com",
+            "groups": ["g"],
+        },
+    }