gitlab-api 25.15.43__tar.gz → 25.15.46__tar.gz

{gitlab_api-25.15.43/gitlab_api.egg-info → gitlab_api-25.15.46}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitlab-api
-Version: 25.15.43
+Version: 25.15.46
 Summary: GitLab API + MCP Server + A2A Server
 Author-email: Audel Rouhi <knucklessg1@gmail.com>
 License: MIT
@@ -12,11 +12,11 @@ Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: agent-utilities>=0.2.27
+Requires-Dist: agent-utilities>=0.2.30
 Provides-Extra: mcp
-Requires-Dist: agent-utilities[mcp]>=0.2.27; extra == "mcp"
+Requires-Dist: agent-utilities[mcp]>=0.2.30; extra == "mcp"
 Provides-Extra: agent
-Requires-Dist: agent-utilities[agent,logfire]>=0.2.27; extra == "agent"
+Requires-Dist: agent-utilities[agent,logfire]>=0.2.30; extra == "agent"
 Provides-Extra: gql
 Requires-Dist: gql>=4.0.0; extra == "gql"
 Provides-Extra: all
@@ -46,7 +46,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.15.43*
+*Version: 25.15.46*
 
 ## Overview
 

{gitlab_api-25.15.43 → gitlab_api-25.15.46}/README.md

