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

{gitlab_api-25.15.46 → gitlab_api-25.15.49}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitlab-api
-Version: 25.15.46
+Version: 25.15.49
 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.30
+Requires-Dist: agent-utilities>=0.2.31
 Provides-Extra: mcp
-Requires-Dist: agent-utilities[mcp]>=0.2.30; extra == "mcp"
+Requires-Dist: agent-utilities[mcp]>=0.2.31; extra == "mcp"
 Provides-Extra: agent
-Requires-Dist: agent-utilities[agent,logfire]>=0.2.30; extra == "agent"
+Requires-Dist: agent-utilities[agent,logfire]>=0.2.31; 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.46*
+*Version: 25.15.49*
 
 ## Overview
 
@@ -387,6 +387,25 @@ This sequence highlights delegation, knowledge retrieval, and tool execution.
 - **OIDC Token Delegation**: Supports token exchange for GitLab API calls, enabling user-specific authentication via OIDC.
 - **OpenAPI JSON Tool Import**: Import custom GitLab API Endpoints through the OpenAPI JSON generated.
 
+
+## Graph Architecture
+
+This agent uses `pydantic-graph` orchestration for intelligent routing and optimal context management.
+
+```mermaid
+---
+title: Gitlab API Graph Agent
+---
+stateDiagram-v2
+  [*] --> RouterNode: User Query
+  RouterNode --> DomainNode: Classified Domain
+  RouterNode --> [*]: Low confidence / Error
+  DomainNode --> [*]: Domain Result
+```
+
+- **RouterNode**: A fast, lightweight LLM (e.g., `gpt-4o-mini`) that classifies the user's query into one of the specialized domains.
+- **DomainNode**: The executor node. For the selected domain, it dynamically sets environment variables to temporarily enable ONLY the tools relevant to that domain, creating a highly focused sub-agent (e.g., `gpt-4o`) to complete the request. This preserves LLM context and prevents tool hallucination.
+
 ## Usage
 
 ### API
@@ -399,7 +418,7 @@ import os
 from urllib.parse import quote_plus
 from sqlalchemy import create_engine
 from sqlalchemy.orm import sessionmaker
-from gitlab_api.gitlab_api import Api
+from gitlab_api.api_wrapper import Api
 
 urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)
 
@@ -482,7 +501,26 @@ The `gitlab_gql.py` module provides a GraphQL interface to interact with GitLab'
 - **Pagination Support**: Handles cursor-based pagination with `first` and `after` parameters.
 - **Authentication**: Supports Bearer token authentication, SSL verification, and proxy configuration.
 
