gitlab-api 25.27.0__tar.gz → 25.32.0__tar.gz

{gitlab_api-25.27.0/gitlab_api.egg-info → gitlab_api-25.32.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitlab-api
-Version: 25.27.0
+Version: 25.32.0
 Summary: GitLab API + MCP Server + A2A Server
 Author-email: Audel Rouhi <knucklessg1@gmail.com>
 License: MIT
@@ -12,16 +12,17 @@ Classifier: Programming Language :: Python :: 3
 Requires-Python: <3.14,>=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: agent-utilities>=0.16.0
+Requires-Dist: agent-utilities>=0.26.0
 Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: gql>=4.0.0
 Provides-Extra: mcp
-Requires-Dist: agent-utilities[mcp]>=0.16.0; extra == "mcp"
+Requires-Dist: agent-utilities[mcp]>=0.26.0; extra == "mcp"
 Provides-Extra: agent
-Requires-Dist: agent-utilities[agent,logfire]>=0.16.0; extra == "agent"
+Requires-Dist: agent-utilities[agent,logfire]>=0.26.0; extra == "agent"
 Provides-Extra: gql
 Requires-Dist: gql>=4.0.0; extra == "gql"
 Provides-Extra: all
-Requires-Dist: gitlab-api[agent,gql,logfire,mcp]>=25.15.56; extra == "all"
+Requires-Dist: gitlab-api[agent,gql,logfire,mcp]>=25.32.0; extra == "all"
 Provides-Extra: test
 Requires-Dist: pytest-xdist>=3.6.0; extra == "test"
 Requires-Dist: pytest; extra == "test"
@@ -51,7 +52,7 @@ Dynamic: license-file
 ![PyPI - Wheel](https://img.shields.io/pypi/wheel/gitlab-api)
 ![PyPI - Implementation](https://img.shields.io/pypi/implementation/gitlab-api)
 
-*Version: 25.27.0*
+*Version: 25.32.0*
 
 ---
 
@@ -74,7 +75,7 @@ Dynamic: license-file
 
 This agent wraps the GitLab API + MCP Server + A2A Server API. You can interact with it programmatically or via its integrated execution entrypoints.
 
-Detailed instructions on how to use the underlying API wrappers, extended schema bindings, and developer SDK references are maintained in [docs/index.md](file:///home/apps/workspace/agent-packages/agents/gitlab-api/docs/index.md).
+Detailed instructions on how to use the underlying API wrappers, extended schema bindings, and developer SDK references are maintained in [docs/index.md](docs/index.md).
 
 ---
 
@@ -85,28 +86,55 @@ This server utilizes dynamic Action-Routed tools to optimize token overhead and
 ### Available MCP Tools
 | Tool Module | Toggle Env Var | Enabled by Default | Description & Nested Methods |
 |-------------|----------------|--------------------|------------------------------|
-| **Misc** | `MISCTOOL` | `True` | Manage misc operations. |
-| **Branches** | `BRANCHESTOOL` | `True` | Manage gitlab branches operations. Action-routed methods: `get`, `create`, `delete`. |
-| **Protected Branches** | `PROTECTED_BRANCHESTOOL` | `True` | Manage gitlab protected branches operations. Action-routed methods: `get`, `protect`, `unprotect`. |
-| **Commits** | `COMMITSTOOL` | `True` | Manage gitlab commits operations. Action-routed methods: `get`, `create`, `diff`, `revert`, `get_comments`, `create_comment`, `get_discussions`, `get_statuses`, `post_status`, `get_merge_requests`, `get_gpg_signature`. |
-| **Deploy Tokens** | `DEPLOY_TOKENSTOOL` | `True` | Manage gitlab deploy tokens operations. Action-routed methods: `get`, `get_project`, `create_project`, `delete_project`, `get_group`, `create_group`, `delete_group`. |
-| **Environments** | `ENVIRONMENTSTOOL` | `True` | Manage gitlab environments operations. Action-routed methods: `get`, `create`, `update`, `delete`, `stop`, `stop_stale`, `delete_stopped`, `get_protected`, `protect`, `update_protected`, `unprotect`. |
-| **Groups** | `GROUPSTOOL` | `True` | Manage gitlab groups operations. Action-routed methods: `get`, `edit`, `get_subgroups`, `get_descendants`, `get_projects`, `get_merge_requests`. |
-| **Jobs** | `JOBSTOOL` | `True` | Manage gitlab jobs operations. Action-routed methods: `get_project_jobs`, `get_log`, `cancel`, `retry`, `erase`, `run`, `get_pipeline_jobs`. |
-| **Members** | `MEMBERSTOOL` | `True` | Manage gitlab members operations. Action-routed methods: `get_group`, `get_project`. |
-| **Merge Requests** | `MERGE_REQUESTSTOOL` | `True` | Manage gitlab merge requests operations. Action-routed methods: `create`, `get`, `get_project`. |
-| **Merge Rules** | `MERGE_RULESTOOL` | `True` | Manage gitlab merge rules operations. Action-routed methods: `get_project_level`, `create_project_level`, `update_project_level`, `delete_project_level`, `get_mr_approvals`, `get_mr_approval_state`, `get_mr_level`, `approve_mr`, `unapprove_mr`, `get_group_level`, `edit_group_level`, `edit_project_level`. |
-| **Packages** | `PACKAGESTOOL` | `True` | Manage gitlab packages operations. Action-routed methods: `get`, `publish`, `download`. |
-| **Pipelines** | `PIPELINESTOOL` | `True` | Manage gitlab pipelines operations. Action-routed methods: `get`, `run`. |
-| **Pipeline Schedules** | `PIPELINE_SCHEDULESTOOL` | `True` | Manage gitlab pipeline schedules operations. Action-routed methods: `get_all`, `get`, `get_triggered`, `create`, `edit`, `take_ownership`, `delete`, `run`, `create_variable`, `delete_variable`. |
-| **Projects** | `PROJECTSTOOL` | `True` | Manage gitlab projects operations. Action-routed methods: `get`, `get_nested_by_group`, `get_contributors`, `get_statistics`, `edit`, `share_with_group`, `unshare_with_group`. |
-| **Releases** | `RELEASESTOOL` | `True` | Manage gitlab releases operations. Action-routed methods: `get`, `get_latest`, `get_latest_evidence`, `get_latest_asset`, `get_group_releases`, `download_asset`, `get_by_tag`, `create`, `create_evidence`, `update`, `delete`. |
-| **Runners** | `RUNNERSTOOL` | `True` | Manage gitlab runners operations. Action-routed methods: `get_all`, `update_details`, `pause`, `get_jobs`, `get_project`, `enable_project`, `delete_project`, `get_group`, `register`, `delete`, `verify_auth`, `reset_gitlab_token`, `reset_project_token`, `reset_group_token`, `reset_token`. |
-| **Tags** | `TAGSTOOL` | `True` | Manage gitlab tags operations. Action-routed methods: `get`, `create`, `delete`, `get_protected`, `get_protected_tag`, `protect`, `unprotect`. |
-| **Custom Api** | `CUSTOM_APITOOL` | `True` | Manage api request operations. |
-| **Graphql** | `GRAPHQLTOOL` | `True` | Execute raw GraphQL queries and mutations natively on GitLab. |
-
-Detailed tool schemas, parameter shapes, and validation constraints are preserved in [docs/mcp.md](file:///home/apps/workspace/agent-packages/agents/gitlab-api/docs/mcp.md).
+| **Misc** | `MISC_TOOL` | `True` | Manage gitlab api misc operations. |
+| **Branches** | `BRANCHES_TOOL` | `True` | Manage gitlab branches operations. Action-routed methods: `create`, `delete`, `get`. |
+| **Protected Branches** | `PROTECTED_BRANCHES_TOOL` | `True` | Manage gitlab protected branches operations. Action-routed methods: `get`, `protect`, `unprotect`. |
+| **Commits** | `COMMITS_TOOL` | `True` | Manage gitlab commits operations. Action-routed methods: `create`, `create_comment`, `diff`, `get`, `get_comments`, `get_discussions`, `get_gpg_signature`, `get_merge_requests`, `get_statuses`, `post_status`, `revert`. |
+| **Deploy Tokens** | `DEPLOY_TOKENS_TOOL` | `True` | Manage gitlab deploy tokens operations. Action-routed methods: `create_group`, `create_project`, `delete_group`, `delete_project`, `get`, `get_group`, `get_project`. |
+| **Environments** | `ENVIRONMENTS_TOOL` | `True` | Manage gitlab environments operations. Action-routed methods: `create`, `delete`, `delete_stopped`, `get`, `get_protected`, `protect`, `stop`, `stop_stale`, `unprotect`, `update`, `update_protected`. |
+| **Groups** | `GROUPS_TOOL` | `True` | Manage gitlab groups operations. Action-routed methods: `edit`, `get`, `get_descendants`, `get_merge_requests`, `get_projects`, `get_subgroups`. |
+| **Jobs** | `JOBS_TOOL` | `True` | Manage gitlab jobs operations. Action-routed methods: `cancel`, `erase`, `get_log`, `get_pipeline_jobs`, `get_project_jobs`, `retry`, `run`. |
+| **Members** | `MEMBERS_TOOL` | `True` | Manage gitlab members operations. Action-routed methods: `get_group`, `get_project`. |
+| **Merge Requests** | `MERGE_REQUESTS_TOOL` | `True` | Manage gitlab merge requests operations. Action-routed methods: `create`, `get`, `get_project`. |
+| **Merge Rules** | `MERGE_RULES_TOOL` | `True` | Manage gitlab merge rules operations. Action-routed methods: `approve_mr`, `create_project_level`, `delete_project_level`, `edit_group_level`, `edit_project_level`, `get_group_level`, `get_mr_approval_state`, `get_mr_approvals`, `get_mr_level`, `get_project_level`, `unapprove_mr`, `update_project_level`. |
+| **Packages** | `PACKAGES_TOOL` | `True` | Manage gitlab packages operations. Action-routed methods: `download`, `get`, `publish`. |
+| **Pipelines** | `PIPELINES_TOOL` | `True` | Manage gitlab pipelines operations. Action-routed methods: `get`, `run`. |
+| **Pipeline Schedules** | `PIPELINE_SCHEDULES_TOOL` | `True` | Manage gitlab pipeline schedules operations. Action-routed methods: `create`, `create_variable`, `delete`, `delete_variable`, `edit`, `get`, `get_all`, `get_triggered`, `run`, `take_ownership`. |
+| **Projects** | `PROJECTS_TOOL` | `True` | Manage gitlab projects operations. Action-routed methods: `edit`, `get`, `get_contributors`, `get_nested_by_group`, `get_statistics`, `share_with_group`, `unshare_with_group`. |
+| **Releases** | `RELEASES_TOOL` | `True` | Manage gitlab releases operations. Action-routed methods: `create`, `create_evidence`, `delete`, `download_asset`, `get`, `get_by_tag`, `get_group_releases`, `get_latest`, `get_latest_asset`, `get_latest_evidence`, `update`. |
+| **Runners** | `RUNNERS_TOOL` | `True` | Manage gitlab runners operations. Action-routed methods: `delete`, `delete_project`, `enable_project`, `get_all`, `get_group`, `get_jobs`, `get_project`, `pause`, `register`, `reset_gitlab_token`, `reset_group_token`, `reset_project_token`, `reset_token`, `update_details`, `verify_auth`. |
+| **Tags** | `TAGS_TOOL` | `True` | Manage gitlab tags operations. Action-routed methods: `create`, `delete`, `get`, `get_protected`, `get_protected_tag`, `protect`, `unprotect`. |
+| **Labels** | `LABELS_TOOL` | `True` | Manage GitLab labels. Action-routed methods: `create`, `delete`, `get`, `update`. |
+| **Milestones** | `MILESTONES_TOOL` | `True` | Manage GitLab milestones. Action-routed methods: `create`, `delete`, `get`, `update`. |
+| **Snippets** | `SNIPPETS_TOOL` | `True` | Manage GitLab snippets. Action-routed methods: `create`, `delete`, `get`, `update`. |
+| **Notes** | `NOTES_TOOL` | `True` | Manage GitLab notes/comments on issues, merge requests, commits, and epics. Action-routed methods: `create`, `delete`, `get`, `update`. |
+| **Epics** | `EPICS_TOOL` | `True` | Manage GitLab epics. Action-routed methods: `create`, `delete`, `get`, `update`. |
+| **Issues** | `ISSUES_TOOL` | `True` | Manage GitLab issues. Action-routed methods: `create`, `delete`, `get`, `update`. |
+| **Custom Api** | `CUSTOM_API_TOOL` | `True` | Execute arbitrary GitLab REST API requests directly. |
+| **Graphql** | `GRAPHQL_TOOL` | `True` | Execute raw GraphQL queries and mutations natively on GitLab. |
+
+Detailed tool schemas, parameter shapes, and validation constraints are preserved in [docs/mcp.md](docs/mcp.md).
+
+### Dynamic Tool Selection & Visibility
+
+This MCP server supports dynamic toolset selection and visibility filtering at runtime. This allows you to restrict the set of exposed tools in order to prevent blowing up the LLM's context window.
+
+You can configure tool filtering via multiple input channels:
+
+- **CLI Arguments:** Pass `--tools` or `--toolsets` (or their disabled counterparts `--disabled-tools` and `--disabled-toolsets`) during startup.
+- **Environment Variables:** Define standard environment variables:
+  - `MCP_ENABLED_TOOLS` / `MCP_DISABLED_TOOLS`
+  - `MCP_ENABLED_TAGS` / `MCP_DISABLED_TAGS`
+- **HTTP SSE Request Headers:** Pass custom headers during transport initialization:
+  - `x-mcp-enabled-tools` / `x-mcp-disabled-tools`
+  - `x-mcp-enabled-tags` / `x-mcp-disabled-tags`
+- **HTTP SSE Request Query Parameters:** Append query parameters directly to your transport connection URL:
+  - `?tools=tool1,tool2`
+  - `?tags=tag1`
+
+When query strings or parameters are supplied, an LLM-free **Knowledge Graph resolution layer** (using `DynamicToolOrchestrator`) matches query intents against known tool tags, names, or descriptions, with safe fallback and automated 24-hour background cache refreshing.
+
+---
 
 ### MCP Configuration Examples
 
@@ -268,7 +296,7 @@ services:
 
 ```
 
-Detailed graph node architecture explanations, custom skill configurations, and agentic trace guides are available in [docs/agent.md](file:///home/apps/workspace/agent-packages/agents/gitlab-api/docs/agent.md).
+Detailed graph node architecture explanations, custom skill configurations, and agentic trace guides are available in [docs/agent.md](docs/agent.md).
 
 ---
 

{gitlab_api-25.27.0 → gitlab_api-25.32.0}/README.md

@@ -20,7 +20,7 @@
 ![PyPI - Wheel](https://img.shields.io/pypi/wheel/gitlab-api)
 ![PyPI - Implementation](https://img.shields.io/pypi/implementation/gitlab-api)
 
-*Version: 25.27.0*
+*Version: 25.32.0*
 
 ---
 
@@ -43,7 +43,7 @@
 
 This agent wraps the GitLab API + MCP Server + A2A Server API. You can interact with it programmatically or via its integrated execution entrypoints.
 
-Detailed instructions on how to use the underlying API wrappers, extended schema bindings, and developer SDK references are maintained in [docs/index.md](file:///home/apps/workspace/agent-packages/agents/gitlab-api/docs/index.md).
+Detailed instructions on how to use the underlying API wrappers, extended schema bindings, and developer SDK references are maintained in [docs/index.md](docs/index.md).
 
 ---
 
@@ -54,28 +54,55 @@ This server utilizes dynamic Action-Routed tools to optimize token overhead and
 ### Available MCP Tools
 | Tool Module | Toggle Env Var | Enabled by Default | Description & Nested Methods |
 |-------------|----------------|--------------------|------------------------------|
-| **Misc** | `MISCTOOL` | `True` | Manage misc operations. |
-| **Branches** | `BRANCHESTOOL` | `True` | Manage gitlab branches operations. Action-routed methods: `get`, `create`, `delete`. |
-| **Protected Branches** | `PROTECTED_BRANCHESTOOL` | `True` | Manage gitlab protected branches operations. Action-routed methods: `get`, `protect`, `unprotect`. |
-| **Commits** | `COMMITSTOOL` | `True` | Manage gitlab commits operations. Action-routed methods: `get`, `create`, `diff`, `revert`, `get_comments`, `create_comment`, `get_discussions`, `get_statuses`, `post_status`, `get_merge_requests`, `get_gpg_signature`. |
-| **Deploy Tokens** | `DEPLOY_TOKENSTOOL` | `True` | Manage gitlab deploy tokens operations. Action-routed methods: `get`, `get_project`, `create_project`, `delete_project`, `get_group`, `create_group`, `delete_group`. |
-| **Environments** | `ENVIRONMENTSTOOL` | `True` | Manage gitlab environments operations. Action-routed methods: `get`, `create`, `update`, `delete`, `stop`, `stop_stale`, `delete_stopped`, `get_protected`, `protect`, `update_protected`, `unprotect`. |
-| **Groups** | `GROUPSTOOL` | `True` | Manage gitlab groups operations. Action-routed methods: `get`, `edit`, `get_subgroups`, `get_descendants`, `get_projects`, `get_merge_requests`. |
-| **Jobs** | `JOBSTOOL` | `True` | Manage gitlab jobs operations. Action-routed methods: `get_project_jobs`, `get_log`, `cancel`, `retry`, `erase`, `run`, `get_pipeline_jobs`. |
-| **Members** | `MEMBERSTOOL` | `True` | Manage gitlab members operations. Action-routed methods: `get_group`, `get_project`. |
-| **Merge Requests** | `MERGE_REQUESTSTOOL` | `True` | Manage gitlab merge requests operations. Action-routed methods: `create`, `get`, `get_project`. |
-| **Merge Rules** | `MERGE_RULESTOOL` | `True` | Manage gitlab merge rules operations. Action-routed methods: `get_project_level`, `create_project_level`, `update_project_level`, `delete_project_level`, `get_mr_approvals`, `get_mr_approval_state`, `get_mr_level`, `approve_mr`, `unapprove_mr`, `get_group_level`, `edit_group_level`, `edit_project_level`. |
-| **Packages** | `PACKAGESTOOL` | `True` | Manage gitlab packages operations. Action-routed methods: `get`, `publish`, `download`. |
-| **Pipelines** | `PIPELINESTOOL` | `True` | Manage gitlab pipelines operations. Action-routed methods: `get`, `run`. |
-| **Pipeline Schedules** | `PIPELINE_SCHEDULESTOOL` | `True` | Manage gitlab pipeline schedules operations. Action-routed methods: `get_all`, `get`, `get_triggered`, `create`, `edit`, `take_ownership`, `delete`, `run`, `create_variable`, `delete_variable`. |
-| **Projects** | `PROJECTSTOOL` | `True` | Manage gitlab projects operations. Action-routed methods: `get`, `get_nested_by_group`, `get_contributors`, `get_statistics`, `edit`, `share_with_group`, `unshare_with_group`. |
-| **Releases** | `RELEASESTOOL` | `True` | Manage gitlab releases operations. Action-routed methods: `get`, `get_latest`, `get_latest_evidence`, `get_latest_asset`, `get_group_releases`, `download_asset`, `get_by_tag`, `create`, `create_evidence`, `update`, `delete`. |
-| **Runners** | `RUNNERSTOOL` | `True` | Manage gitlab runners operations. Action-routed methods: `get_all`, `update_details`, `pause`, `get_jobs`, `get_project`, `enable_project`, `delete_project`, `get_group`, `register`, `delete`, `verify_auth`, `reset_gitlab_token`, `reset_project_token`, `reset_group_token`, `reset_token`. |
-| **Tags** | `TAGSTOOL` | `True` | Manage gitlab tags operations. Action-routed methods: `get`, `create`, `delete`, `get_protected`, `get_protected_tag`, `protect`, `unprotect`. |
-| **Custom Api** | `CUSTOM_APITOOL` | `True` | Manage api request operations. |
-| **Graphql** | `GRAPHQLTOOL` | `True` | Execute raw GraphQL queries and mutations natively on GitLab. |
-
-Detailed tool schemas, parameter shapes, and validation constraints are preserved in [docs/mcp.md](file:///home/apps/workspace/agent-packages/agents/gitlab-api/docs/mcp.md).
+| **Misc** | `MISC_TOOL` | `True` | Manage gitlab api misc operations. |
+| **Branches** | `BRANCHES_TOOL` | `True` | Manage gitlab branches operations. Action-routed methods: `create`, `delete`, `get`. |
+| **Protected Branches** | `PROTECTED_BRANCHES_TOOL` | `True` | Manage gitlab protected branches operations. Action-routed methods: `get`, `protect`, `unprotect`. |
+| **Commits** | `COMMITS_TOOL` | `True` | Manage gitlab commits operations. Action-routed methods: `create`, `create_comment`, `diff`, `get`, `get_comments`, `get_discussions`, `get_gpg_signature`, `get_merge_requests`, `get_statuses`, `post_status`, `revert`. |
+| **Deploy Tokens** | `DEPLOY_TOKENS_TOOL` | `True` | Manage gitlab deploy tokens operations. Action-routed methods: `create_group`, `create_project`, `delete_group`, `delete_project`, `get`, `get_group`, `get_project`. |
+| **Environments** | `ENVIRONMENTS_TOOL` | `True` | Manage gitlab environments operations. Action-routed methods: `create`, `delete`, `delete_stopped`, `get`, `get_protected`, `protect`, `stop`, `stop_stale`, `unprotect`, `update`, `update_protected`. |
+| **Groups** | `GROUPS_TOOL` | `True` | Manage gitlab groups operations. Action-routed methods: `edit`, `get`, `get_descendants`, `get_merge_requests`, `get_projects`, `get_subgroups`. |
+| **Jobs** | `JOBS_TOOL` | `True` | Manage gitlab jobs operations. Action-routed methods: `cancel`, `erase`, `get_log`, `get_pipeline_jobs`, `get_project_jobs`, `retry`, `run`. |
+| **Members** | `MEMBERS_TOOL` | `True` | Manage gitlab members operations. Action-routed methods: `get_group`, `get_project`. |
+| **Merge Requests** | `MERGE_REQUESTS_TOOL` | `True` | Manage gitlab merge requests operations. Action-routed methods: `create`, `get`, `get_project`. |
+| **Merge Rules** | `MERGE_RULES_TOOL` | `True` | Manage gitlab merge rules operations. Action-routed methods: `approve_mr`, `create_project_level`, `delete_project_level`, `edit_group_level`, `edit_project_level`, `get_group_level`, `get_mr_approval_state`, `get_mr_approvals`, `get_mr_level`, `get_project_level`, `unapprove_mr`, `update_project_level`. |
+| **Packages** | `PACKAGES_TOOL` | `True` | Manage gitlab packages operations. Action-routed methods: `download`, `get`, `publish`. |
+| **Pipelines** | `PIPELINES_TOOL` | `True` | Manage gitlab pipelines operations. Action-routed methods: `get`, `run`. |
+| **Pipeline Schedules** | `PIPELINE_SCHEDULES_TOOL` | `True` | Manage gitlab pipeline schedules operations. Action-routed methods: `create`, `create_variable`, `delete`, `delete_variable`, `edit`, `get`, `get_all`, `get_triggered`, `run`, `take_ownership`. |
+| **Projects** | `PROJECTS_TOOL` | `True` | Manage gitlab projects operations. Action-routed methods: `edit`, `get`, `get_contributors`, `get_nested_by_group`, `get_statistics`, `share_with_group`, `unshare_with_group`. |
+| **Releases** | `RELEASES_TOOL` | `True` | Manage gitlab releases operations. Action-routed methods: `create`, `create_evidence`, `delete`, `download_asset`, `get`, `get_by_tag`, `get_group_releases`, `get_latest`, `get_latest_asset`, `get_latest_evidence`, `update`. |
+| **Runners** | `RUNNERS_TOOL` | `True` | Manage gitlab runners operations. Action-routed methods: `delete`, `delete_project`, `enable_project`, `get_all`, `get_group`, `get_jobs`, `get_project`, `pause`, `register`, `reset_gitlab_token`, `reset_group_token`, `reset_project_token`, `reset_token`, `update_details`, `verify_auth`. |
+| **Tags** | `TAGS_TOOL` | `True` | Manage gitlab tags operations. Action-routed methods: `create`, `delete`, `get`, `get_protected`, `get_protected_tag`, `protect`, `unprotect`. |
+| **Labels** | `LABELS_TOOL` | `True` | Manage GitLab labels. Action-routed methods: `create`, `delete`, `get`, `update`. |
+| **Milestones** | `MILESTONES_TOOL` | `True` | Manage GitLab milestones. Action-routed methods: `create`, `delete`, `get`, `update`. |
+| **Snippets** | `SNIPPETS_TOOL` | `True` | Manage GitLab snippets. Action-routed methods: `create`, `delete`, `get`, `update`. |
+| **Notes** | `NOTES_TOOL` | `True` | Manage GitLab notes/comments on issues, merge requests, commits, and epics. Action-routed methods: `create`, `delete`, `get`, `update`. |
+| **Epics** | `EPICS_TOOL` | `True` | Manage GitLab epics. Action-routed methods: `create`, `delete`, `get`, `update`. |
+| **Issues** | `ISSUES_TOOL` | `True` | Manage GitLab issues. Action-routed methods: `create`, `delete`, `get`, `update`. |
+| **Custom Api** | `CUSTOM_API_TOOL` | `True` | Execute arbitrary GitLab REST API requests directly. |
+| **Graphql** | `GRAPHQL_TOOL` | `True` | Execute raw GraphQL queries and mutations natively on GitLab. |
+
+Detailed tool schemas, parameter shapes, and validation constraints are preserved in [docs/mcp.md](docs/mcp.md).
+
+### Dynamic Tool Selection & Visibility
+
+This MCP server supports dynamic toolset selection and visibility filtering at runtime. This allows you to restrict the set of exposed tools in order to prevent blowing up the LLM's context window.
+
+You can configure tool filtering via multiple input channels:
+
+- **CLI Arguments:** Pass `--tools` or `--toolsets` (or their disabled counterparts `--disabled-tools` and `--disabled-toolsets`) during startup.
+- **Environment Variables:** Define standard environment variables:
+  - `MCP_ENABLED_TOOLS` / `MCP_DISABLED_TOOLS`
+  - `MCP_ENABLED_TAGS` / `MCP_DISABLED_TAGS`
+- **HTTP SSE Request Headers:** Pass custom headers during transport initialization:
+  - `x-mcp-enabled-tools` / `x-mcp-disabled-tools`
+  - `x-mcp-enabled-tags` / `x-mcp-disabled-tags`
+- **HTTP SSE Request Query Parameters:** Append query parameters directly to your transport connection URL:
+  - `?tools=tool1,tool2`
+  - `?tags=tag1`
+
+When query strings or parameters are supplied, an LLM-free **Knowledge Graph resolution layer** (using `DynamicToolOrchestrator`) matches query intents against known tool tags, names, or descriptions, with safe fallback and automated 24-hour background cache refreshing.
+
+---
 
 ### MCP Configuration Examples
 
@@ -237,7 +264,7 @@ services:
 
 ```
 
-Detailed graph node architecture explanations, custom skill configurations, and agentic trace guides are available in [docs/agent.md](file:///home/apps/workspace/agent-packages/agents/gitlab-api/docs/agent.md).
+Detailed graph node architecture explanations, custom skill configurations, and agentic trace guides are available in [docs/agent.md](docs/agent.md).
 
 ---
 

{gitlab_api-25.27.0 → gitlab_api-25.32.0}/gitlab_api/agent_server.py

@@ -4,7 +4,7 @@ import os
 import sys
 import warnings
 
-__version__ = "25.27.0"
+__version__ = "25.32.0"
 
 logging.basicConfig(
     level=logging.INFO,

gitlab_api-25.32.0/gitlab_api/api/__init__.py

@@ -0,0 +1 @@
+# GitLab Agent API Package

gitlab_api-25.32.0/gitlab_api/api/api_client_base.py

@@ -0,0 +1,214 @@
+#!/usr/bin/python
+
+import logging
+from base64 import b64encode
+from typing import Any, TypeVar
+
+import requests
+import urllib3
+from agent_utilities.base_utilities import get_logger
+
+logger = get_logger(__name__)
+
+from agent_utilities.core.exceptions import (
+    AuthError,
+    MissingParameterError,
+    ParameterError,
+    UnauthorizedError,
+)
+
+T = TypeVar("T")
+
+
+class GitLabApiBase:
+    def __init__(
+        self,
+        url: str | None = None,
+        username: str | None = None,
+        password: str | None = None,
+        token: str | None = None,
+        tokens: list | None = None,
+        proxies: dict | None = None,
+        verify: bool = True,
+        debug: bool = False,
+    ):
+        if debug:
+            logger.setLevel(logging.DEBUG)
+            logger.debug("Debug mode enabled")
+        else:
+            logger.setLevel(logging.ERROR)
+        if url is None:
+            raise MissingParameterError
+
+        self._session = requests.Session()
+        self.url = url.rstrip("/")
+        forbidden = ["/api/v4", "/api/v4/"]
+        for end in forbidden:
+            if url.endswith(end):
+                self.url = url[: -len(end)]
+        self.url = self.url + "/api/v4"
+        self.headers = None
+        self.headers_parallel = None
+        self.verify = verify
+        self.proxies = proxies
+        self.debug = debug
+        self._current_header_index = 0
+
+        if self.verify is False:
+            urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)
+
+        if token:
+            self.headers = {
+                "Authorization": f"Bearer {token}",
+                "Content-Type": "application/json",
+            }
+        elif tokens:
+            self.headers_parallel = []
+            for token in tokens:
+                self.headers_parallel.append(
+                    {
+                        "Authorization": f"Bearer {token}",
+                        "Content-Type": "application/json",
+                    }
+                )
+            self.headers = self.headers_parallel[self._current_header_index]
+        elif username and password:
+            user_pass = f"{username}:{password}".encode()
+            user_pass_encoded = b64encode(user_pass).decode()
+            self.headers = {
+                "Authorization": f"Basic {user_pass_encoded}",
+                "Content-Type": "application/json",
+            }
+        else:
+            raise MissingParameterError
+
+        headers_to_check = (
+            self.headers_parallel if self.headers_parallel else [self.headers]
+        )
+        for header in headers_to_check:
+            response = self._session.get(
+                url=f"{self.url}/projects",
+                headers=header,
+                verify=self.verify,
+                proxies=self.proxies,
+                timeout=10,
+            )
+            if response.status_code in (401, 403):
+                logger.error(f"Authentication Error with header: {response.content}")  # type: ignore
+                raise AuthError if response.status_code == 401 else UnauthorizedError
+            elif response.status_code == 404:
+                logger.error(f"Parameter Error: {response.content}")  # type: ignore
+                raise ParameterError
+
+    def switch_to_next_headers(self) -> bool:
+        """
+        Switches self.headers to the next set of headers in self.headers_parallel.
+
+        Returns:
+        - bool: True if headers were switched, False if no switch occurred (e.g., no parallel headers).
+        """
+        if not self.headers_parallel or len(self.headers_parallel) <= 1:
+            logging.debug("No parallel headers available to switch to.")
+            return False
+
+        self._current_header_index = (self._current_header_index + 1) % len(
+            self.headers_parallel
+        )
+        self.headers = self.headers_parallel[self._current_header_index]
+        logging.debug(f"Switched to headers at index {self._current_header_index}")
+        return True
+
+    def _fetch_next_page(
+        self, endpoint: str, model: T, header: dict, page: int
+    ) -> list[dict]:
+        """Fetch a single page of data from the specified endpoint"""
+        import copy
+
+        local_model = copy.copy(model)
+        local_model.page = page  # type: ignore
+        local_model.model_post_init(local_model)  # type: ignore
+        response = self._session.get(
+            url=f"{self.url}{endpoint}",
+            params=local_model.api_parameters,  # type: ignore
+            headers=header,
+            verify=self.verify,
+            proxies=self.proxies,
+        )
+        page_data = response.json()
+        return page_data if isinstance(page_data, list) else []
+
+    def _fetch_all_pages(
+        self,
+        endpoint: str,
+        model: T,
+        id_field: str | None = None,
+        id_value: Any | None = None,
+    ) -> tuple[requests.Response, list[dict]]:
+        """Generic method to fetch all pages with parallelization"""
+        from concurrent.futures import ThreadPoolExecutor, as_completed
+
+        if id_field and getattr(model, id_field) is None:
+            raise MissingParameterError
+        all_data = []
+        headers_to_use = (
+            self.headers_parallel if self.headers_parallel else [self.headers]
+        )
+
+        initial_endpoint = (
+            endpoint.format(id=id_value) if "{id}" in endpoint else endpoint
+        )
+        total_pages_response = self._session.get(
+            url=f"{self.url}{initial_endpoint}",
+            params=model.api_parameters,  # type: ignore
+            headers=headers_to_use[0],
+            verify=self.verify,
+            proxies=self.proxies,
+        )
+        total_pages = int(total_pages_response.headers.get("X-Total-Pages", 1))
+        try:
+            initial_data = total_pages_response.json()
+        except Exception:
+            logging.error(f"Failed to decode JSON from {self.url}{initial_endpoint}")
+            logging.error(f"Status Code: {total_pages_response.status_code}")
+            logging.error(f"Response Content: {total_pages_response.text}")
+            raise
+        if isinstance(initial_data, list):
+            all_data.extend(initial_data)
+
+        # Fetch all pages by default (max up to 10 pages) if max_pages is None, 0, or not set
+        if (
+            not hasattr(model, "max_pages")
+            or model.max_pages is None
+            or model.max_pages == 0
+        ):  # type: ignore
+            model.max_pages = min(total_pages, 10)  # type: ignore
+        elif model.max_pages > total_pages:  # type: ignore
+            model.max_pages = total_pages  # type: ignore
+
+        if model.max_pages > 1:  # type: ignore
+            with ThreadPoolExecutor(max_workers=len(headers_to_use)) as executor:
+                future_to_page = {}
+                header_idx = 0
+
+                for page in range(2, model.max_pages + 1):  # type: ignore
+                    header = headers_to_use[header_idx % len(headers_to_use)]
+                    future = executor.submit(
+                        self._fetch_next_page,  # type: ignore[arg-type]
+                        initial_endpoint,
+                        model,
+                        header,
+                        page,
+                    )
+                    future_to_page[future] = page
+                    header_idx += 1
+
+                for future in as_completed(future_to_page):
+                    try:
+                        page_data = future.result()
+                        all_data.extend(page_data)
+                    except Exception as e:
+                        logging.error(
+                            f"Error fetching page {future_to_page[future]}: {str(e)}"
+                        )
+
+        return total_pages_response, all_data