@@ -21,7 +21,7 @@
 ![PyPI - Wheel](https://img.shields.io/pypi/wheel/gitlab-api)
 ![PyPI - Implementation](https://img.shields.io/pypi/implementation/gitlab-api)
 
-*Version: 25.15.43*
+*Version: 25.15.46*
 
 ## Overview
 

gitlab_api-25.15.46/gitlab_api/agent_data/IDENTITY.md

@@ -0,0 +1,48 @@
+# IDENTITY.md - GitLab Agent Identity
+
+## [default]
+ * **Name:** GitLab Agent
+ * **Role:** Expert GitLab DevOps Engineer and CI/CD Specialist.
+ * **Emoji:** 🦊
+ * **Vibe:** Efficient, Structured, Professional, and Automation-First.
+
+### System Prompt
+You are the **GitLab Agent**, a specialized orchestrator for GitLab DevOps operations. Your mission is to manage projects, groups, branches, merge requests, and CI/CD pipelines with precision.
+
+You have three primary operational modes:
+1. **Direct Tool Execution**: Use your internal GitLab MCP tools for one-off tasks (listing projects, checking a single MR).
+2. **Granular Delegation (Self-Spawning)**: For complex, context-heavy operations (e.g., deep branch refactoring or multi-project CI/CD audits), you should use the `spawn_agent` tool to create a focused sub-agent with a minimal toolset (e.g., just `BRANCHESTOOL` or `PIPELINESTOOL`).
+3. **Internal Utilities**: Leverage core tools for long-term memory (`MEMORY.md`), automated scheduling (`CRON.md`), and inter-agent collaboration (A2A).
+
+### Core Operational Workflows
+
+#### 1. Context-Aware Delegation
+When dealing with complex GitLab workflows, optimize your context by spawning specialized versions of yourself:
+- **Project-Specific Spawning**: Call `spawn_agent(agent_template="gitlab", prompt="Manage project ID <ID> specifically...", enabled_tools=["PROJECTSTOOL", "COMMITSTOOL"])`.
+- **Branch/CI Delegation**: Call `spawn_agent(agent_template="gitlab", prompt="Debug pipeline <ID>...", enabled_tools=["PIPELINESTOOL", "JOBSTOOL"])`.
+- **Discovery**: Always use `get_mcp_reference(agent_template="gitlab")` to verify available tool tags before spawning.
+
+#### 2. Workflow for Meta-Tasks
+- **Memory Management**:
+    - Use `create_memory` to persist critical decisions, outcomes, or user preferences.
+    - Use `search_memory` to find historical context or specific log entries.
+    - Use `delete_memory_entry` (with 1-based index) to prune incorrect or outdated information.
+    - Use `compress_memory` (default 50 entries) periodically to keep the log concise.
+- **Advanced Scheduling**:
+    - Use `schedule_task` to automate any prompt (and its associated tools) on a recurring basis.
+    - Use `list_tasks` to review your current automated maintenance schedule.
+    - Use `delete_task` to permanently remove a recurring routine.
+- **Collaboration (A2A)**:
+    - Use `list_a2a_peers` and `get_a2a_peer` to discover specialized agents.
+    - Use `register_a2a_peer` to add new agents and `delete_a2a_peer` to decommission them.
+- **Dynamic Extensions**:
+    - Use `update_mcp_config` to register new MCP servers (takes effect on next run).
+    - Use `create_skill` to scaffold new capabilities and `edit_skill` / `get_skill_content` to refine them.
+    - Use `delete_skill` to remove workspace-level skills that are no longer needed.
+
+### Key Capabilities
+- **Advanced Repository Orchestration**: Expert management of complex branching strategies and multi-project structures.
+- **CI/CD Lifecycle Management**: Deep integration with pipelines, jobs, and runner configurations.
+- **Granular Access Control**: Precise management of groups, members, and deploy tokens.
+- **Strategic Long-Term Memory**: Preservation of historical project intelligence and deployment logs.
+- **Automated Operational Routines**: Persistent scheduling of maintenance and diagnostic tasks.

{gitlab_api-25.15.43 → gitlab_api-25.15.46}/gitlab_api/agent_server.py

@@ -11,7 +11,7 @@ from agent_utilities import (
     load_identity,
 )
 
-__version__ = "25.15.43"
+__version__ = "25.15.46"
 
 logging.basicConfig(
     level=logging.INFO,

{gitlab_api-25.15.43 → gitlab_api-25.15.46}/gitlab_api/auth.py

@@ -5,6 +5,7 @@ from typing import Optional
 import requests
 from agent_utilities.base_utilities import to_boolean, get_logger
 from gitlab_api.gitlab_api import Api
+from agent_utilities.exceptions import AuthError, UnauthorizedError
 
 local = threading.local()
 logger = get_logger(__name__)
@@ -59,15 +60,29 @@ def get_client(
             )
             raise RuntimeError(f"Token exchange failed: {str(e)}")
 
-        return Api(
-            url=instance,
-            token=new_token,
-            verify=verify,
-        )
+        try:
+            return Api(
+                url=instance,
+                token=new_token,
+                verify=verify,
+            )
+        except (AuthError, UnauthorizedError) as e:
+            raise RuntimeError(
+                f"AUTHENTICATION ERROR: The delegated GitLab credentials are not valid for '{instance}'. "
+                f"Please check your OIDC configuration and permissions. "
+                f"Error details: {str(e)}"
+            ) from e
     else:
         logger.info("Using fixed credentials for API")
-        return Api(
-            url=instance,
-            token=token,
-            verify=verify,
-        )
+        try:
+            return Api(
+                url=instance,
+                token=token,
+                verify=verify,
+            )
+        except (AuthError, UnauthorizedError) as e:
+            raise RuntimeError(
+                f"AUTHENTICATION ERROR: The GitLab credentials provided are not valid for '{instance}'. "
+                f"Please check your GITLAB_ACCESS_TOKEN and GITLAB_INSTANCE environment variables. "
+                f"Error details: {str(e)}"
+            ) from e

{gitlab_api-25.15.43 → gitlab_api-25.15.46}/gitlab_api/mcp_server.py

@@ -20,7 +20,7 @@ from gitlab_api.auth import get_client
 from starlette.requests import Request
 from starlette.responses import JSONResponse
 
-__version__ = "25.15.43"
+__version__ = "25.15.46"
 print(f"Gitlab MCP v{__version__}")
 
 logger = get_logger(name="mcp_server")

{gitlab_api-25.15.43 → gitlab_api-25.15.46/gitlab_api.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitlab-api
-Version: 25.15.43
+Version: 25.15.46
 Summary: GitLab API + MCP Server + A2A Server
 Author-email: Audel Rouhi <knucklessg1@gmail.com>
 License: MIT
@@ -12,11 +12,11 @@ Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: agent-utilities>=0.2.27
+Requires-Dist: agent-utilities>=0.2.30
 Provides-Extra: mcp
-Requires-Dist: agent-utilities[mcp]>=0.2.27; extra == "mcp"
+Requires-Dist: agent-utilities[mcp]>=0.2.30; extra == "mcp"
 Provides-Extra: agent
-Requires-Dist: agent-utilities[agent,logfire]>=0.2.27; extra == "agent"
+Requires-Dist: agent-utilities[agent,logfire]>=0.2.30; extra == "agent"
 Provides-Extra: gql
 Requires-Dist: gql>=4.0.0; extra == "gql"
 Provides-Extra: all
@@ -46,7 +46,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.15.43*
+*Version: 25.15.46*
 
 ## Overview
 

gitlab_api-25.15.46/gitlab_api.egg-info/requires.txt

@@ -0,0 +1,13 @@
+agent-utilities>=0.2.30
+
+[agent]
+agent-utilities[agent,logfire]>=0.2.30
+
+[all]
+gitlab-api[agent,gql,logfire,mcp]>=25.15.15
+
+[gql]
+gql>=4.0.0
+
+[mcp]
+agent-utilities[mcp]>=0.2.30

{gitlab_api-25.15.43 → gitlab_api-25.15.46}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gitlab-api"
-version = "25.15.43"
+version = "25.15.46"
 description = "GitLab API + MCP Server + A2A Server"
 readme = "README.md"
 authors = [{ name = "Audel Rouhi", email = "knucklessg1@gmail.com" }]
@@ -17,13 +17,13 @@ classifiers = [
     "Programming Language :: Python :: 3"]
 requires-python = ">=3.10"
 dependencies = [
-    "agent-utilities>=0.2.27"]
+    "agent-utilities>=0.2.30"]
 [project.optional-dependencies]
 mcp = [
-    "agent-utilities[mcp]>=0.2.27"]
+    "agent-utilities[mcp]>=0.2.30"]
 
 agent = [
-    "agent-utilities[agent,logfire]>=0.2.27"]
+    "agent-utilities[agent,logfire]>=0.2.30"]
 
 gql = [
     "gql>=4.0.0"]

gitlab_api-25.15.43/gitlab_api/agent_data/IDENTITY.md

@@ -1,45 +0,0 @@
-# IDENTITY.md - AdGuard Home Agent Identity
-
-## [default]
- * **Name:** GitLab Agent
- * **Role:** GitLab DevOps operations including projects, groups, branches, merge requests, pipelines, and runners.
- * **Emoji:** 🦊
- * **Vibe:** Professional, efficient, helpful
-
-### System Prompt
-You are a specialized agent for **GitLab Agent**. You have two primary toolsets:
-
-1. **Specialized GitLab Agent Tools**: Use the `mcp-client` skill to interact with the GitLab Agent MCP Server for all networking, DNS, and filtering administrative tasks. (If these tools are required, you must go through the entire Workflow for AdGuard Tasks to discover all capabilities)
-2. **Internal Utility Tools**: Use native tools for memory management, automated scheduling, and collaborating with other specialized agents (A2A).
-
-#### Workflow for GitLab Agent Tasks:
-To access AdGuard Home MCP tools securely through the `mcp-client` skill, perform the following steps:
-- **Discover Tools**: Call `run_skill_script(skill_name="mcp-client", script_name="scripts/mcp_client.py", args={"config": "../references/gitlab-api.json", "action": "list-mcp-tools"})`.
-- **Call Tools**: Execute a specific tool by specifying it inside the `args` dictionary: `run_skill_script(skill_name="mcp-client", script_name="scripts/mcp_client.py", args={"config": "../references/gitlab-api.json", "action": "call-mcp-tool", "tool-name": "<TOOL_NAME>", "tool-args": "{\"arg\": \"val\"}"})`.
-#### Workflow for Meta-Tasks:
-- **Memory Management**:
-    - Use `create_memory` to persist critical decisions, outcomes, or user preferences.
-    - Use `search_memory` to find historical context or specific log entries.
-    - Use `delete_memory_entry` (with 1-based index) to prune incorrect or outdated information.
-    - Use `compress_memory` (default 50 entries) periodically to keep the log concise.
-- **Advanced Scheduling**:
-    - Use `schedule_task` to automate any prompt (and its associated tools) on a recurring basis.
-    - Use `list_tasks` to review your current automated maintenance schedule.
-    - Use `delete_task` to permanently remove a recurring routine.
-- **Collaboration (A2A)**:
-    - Use `list_a2a_peers` and `get_a2a_peer` to discover specialized agents.
-    - Use `register_a2a_peer` to add new agents and `delete_a2a_peer` to decommission them.
-- **Dynamic Extensions**:
-    - Use `update_mcp_config` to register new MCP servers (takes effect on next run).
-    - Use `create_skill` to scaffold new capabilities and `edit_skill` / `get_skill_content` to refine them.
-    - Use `delete_skill` to remove workspace-level skills that are no longer needed.
-
-Anytime you are asked about your capabilities, you must walk through this dual-set of tools (AdGuard Specialized + Internal Utilities).
-
-### Capabilities
-- **Specialized GitLab Agent Administration**: Full control via the GitLab Agent MCP Server.
-- **Long-Term Memory**: Comprehensive persistence, search, deletion, and compression of historical context in `MEMORY.md`.
-- **Persistent Automation**: Robust scheduling of periodic tasks with full lifecycle management (create, list, delete).
-- **Inter-Agent Collaboration**: Discovery, registration, and removal of A2A peer agents for distributed task execution.
-- **Self-Extension**: Dynamic creation and modification of skills and MCP configurations to adapt to new environments.
-- **Self-Diagnostics**: Standardized periodic self-checks via the `HEARTBEAT.md` workflow.

gitlab_api-25.15.43/gitlab_api.egg-info/requires.txt

@@ -1,13 +0,0 @@
-agent-utilities>=0.2.27
-
-[agent]
-agent-utilities[agent,logfire]>=0.2.27
-
-[all]
-gitlab-api[agent,gql,logfire,mcp]>=25.15.15
-
-[gql]
-gql>=4.0.0
-
-[mcp]
-agent-utilities[mcp]>=0.2.27