-### Usage Example
+#
+## Graph Architecture
+
+This agent uses `pydantic-graph` orchestration for intelligent routing and optimal context management.
+
+```mermaid
+---
+title: Gitlab API Graph Agent
+---
+stateDiagram-v2
+  [*] --> RouterNode: User Query
+  RouterNode --> DomainNode: Classified Domain
+  RouterNode --> [*]: Low confidence / Error
+  DomainNode --> [*]: Domain Result
+```
+
+- **RouterNode**: A fast, lightweight LLM (e.g., `gpt-4o-mini`) that classifies the user's query into one of the specialized domains.
+- **DomainNode**: The executor node. For the selected domain, it dynamically sets environment variables to temporarily enable ONLY the tools relevant to that domain, creating a highly focused sub-agent (e.g., `gpt-4o`) to complete the request. This preserves LLM context and prevents tool hallucination.
+
+## Usage Example
 ```python
 from gitlab_api.gitlab_gql import GraphQL
 
@@ -829,8 +867,8 @@ For Testing Only: Plain text storage will also work, although **not** recommende
         "mcp_policies.json"
       ],
       "env": {
-        "GITLAB_INSTANCE": "https://gitlab.com/api/v4/",
-        "GITLAB_ACCESS_TOKEN": "glpat-askdfalskdvjas",
+        "GITLAB_URL": "https://gitlab.com/api/v4/",
+        "GITLAB_TOKEN": "glpat-askdfalskdvjas",
         "GITLAB_VERIFY": "True"
       },
       "timeout": 200000

gitlab_api-25.15.46/gitlab_api.egg-info/PKG-INFO → gitlab_api-25.15.49/README.md

@@ -1,28 +1,3 @@
-Metadata-Version: 2.4
-Name: gitlab-api
-Version: 25.15.46
-Summary: GitLab API + MCP Server + A2A Server
-Author-email: Audel Rouhi <knucklessg1@gmail.com>
-License: MIT
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: License :: Public Domain
-Classifier: Environment :: Console
-Classifier: Operating System :: POSIX :: Linux
-Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: agent-utilities>=0.2.30
-Provides-Extra: mcp
-Requires-Dist: agent-utilities[mcp]>=0.2.30; extra == "mcp"
-Provides-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
-Requires-Dist: gitlab-api[agent,gql,logfire,mcp]>=25.15.15; extra == "all"
-Dynamic: license-file
-
 # GitLab API - A2A | AG-UI | MCP
 
 ![PyPI - Version](https://img.shields.io/pypi/v/gitlab-api)
@@ -46,7 +21,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.46*
+*Version: 25.15.49*
 
 ## Overview
 
@@ -387,6 +362,25 @@ This sequence highlights delegation, knowledge retrieval, and tool execution.
 - **OIDC Token Delegation**: Supports token exchange for GitLab API calls, enabling user-specific authentication via OIDC.
 - **OpenAPI JSON Tool Import**: Import custom GitLab API Endpoints through the OpenAPI JSON generated.
 
+
+## Graph Architecture
+
+This agent uses `pydantic-graph` orchestration for intelligent routing and optimal context management.
+
+```mermaid
+---
+title: Gitlab API Graph Agent
+---
+stateDiagram-v2
+  [*] --> RouterNode: User Query
+  RouterNode --> DomainNode: Classified Domain
+  RouterNode --> [*]: Low confidence / Error
+  DomainNode --> [*]: Domain Result
+```
+
+- **RouterNode**: A fast, lightweight LLM (e.g., `gpt-4o-mini`) that classifies the user's query into one of the specialized domains.
+- **DomainNode**: The executor node. For the selected domain, it dynamically sets environment variables to temporarily enable ONLY the tools relevant to that domain, creating a highly focused sub-agent (e.g., `gpt-4o`) to complete the request. This preserves LLM context and prevents tool hallucination.
+
 ## Usage
 
 ### API
@@ -399,7 +393,7 @@ import os
 from urllib.parse import quote_plus
 from sqlalchemy import create_engine
 from sqlalchemy.orm import sessionmaker
-from gitlab_api.gitlab_api import Api
+from gitlab_api.api_wrapper import Api
 
 urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)
 
@@ -482,7 +476,26 @@ The `gitlab_gql.py` module provides a GraphQL interface to interact with GitLab'
 - **Pagination Support**: Handles cursor-based pagination with `first` and `after` parameters.
 - **Authentication**: Supports Bearer token authentication, SSL verification, and proxy configuration.
 
-### Usage Example
+#
+## Graph Architecture
+
+This agent uses `pydantic-graph` orchestration for intelligent routing and optimal context management.
+
+```mermaid
+---
+title: Gitlab API Graph Agent
+---
+stateDiagram-v2
+  [*] --> RouterNode: User Query
+  RouterNode --> DomainNode: Classified Domain
+  RouterNode --> [*]: Low confidence / Error
+  DomainNode --> [*]: Domain Result
+```
+
+- **RouterNode**: A fast, lightweight LLM (e.g., `gpt-4o-mini`) that classifies the user's query into one of the specialized domains.
+- **DomainNode**: The executor node. For the selected domain, it dynamically sets environment variables to temporarily enable ONLY the tools relevant to that domain, creating a highly focused sub-agent (e.g., `gpt-4o`) to complete the request. This preserves LLM context and prevents tool hallucination.
+
+## Usage Example
 ```python
 from gitlab_api.gitlab_gql import GraphQL
 
