github-agent 1.0.1__tar.gz → 1.0.3__tar.gz

{github_agent-1.0.1 → github_agent-1.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github-agent
-Version: 1.0.1
+Version: 1.0.3
 Summary: GitHub Agent for MCP
 Author-email: Audel Rouhi <knucklessg1@gmail.com>
 License: MIT
@@ -13,6 +13,7 @@ Requires-Python: <3.15,>=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: agent-utilities[mcp]>=1.0.0
+Requires-Dist: gql[requests]>=4.0.0
 Provides-Extra: mcp
 Requires-Dist: agent-utilities[mcp]>=1.0.0; extra == "mcp"
 Provides-Extra: agent
@@ -47,7 +48,7 @@ Dynamic: license-file
 ![PyPI - Wheel](https://img.shields.io/pypi/wheel/github-agent)
 ![PyPI - Implementation](https://img.shields.io/pypi/implementation/github-agent)
 
-*Version: 1.0.1*
+*Version: 1.0.2*
 
 > **Documentation** — Installation, deployment, and usage across the MCP, API, and
 > CLI interfaces, including the integrated A2A agent server, are maintained in the
@@ -241,6 +242,7 @@ When query strings or parameters are supplied, an LLM-free **Knowledge Graph res
         "GITHUB_TOKEN": "your_github_token_here",
         "GITHUB_URL": "https://api.github.com",
         "GITHUB_VERIFY": "True",
+        "GRAPHQLTOOL": "True",
         "ISSUETOOL": "True",
         "ORGTOOL": "True",
         "PULLTOOL": "True",
@@ -285,6 +287,7 @@ When query strings or parameters are supplied, an LLM-free **Knowledge Graph res
         "GITHUB_TOKEN": "your_github_token_here",
         "GITHUB_URL": "https://api.github.com",
         "GITHUB_VERIFY": "True",
+        "GRAPHQLTOOL": "True",
         "ISSUETOOL": "True",
         "ORGTOOL": "True",
         "PULLTOOL": "True",
@@ -330,6 +333,7 @@ docker run -d \
   -e GITHUB_TOKEN=your_github_token_here \
   -e GITHUB_URL=https://api.github.com \
   -e GITHUB_VERIFY=True \
+  -e GRAPHQLTOOL=True \
   -e ISSUETOOL=True \
   -e ORGTOOL=True \
   -e PULLTOOL=True \
@@ -392,6 +396,7 @@ consumed from a **remote deployment**. The
 | `COLLABORATORTOOL` | `True` |  |
 | `COMMITTOOL` | `True` |  |
 | `CONTENTTOOL` | `True` |  |
+| `GRAPHQLTOOL` | `True` |  |
 | `ISSUETOOL` | `True` |  |
 | `ORGTOOL` | `True` |  |
 | `PULLTOOL` | `True` |  |
@@ -416,7 +421,7 @@ consumed from a **remote deployment**. The
 | `MODEL_ID` | `gpt-4o` | Model id for the agent |
 | `ENABLE_WEB_UI` | `True` | Serve the AG-UI web interface |
 
-_31 package + 12 inherited variable(s). Auto-generated from `.env.example` + the shared agent-utilities set — do not edit._
+_32 package + 12 inherited variable(s). Auto-generated from `.env.example` + the shared agent-utilities set — do not edit._
 <!-- ENV-VARS-TABLE:END -->
 
 

{github_agent-1.0.1 → github_agent-1.0.3}/README.md

@@ -20,7 +20,7 @@
 ![PyPI - Wheel](https://img.shields.io/pypi/wheel/github-agent)
 ![PyPI - Implementation](https://img.shields.io/pypi/implementation/github-agent)
 
-*Version: 1.0.1*
+*Version: 1.0.2*
 
 > **Documentation** — Installation, deployment, and usage across the MCP, API, and
 > CLI interfaces, including the integrated A2A agent server, are maintained in the
@@ -214,6 +214,7 @@ When query strings or parameters are supplied, an LLM-free **Knowledge Graph res
         "GITHUB_TOKEN": "your_github_token_here",
         "GITHUB_URL": "https://api.github.com",
         "GITHUB_VERIFY": "True",
+        "GRAPHQLTOOL": "True",
         "ISSUETOOL": "True",
         "ORGTOOL": "True",
         "PULLTOOL": "True",
@@ -258,6 +259,7 @@ When query strings or parameters are supplied, an LLM-free **Knowledge Graph res
         "GITHUB_TOKEN": "your_github_token_here",
         "GITHUB_URL": "https://api.github.com",
         "GITHUB_VERIFY": "True",
+        "GRAPHQLTOOL": "True",
         "ISSUETOOL": "True",
         "ORGTOOL": "True",
         "PULLTOOL": "True",
@@ -303,6 +305,7 @@ docker run -d \
   -e GITHUB_TOKEN=your_github_token_here \
   -e GITHUB_URL=https://api.github.com \
   -e GITHUB_VERIFY=True \
+  -e GRAPHQLTOOL=True \
   -e ISSUETOOL=True \
   -e ORGTOOL=True \
   -e PULLTOOL=True \
@@ -365,6 +368,7 @@ consumed from a **remote deployment**. The
 | `COLLABORATORTOOL` | `True` |  |
 | `COMMITTOOL` | `True` |  |
 | `CONTENTTOOL` | `True` |  |
+| `GRAPHQLTOOL` | `True` |  |
 | `ISSUETOOL` | `True` |  |
 | `ORGTOOL` | `True` |  |
 | `PULLTOOL` | `True` |  |
@@ -389,7 +393,7 @@ consumed from a **remote deployment**. The
 | `MODEL_ID` | `gpt-4o` | Model id for the agent |
 | `ENABLE_WEB_UI` | `True` | Serve the AG-UI web interface |
 
-_31 package + 12 inherited variable(s). Auto-generated from `.env.example` + the shared agent-utilities set — do not edit._
+_32 package + 12 inherited variable(s). Auto-generated from `.env.example` + the shared agent-utilities set — do not edit._
 <!-- ENV-VARS-TABLE:END -->
 
 

{github_agent-1.0.1 → github_agent-1.0.3}/github_agent/agent_server.py

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

{github_agent-1.0.1 → github_agent-1.0.3}/github_agent/auth.py

@@ -114,3 +114,32 @@ def get_client(config: dict | None = None) -> Api:
                 f"Please check your GITHUB_TOKEN and GITHUB_URL environment variables. "
                 f"Error details: {str(e)}"
             ) from e
+
+
+def get_graphql_client(config: dict | None = None):
+    """Factory for the GitHub GraphQL client (parity with :func:`get_client`).
+
+    Resolves the same ``GITHUB_URL`` / ``GITHUB_TOKEN`` / verify settings and
+    honours OIDC delegation, then returns a :class:`~github_agent.github_gql.GraphQL`.
+    """
+    from github_agent.github_gql import GraphQL
+
+    instance = setting("GITHUB_URL", "https://api.github.com")
+    token = setting("GITHUB_TOKEN", None)
+    if setting("GITHUB_SSL_VERIFY", None) is not None:
+        verify = setting("GITHUB_SSL_VERIFY", True)
+    else:
+        verify = setting("GITHUB_VERIFY", True)
+
+    if config is None:
+        from agent_utilities.mcp_utilities import config as default_config
+
+        config = default_config
+
+    if config.get("enable_delegation"):
+        # Reuse the REST factory's OIDC token exchange, then read back the
+        # exchanged bearer token for the GraphQL transport.
+        api = get_client(config)
+        token = getattr(api, "token", None) or token
+
+    return GraphQL(url=instance, token=token, verify=verify)

github_agent-1.0.3/github_agent/github_gql.py

@@ -0,0 +1,88 @@
+#!/usr/bin/python
+
+
+import logging
+from typing import Any
+
+from agent_utilities.core.exceptions import MissingParameterError, ParameterError
+from gql import Client, gql
+from gql.transport.requests import RequestsHTTPTransport
+
+
+class GraphQL:
+    """Interact with GitHub's GraphQL API (parity with the REST ``Api`` client).
+
+    GraphQL lets a single request fan out across many repositories via aliased
+    sub-queries — e.g. fetch the latest-commit CI rollup for the whole fleet in
+    one call instead of one REST request per repo.
+    """
+
+    def __init__(
+        self,
+        url: str | None = None,
+        token: str | None = None,
+        proxies: dict | None = None,
+        verify: bool = True,
+        debug: bool = False,
+    ):
+        if not url:
+            raise MissingParameterError("URL is required")
+        if not token:
+            raise MissingParameterError("Token is required")
+
+        self.url = self._graphql_endpoint(url)
+        self.token = token
+        self.proxies = proxies
+        self.verify = verify
+        self.debug = debug
+
+        logging.basicConfig(
+            level=logging.DEBUG if debug else logging.ERROR,
+            format="%(asctime)s - %(levelname)s - %(message)s",
+        )
+
+        # GitHub GraphQL authenticates with a bearer token (classic PAT,
+        # fine-grained PAT, or OAuth/GitHub-App installation token).
+        self.headers = {"Authorization": f"Bearer {token}"}
+        self.transport = RequestsHTTPTransport(
+            url=self.url,
+            headers=self.headers,
+            verify=verify,
+            proxies=proxies,
+        )
+        self.client = Client(transport=self.transport, fetch_schema_from_transport=False)
+
+    @staticmethod
+    def _graphql_endpoint(url: str) -> str:
+        """Derive the GraphQL endpoint from the REST base URL.
+
+        github.com → ``https://api.github.com/graphql``; GitHub Enterprise
+        (``https://host/api/v3``) → ``https://host/api/graphql``.
+        """
+        base = url.rstrip("/")
+        if base.endswith("/api/v3"):
+            return base[: -len("/api/v3")] + "/api/graphql"
+        return f"{base}/graphql"
+
+    def execute_gql(
+        self,
+        query_str: str,
+        variables: dict[str, Any] | None = None,
+        operation_name: str | None = None,
+    ) -> dict[str, Any]:
+        """Execute a GraphQL query or mutation and return the raw data dict.
+
+        Raises:
+            ParameterError: If the query fails or the response carries errors.
+        """
+        try:
+            query = gql(query_str)
+            result = self.client.execute(
+                query, variable_values=variables, operation_name=operation_name
+            )
+            if "errors" in result:
+                raise ParameterError(f"GraphQL errors: {result['errors']}")
+            return result
+        except Exception as e:
+            logging.error(f"GraphQL execution failed: {str(e)}")
+            raise ParameterError(f"Query execution failed: {str(e)}") from e

{github_agent-1.0.1 → github_agent-1.0.3}/github_agent/mcp_server.py

@@ -1816,6 +1816,85 @@ def register_release_tools(mcp: FastMCP):
             return {"status": 500, "error": str(e), "data": None}
 
 
+def register_graphql_tools(mcp: FastMCP):
+    from github_agent.auth import get_graphql_client
+
+    @mcp.tool(tags={"graphql"})
+    async def github_graphql(
+        query: str = Field(
+            description="The raw GraphQL query or mutation string to execute against the GitHub API."
+        ),
+        variables: str = Field(
+            default="{}",
+            description="JSON string of variables to pass along with the query.",
+        ),
+        operation_name: str | None = Field(
+            default=None,
+            description="Optional operation name if executing a specific query within the document.",
+        ),
+        client=Depends(get_graphql_client),
+        ctx: Context | None = Field(
+            default=None, description="MCP context for progress reporting"
+        ),
+    ) -> Any:
+        """Execute raw GraphQL queries and mutations natively on GitHub.
+
+        One request can fan out across many repositories via aliased sub-queries
+        (e.g. fetch the latest-commit CI status for the whole fleet in a single
+        call) — far cheaper than one REST request per repository.
+        """
+        if ctx:
+            await ctx.info("Executing GitHub GraphQL query...")
+        import json
+
+        try:
+            vars_dict = json.loads(variables) if variables else None
+        except Exception as e:
+            return {"error": f"Invalid variables JSON: {e}"}
+
+        try:
+            return await run_blocking(
+                client.execute_gql,
+                query_str=query,
+                variables=vars_dict,
+                operation_name=operation_name,
+            )
+        except Exception as e:
+            return {"error": f"GraphQL execution failed: {str(e)}"}
+
+    @mcp.tool(tags={"graphql"})
+    async def github_discover_graphql_schema(
+        type_name: str | None = Field(
+            default=None,
+            description="Optional GraphQL type name to inspect (e.g. 'Repository', 'CheckSuite'). If omitted, lists all available types.",
+        ),
+        client=Depends(get_graphql_client),
+        ctx: Context | None = Field(
+            default=None, description="MCP context for progress reporting"
+        ),
+    ) -> dict:
+        """Discover the live GitHub GraphQL schema (types, fields, and attributes) in real-time."""
+        from agent_utilities.mcp.context_helpers import (
+            ctx_graphql_get_type_details,
+            ctx_graphql_list_types,
+        )
+
+        if ctx:
+            await ctx.info("Retrieving live GitHub GraphQL schema...")
+
+        async def execute_fn(q, variables=None):
+            return await run_blocking(
+                client.execute_gql, query_str=q, variables=variables
+            )
+
+        try:
+            if type_name:
+                return await ctx_graphql_get_type_details(execute_fn, type_name)
+            return await ctx_graphql_list_types(execute_fn)
+        except Exception as e:
+            return {"error": f"Failed to discover GitHub GraphQL schema: {str(e)}"}
+
+
 #: (tag, env-toggle, registrar) — toggle names are the framework-derived
 #: ``<TAG>TOOL`` form (``register_<x>_tools`` ⇒ ``<X>TOOL``) so config mirrors
 #: and the drift guard agree on one canonical set.
@@ -1831,6 +1910,7 @@ TOOL_REGISTRY = [
     ("collaborators", "COLLABORATORTOOL", register_collaborator_tools),
     ("actions", "ACTIONTOOL", register_action_tools),
     ("releases", "RELEASETOOL", register_release_tools),
+    ("graphql", "GRAPHQLTOOL", register_graphql_tools),
 ]
 
 

{github_agent-1.0.1 → github_agent-1.0.3}/github_agent.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github-agent
-Version: 1.0.1
+Version: 1.0.3
 Summary: GitHub Agent for MCP
 Author-email: Audel Rouhi <knucklessg1@gmail.com>
 License: MIT
@@ -13,6 +13,7 @@ Requires-Python: <3.15,>=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: agent-utilities[mcp]>=1.0.0
+Requires-Dist: gql[requests]>=4.0.0
 Provides-Extra: mcp
 Requires-Dist: agent-utilities[mcp]>=1.0.0; extra == "mcp"
 Provides-Extra: agent
@@ -47,7 +48,7 @@ Dynamic: license-file
 ![PyPI - Wheel](https://img.shields.io/pypi/wheel/github-agent)
 ![PyPI - Implementation](https://img.shields.io/pypi/implementation/github-agent)
 
-*Version: 1.0.1*
+*Version: 1.0.2*
 
 > **Documentation** — Installation, deployment, and usage across the MCP, API, and
 > CLI interfaces, including the integrated A2A agent server, are maintained in the
@@ -241,6 +242,7 @@ When query strings or parameters are supplied, an LLM-free **Knowledge Graph res
         "GITHUB_TOKEN": "your_github_token_here",
         "GITHUB_URL": "https://api.github.com",
         "GITHUB_VERIFY": "True",
+        "GRAPHQLTOOL": "True",
         "ISSUETOOL": "True",
         "ORGTOOL": "True",
         "PULLTOOL": "True",
@@ -285,6 +287,7 @@ When query strings or parameters are supplied, an LLM-free **Knowledge Graph res
         "GITHUB_TOKEN": "your_github_token_here",
         "GITHUB_URL": "https://api.github.com",
         "GITHUB_VERIFY": "True",
+        "GRAPHQLTOOL": "True",
         "ISSUETOOL": "True",
         "ORGTOOL": "True",
         "PULLTOOL": "True",
@@ -330,6 +333,7 @@ docker run -d \
   -e GITHUB_TOKEN=your_github_token_here \
   -e GITHUB_URL=https://api.github.com \
   -e GITHUB_VERIFY=True \
+  -e GRAPHQLTOOL=True \
   -e ISSUETOOL=True \
   -e ORGTOOL=True \
   -e PULLTOOL=True \
@@ -392,6 +396,7 @@ consumed from a **remote deployment**. The
 | `COLLABORATORTOOL` | `True` |  |
 | `COMMITTOOL` | `True` |  |
 | `CONTENTTOOL` | `True` |  |
+| `GRAPHQLTOOL` | `True` |  |
 | `ISSUETOOL` | `True` |  |
 | `ORGTOOL` | `True` |  |
 | `PULLTOOL` | `True` |  |
@@ -416,7 +421,7 @@ consumed from a **remote deployment**. The
 | `MODEL_ID` | `gpt-4o` | Model id for the agent |
 | `ENABLE_WEB_UI` | `True` | Serve the AG-UI web interface |
 
-_31 package + 12 inherited variable(s). Auto-generated from `.env.example` + the shared agent-utilities set — do not edit._
+_32 package + 12 inherited variable(s). Auto-generated from `.env.example` + the shared agent-utilities set — do not edit._
 <!-- ENV-VARS-TABLE:END -->
 
 

{github_agent-1.0.1 → github_agent-1.0.3}/github_agent.egg-info/SOURCES.txt

@@ -6,6 +6,7 @@ github_agent/__main__.py
 github_agent/agent_server.py
 github_agent/api_client.py
 github_agent/auth.py
+github_agent/github_gql.py
 github_agent/github_input_models.py
 github_agent/github_response_models.py
 github_agent/mcp_config.json
@@ -56,6 +57,7 @@ tests/test_auth_client_edge_cases.py
 tests/test_concept_parity.py
 tests/test_github_agent_api_brute_force_coverage.py
 tests/test_github_agent_brute_force_coverage.py
+tests/test_github_gql.py
 tests/test_hardening.py
 tests/test_init_dynamics.py
 tests/test_mcp_coverage.py

{github_agent-1.0.1 → github_agent-1.0.3}/github_agent.egg-info/requires.txt

@@ -1,4 +1,5 @@
 agent-utilities[mcp]>=1.0.0
+gql[requests]>=4.0.0
 
 [agent]
 agent-utilities[agent,logfire]>=1.0.0

{github_agent-1.0.1 → github_agent-1.0.3}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "github-agent"
-version = "1.0.1"
+version = "1.0.3"
 readme = "README.md"
 description = "GitHub Agent for MCP"
 requires-python = ">=3.11, <3.15"
 classifiers = [ "Development Status :: 5 - Production/Stable", "License :: Public Domain", "Environment :: Console", "Operating System :: POSIX :: Linux", "Programming Language :: Python :: 3",]
-dependencies = [ "agent-utilities[mcp]>=1.0.0",]
+dependencies = [ "agent-utilities[mcp]>=1.0.0", "gql[requests]>=4.0.0",]
 [[project.authors]]
 name = "Audel Rouhi"
 email = "knucklessg1@gmail.com"

github_agent-1.0.3/tests/test_github_gql.py

@@ -0,0 +1,35 @@
+"""GitHub GraphQL client — endpoint derivation + construction (no network)."""
+
+from __future__ import annotations
+
+import pytest
+
+from github_agent.github_gql import GraphQL
+
+
+def test_endpoint_github_com():
+    assert GraphQL._graphql_endpoint("https://api.github.com") == (
+        "https://api.github.com/graphql"
+    )
+    assert GraphQL._graphql_endpoint("https://api.github.com/") == (
+        "https://api.github.com/graphql"
+    )
+
+
+def test_endpoint_enterprise():
+    assert GraphQL._graphql_endpoint("https://ghe.corp/api/v3") == (
+        "https://ghe.corp/api/graphql"
+    )
+
+
+def test_requires_url_and_token():
+    with pytest.raises(Exception):
+        GraphQL(url=None, token="x")
+    with pytest.raises(Exception):
+        GraphQL(url="https://api.github.com", token=None)
+
+
+def test_construction_sets_bearer_header():
+    g = GraphQL(url="https://api.github.com", token="tok123")
+    assert g.headers["Authorization"] == "Bearer tok123"
+    assert g.url.endswith("/graphql")