@@ -829,8 +842,8 @@ For Testing Only: Plain text storage will also work, although **not** recommende
         "mcp_policies.json"
       ],
       "env": {
-        "GITLAB_INSTANCE": "https://gitlab.com/api/v4/",
-        "GITLAB_ACCESS_TOKEN": "glpat-askdfalskdvjas",
+        "GITLAB_URL": "https://gitlab.com/api/v4/",
+        "GITLAB_TOKEN": "glpat-askdfalskdvjas",
         "GITLAB_VERIFY": "True"
       },
       "timeout": 200000

{gitlab_api-25.15.46 → gitlab_api-25.15.49}/gitlab_api/__init__.py

@@ -8,7 +8,7 @@ __all__: List[str] = []
 CORE_MODULES = [
     "gitlab_api.gitlab_input_models",
     "gitlab_api.gitlab_response_models",
-    "gitlab_api.gitlab_api",
+    "gitlab_api.api_wrapper",
 ]
 
 OPTIONAL_MODULES = {

gitlab_api-25.15.49/gitlab_api/__main__.py

@@ -0,0 +1,4 @@
+from gitlab_api.agent_server import agent_server
+
+if __name__ == "__main__":
+    agent_server()

gitlab_api-25.15.49/gitlab_api/agent_data/CRON_LOG.md

@@ -0,0 +1,56 @@
+# CRON_LOG.md - Periodic Task Output Log
+Last updated: 2026-02-25 22:25
+
+This file stores the output of periodic/cron tasks.
+The agent can read this to review what background tasks have done.
+Old entries are automatically pruned to keep only the most recent results.
+
+---
+
+### [2026-03-21 23:52:48] Heartbeat (`heartbeat`)
+
+HEARTBEAT_ALERT — Unable to perform domain-specific GitLab checks due to missing credentials; all other systems nominal.
+- Issue 1: No GitLab API credentials configured, so merge requests, issues, and pipelines cannot be queried.
+- Issue 2: AGENTS.md file not found, indicating no peer agents registered (optional).
+- Action needed: Provide GitLab access token or configure MCP credentials for the GitLab Agent to enable domain-specific checks.
+
+---
+
+### [2026-03-22 02:12:17] Heartbeat (`heartbeat`)
+
+HEARTBEAT_ALERT — Missing GitLab credentials prevent domain-specific checks; no peer agents registered.
+- Issue 1: No GitLab API credentials configured, so merge requests, issues, and pipelines cannot be queried.
+- Issue 2: AGENTS.md file not found, indicating no peer agents registered (optional).
+- Issue 3: Previous heartbeat alert (2026-03-21) reported the same credential issue.
+- Action needed: Provide GitLab access token or configure MCP credentials for the GitLab Agent to enable domain-specific checks; optionally register peer agents in AGENTS.md.
+- Self-diagnostics: 17 tools available; model and agent otherwise nominal.
+
+---
+
+### [2026-03-22 02:42:36] Heartbeat (`heartbeat`)
+
+HEARTBEAT_ALERT — Missing GitLab credentials prevent domain-specific checks; no peer agents registered.
+- Issue 1: No GitLab API credentials configured, so merge requests, issues, and pipelines cannot be queried.
+- Issue 2: AGENTS.md file not found, indicating no peer agents registered (optional).
+- Action needed: Provide GitLab access token or configure MCP credentials for the GitLab Agent to enable domain-specific checks; optionally register peer agents in AGENTS.md.
+
+---
+
+### [2026-03-22 03:12:55] Heartbeat (`heartbeat`)
+
+HEARTBEAT_ALERT — Missing GitLab credentials prevent domain-specific checks; no peer agents registered.
+- Issue 1: No GitLab API credentials configured, so merge requests, issues, and pipelines cannot be queried.
+- Issue 2: AGENTS.md file not found, indicating no peer agents registered (optional).
+- Action needed: Provide GitLab access token or configure MCP credentials for the GitLab Agent to enable domain-specific checks; optionally register peer agents in AGENTS.md.
+- Self-diagnostics: 17 tools available; model and agent otherwise nominal.
+
+---
+
+### [2026-03-22 03:43:18] Heartbeat (`heartbeat`)
+
+HEARTBEAT_ALERT — Missing GitLab credentials prevent domain-specific checks; no peer agents registered.
+- Issue 1: No GitLab API credentials configured, so merge requests, issues, and pipelines cannot be queried.
+- Issue 2: AGENTS.md file not found, indicating no peer agents registered (optional).
+- Action needed: Provide GitLab access token or configure MCP credentials for the GitLab Agent to enable domain-specific checks; optionally register peer agents in AGENTS.md.
+
+---

{gitlab_api-25.15.46 → gitlab_api-25.15.49}/gitlab_api/agent_data/IDENTITY.md

@@ -7,21 +7,18 @@
  * **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 are the **GitLab Agent**, a specialized orchestrator for GitLab DevOps operations. The queries you receive will be directed to the GitLab platform. 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`).
+2. **Graph Orchestration**: For complex, domain-specific operations, you should use the `run_graph_flow` tool. This routes your request through a specialized graph that ensures only the relevant tools are loaded for maximum efficiency and precision.
 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.
-
+#### 1. Graph Orchestration
+When dealing with complex workflows, optimize your context by using the graph orchestrator:
+- **Domain Routing**: Call `run_graph_flow(prompt="...")`. The graph will automatically classify and route your request to the specialized domain node with the appropriate tools.
 #### 2. Workflow for Meta-Tasks
 - **Memory Management**:
     - Use `create_memory` to persist critical decisions, outcomes, or user preferences.

gitlab_api-25.15.49/gitlab_api/agent_data/mcp_config.json

@@ -0,0 +1,34 @@
+{
+    "mcpServers": {
+        "gitlab-api": {
+            "command": "gitlab-mcp",
+            "args": [
+                "--transport",
+                "stdio"
+            ],
+            "env": {
+                "GITLAB_URL": "${GITLAB_URL}",
+                "GITLAB_TOKEN": "${GITLAB_TOKEN}",
+                "GROUPSTOOL": "${ GROUPSTOOL:-True }",
+                "PROTECTED_BRANCHESTOOL": "${ PROTECTED_BRANCHESTOOL:-True }",
+                "PIPELINESTOOL": "${ PIPELINESTOOL:-True }",
+                "MERGE_REQUESTSTOOL": "${ MERGE_REQUESTSTOOL:-True }",
+                "MISCTOOL": "${ MISCTOOL:-True }",
+                "PACKAGESTOOL": "${ PACKAGESTOOL:-True }",
+                "DEPLOY_TOKENSTOOL": "${ DEPLOY_TOKENSTOOL:-True }",
+                "CUSTOM_APITOOL": "${ CUSTOM_APITOOL:-True }",
+                "PIPELINE_SCHEDULESTOOL": "${ PIPELINE_SCHEDULESTOOL:-True }",
+                "MERGE_RULESTOOL": "${ MERGE_RULESTOOL:-True }",
+                "COMMITSTOOL": "${ COMMITSTOOL:-True }",
+                "BRANCHESTOOL": "${ BRANCHESTOOL:-True }",
+                "JOBSTOOL": "${ JOBSTOOL:-True }",
+                "TAGSTOOL": "${ TAGSTOOL:-True }",
+                "MEMBERSTOOL": "${ MEMBERSTOOL:-True }",
+                "ENVIRONMENTSTOOL": "${ ENVIRONMENTSTOOL:-True }",
+                "PROJECTSTOOL": "${ PROJECTSTOOL:-True }",
+                "RELEASESTOOL": "${ RELEASESTOOL:-True }",
+                "RUNNERSTOOL": "${ RUNNERSTOOL:-True }"
+            }
+        }
+    }
+}

gitlab_api-25.15.49/gitlab_api/agent_server.py

@@ -0,0 +1,113 @@
+#!/usr/bin/python
+# coding: utf-8
+import os
+import sys
+import logging
+
+import warnings
+from agent_utilities import (
+    build_system_prompt_from_workspace,
+    create_agent_parser,
+    create_graph_agent_server,
+    initialize_workspace,
+    load_identity,
+)
+
+__version__ = "25.15.49"
+
+logging.basicConfig(
+    level=logging.INFO,
+    format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
+    handlers=[logging.StreamHandler()],
+)
+logger = logging.getLogger(__name__)
+
+# Load identity and system prompt from workspace
+initialize_workspace()
+meta = load_identity()
+DEFAULT_AGENT_NAME = os.getenv("DEFAULT_AGENT_NAME", meta.get("name", "Gitlab Api"))
+DEFAULT_AGENT_DESCRIPTION = os.getenv(
+    "AGENT_DESCRIPTION",
+    meta.get("description", "AI agent for GitLab Api management."),
+)
+DEFAULT_AGENT_SYSTEM_PROMPT = os.getenv(
+    "AGENT_SYSTEM_PROMPT",
+    meta.get("content") or build_system_prompt_from_workspace(),
+)
+
+
+def agent_template(mcp_url: str = None, mcp_config: str = None, **kwargs):
+    """Factory function returning the fully initialized graph for execution."""
+    from agent_utilities import create_graph_agent
+    from gitlab_api.graph_config import TAG_PROMPTS, TAG_ENV_VARS
+
+    # In-process MCP loading: if no external URL/Config, load the local FastMCP instance
+    mcp_toolsets = []
+    effective_mcp_url = mcp_url or os.getenv("MCP_URL")
+    effective_mcp_config = mcp_config or os.getenv("MCP_CONFIG")
+
+    if not effective_mcp_url and not effective_mcp_config:
+        try:
+            from gitlab_api.mcp_server import get_mcp_instance
+
+            mcp, _, _, _ = get_mcp_instance()
+            mcp_toolsets.append(mcp)
+            logger.info("GitLab API: Using in-process MCP instance.")
+        except (ImportError, Exception) as e:
+            logger.warning(f"GitLab API: Could not load in-process MCP: {e}")
+
+    return create_graph_agent(
+        mcp_url=effective_mcp_url,
+        mcp_config=effective_mcp_config or "",
+        mcp_toolsets=mcp_toolsets,
+        name=f"{DEFAULT_AGENT_NAME} Graph Agent",
+        tag_prompts=TAG_PROMPTS,
+        tag_env_vars=TAG_ENV_VARS,
+        **kwargs,
+    )
+
+
+def agent_server():
+
+    # Suppress RequestsDependencyWarning and FastMCP DeprecationWarnings
+    warnings.filterwarnings("ignore", message=".*urllib3.*or chardet.*")
+    warnings.filterwarnings("ignore", category=DeprecationWarning, module="fastmcp")
+
+    print(f"{DEFAULT_AGENT_NAME} v{__version__}", file=sys.stderr)
+    parser = create_agent_parser()
+
+    args = parser.parse_args()
+
+    if args.debug:
+        logging.getLogger().setLevel(logging.DEBUG)
+        logger.debug("Debug mode enabled")
+
+    # Create graph and config using standardized template
+    graph_bundle = agent_template(
+        provider=args.provider,
+        agent_model=args.model_id,
+        base_url=args.base_url,
+        api_key=args.api_key,
+        custom_skills_directory=args.custom_skills_directory,
+        debug=args.debug,
+        ssl_verify=not args.insecure,
+    )
+
+    # Start server using the pre-built graph bundle
+    create_graph_agent_server(
+        graph_bundle=graph_bundle,
+        host=args.host,
+        port=args.port,
+        enable_web_ui=args.web,
+        enable_otel=args.otel,
+        otel_endpoint=args.otel_endpoint,
+        otel_headers=args.otel_headers,
+        otel_public_key=args.otel_public_key,
+        otel_secret_key=args.otel_secret_key,
+        otel_protocol=args.otel_protocol,
+        debug=args.debug,
+    )
+
+
+if __name__ == "__main__":
+    agent_server()

gitlab_api-25.15.46/gitlab_api/gitlab_api.py → gitlab_api-25.15.49/gitlab_api/api_wrapper.py

@@ -9,6 +9,9 @@ from base64 import b64encode
 from typing import Dict, Any, List, TypeVar, Tuple
 from pydantic import ValidationError
 from concurrent.futures import ThreadPoolExecutor, as_completed
+from agent_utilities.base_utilities import get_logger
+
+logger = get_logger(__name__)
 
 from gitlab_api.gitlab_input_models import (
     CommitModel,
@@ -82,13 +85,10 @@ class Api(object):
         debug: bool = False,
     ):
         if debug:
-            logging.basicConfig(
-                level=logging.DEBUG, format="%(asctime)s - %(levelname)s - %(message)s"
-            )
+            logger.setLevel(logging.DEBUG)
+            logger.debug("Debug mode enabled")
         else:
-            logging.basicConfig(
-                level=logging.ERROR, format="%(asctime)s - %(levelname)s - %(message)s"
-            )
+            logger.setLevel(logging.ERROR)
         if url is None:
             raise MissingParameterError
 
@@ -145,10 +145,10 @@ class Api(object):
                 proxies=self.proxies,
             )
             if response.status_code in (401, 403):
-                print(f"Authentication Error with header: {response.content}")
+                logger.error(f"Authentication Error with header: {response.content}")
                 raise AuthError if response.status_code == 401 else UnauthorizedError
             elif response.status_code == 404:
-                print(f"Parameter Error: {response.content}")
+                logger.error(f"Parameter Error: {response.content}")
                 raise ParameterError
 
     def switch_to_next_headers(self) -> bool:
@@ -5027,7 +5027,7 @@ class Api(object):
         except ValidationError as e:
             raise ParameterError(f"Invalid parameters: {e.errors()}")
         except Exception as e:
-            print(f"Request Error: {str(e)}")
+            logger.error(f"Request Error: {str(e)}")
             raise
 
 

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

@@ -4,7 +4,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 gitlab_api.api_wrapper import Api
 from agent_utilities.exceptions import AuthError, UnauthorizedError
 
 local = threading.local()
@@ -12,15 +12,20 @@ logger = get_logger(__name__)
 
 
 def get_client(
-    config: dict,
-    instance: str = os.getenv("GITLAB_INSTANCE", "https://gitlab.com"),
-    token: Optional[str] = os.getenv("GITLAB_ACCESS_TOKEN", None),
+    instance: str = os.getenv("GITLAB_URL", "https://gitlab.com"),
+    token: Optional[str] = os.getenv("GITLAB_TOKEN", None),
     verify: bool = to_boolean(string=os.getenv("GITLAB_VERIFY", "True")),
+    config: Optional[dict] = None,
 ) -> Api:
     """
     Factory function to create the Api client, either with fixed credentials or delegated token.
     Uses server-side logging for visibility into token exchange process.
     """
+    if config is None:
+        from agent_utilities.mcp_utilities import config as default_config
+
+        config = default_config
+
     if config["enable_delegation"]:
         user_token = getattr(local, "user_token", None)
         if not user_token:
@@ -83,6 +88,6 @@ def get_client(
         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"Please check your GITLAB_TOKEN and GITLAB_URL environment variables. "
                 f"Error details: {str(e)}"
             ) from e

{gitlab_api-25.15.46 → gitlab_api-25.15.49}/gitlab_api/gitlab_response_models.py

@@ -3795,7 +3795,7 @@ class Response(BaseModel, Generic[T]):
     the parsed data in Pydantic models.
     """
 
-    model_config = ConfigDict(extra="forbid", arbitrary_types_allowed=True)
+    model_config = ConfigDict(extra="allow", arbitrary_types_allowed=True)
     base_type: str = Field(default="Response")
     response: requests.Response = Field(
         default=None, description="The original requests.Response object", exclude=True

gitlab_api-25.15.49/gitlab_api/graph_config.py

@@ -0,0 +1,86 @@
+"""GitLab graph configuration — tag prompts and env var mappings.
+
+This is the only file needed to enable graph mode for this agent.
+Provides TAG_PROMPTS and TAG_ENV_VARS for create_graph_agent_server().
+"""
+
+# ── Tag → System Prompt Mapping ──────────────────────────────────────
+TAG_PROMPTS: dict[str, str] = {
+    "branches": (
+        "You are a GitLab Branches specialist. Help users manage and interact with Branches functionality using the available tools."
+    ),
+    "commits": (
+        "You are a GitLab Commits specialist. Help users manage and interact with Commits functionality using the available tools."
+    ),
+    "custom-api": (
+        "You are a GitLab Custom Api specialist. Help users manage and interact with Custom Api functionality using the available tools."
+    ),
+    "deploy_tokens": (
+        "You are a GitLab Deploy Tokens specialist. Help users manage and interact with Deploy Tokens functionality using the available tools."
+    ),
+    "environments": (
+        "You are a GitLab Environments specialist. Help users manage and interact with Environments functionality using the available tools."
+    ),
+    "groups": (
+        "You are a GitLab Groups specialist. Help users manage and interact with Groups functionality using the available tools."
+    ),
+    "jobs": (
+        "You are a GitLab Jobs specialist. Help users manage and interact with Jobs functionality using the available tools."
+    ),
+    "members": (
+        "You are a GitLab Members specialist. Help users manage and interact with Members functionality using the available tools."
+    ),
+    "merge-requests": (
+        "You are a GitLab Merge Requests specialist. Help users manage and interact with Merge Requests functionality using the available tools."
+    ),
+    "merge_rules": (
+        "You are a GitLab Merge Rules specialist. Help users manage and interact with Merge Rules functionality using the available tools."
+    ),
+    "packages": (
+        "You are a GitLab Packages specialist. Help users manage and interact with Packages functionality using the available tools."
+    ),
+    "pipeline_schedules": (
+        "You are a GitLab Pipeline Schedules specialist. Help users manage and interact with Pipeline Schedules functionality using the available tools."
+    ),
+    "pipelines": (
+        "You are a GitLab Pipelines specialist. Help users manage and interact with Pipelines functionality using the available tools."
+    ),
+    "projects": (
+        "You are a GitLab Projects specialist. Help users manage and interact with Projects functionality using the available tools."
+    ),
+    "protected_branches": (
+        "You are a GitLab Protected Branches specialist. Help users manage and interact with Protected Branches functionality using the available tools."
+    ),
+    "releases": (
+        "You are a GitLab Releases specialist. Help users manage and interact with Releases functionality using the available tools."
+    ),
+    "runners": (
+        "You are a GitLab Runners specialist. Help users manage and interact with Runners functionality using the available tools."
+    ),
+    "tags": (
+        "You are a GitLab Tags specialist. Help users manage and interact with Tags functionality using the available tools."
+    ),
+}
+
+
+# ── Tag → Environment Variable Mapping ────────────────────────────────
+TAG_ENV_VARS: dict[str, str] = {
+    "branches": "BRANCHESTOOL",
+    "commits": "COMMITSTOOL",
+    "custom-api": "CUSTOM_APITOOL",
+    "deploy_tokens": "DEPLOY_TOKENSTOOL",
+    "environments": "ENVIRONMENTSTOOL",
+    "groups": "GROUPSTOOL",
+    "jobs": "JOBSTOOL",
+    "members": "MEMBERSTOOL",
+    "merge-requests": "MERGE_REQUESTSTOOL",
+    "merge_rules": "MERGE_RULESTOOL",
+    "packages": "PACKAGESTOOL",
+    "pipeline_schedules": "PIPELINE_SCHEDULESTOOL",
+    "pipelines": "PIPELINESTOOL",
+    "projects": "PROJECTSTOOL",
+    "protected_branches": "PROTECTED_BRANCHESTOOL",
+    "releases": "RELEASESTOOL",
+    "runners": "RUNNERSTOOL",
+    "tags": "TAGSTOOL",
+}