github-agent 1.0.2__tar.gz → 1.1.0__tar.gz

{github_agent-1.0.2 → github_agent-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github-agent
-Version: 1.0.2
+Version: 1.1.0
 Summary: GitHub Agent for MCP
 Author-email: Audel Rouhi <knucklessg1@gmail.com>
 License: MIT
@@ -48,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.2*
+*Version: 1.1.0*
 
 > **Documentation** — Installation, deployment, and usage across the MCP, API, and
 > CLI interfaces, including the integrated A2A agent server, are maintained in the
@@ -98,9 +98,12 @@ _Auto-generated from the live MCP server — do not edit by hand._
 | `github_collaborators` | `COLLABORATORTOOL` | Manage repository collaborators. |
 | `github_commits` | `COMMITTOOL` | Manage GitHub commits. |
 | `github_contents` | `CONTENTTOOL` | Manage GitHub contents. |
+| `github_discover_graphql_schema` | `GRAPHQLTOOL` | Discover the live GitHub GraphQL schema (types, fields, and attributes) in real-time. |
+| `github_graphql` | `GRAPHQLTOOL` | Execute raw GraphQL queries and mutations natively on GitHub. |
+| `github_ingest_repos` | `INGESTTOOL` | Natively ingest GitHub repositories into epistemic-graph as typed :Repository nodes. |
 | `github_issues` | `ISSUETOOL` | Manage GitHub issues. |
 | `github_orgs` | `ORGTOOL` | Manage GitHub organizations. |
-| `github_pulls` | `PULLTOOL` | Manage GitHub pull requests. |
+| `github_pulls` | `PULLTOOL` | Manage GitHub pull requests and their review/merge lifecycle. |
 | `github_releases` | `RELEASETOOL` | Manage repository releases. |
 | `github_repos` | `REPOTOOL` | Manage GitHub repositories and their GitHub Pages sites. |
 | `github_search` | `SEARCHTOOL` | Search GitHub repositories, issues, or code. |
@@ -108,7 +111,7 @@ _Auto-generated from the live MCP server — do not edit by hand._
 #### Verbose 1:1 API-mapped tools (`MCP_TOOL_MODE=verbose` or `both`)
 
 <details>
-<summary>66 per-operation tools — one per public API method (click to expand)</summary>
+<summary>72 per-operation tools — one per public API method (click to expand)</summary>
 
 | MCP Tool | Toggle Env Var | Description |
 |----------|----------------|-------------|
@@ -122,6 +125,7 @@ _Auto-generated from the live MCP server — do not edit by hand._
 | `github_create_organization_repository` | `APITOOL` | Create a repository in an organization. |
 | `github_create_pages` | `APITOOL` | Enable GitHub Pages for a repository (HTTP 201). |
 | `github_create_pull_request` | `APITOOL` | Create a new pull request in a repository. |
+| `github_create_pull_request_review` | `APITOOL` | Create a review on a pull request. |
 | `github_create_release` | `APITOOL` | Create a new repository release. |
 | `github_create_repository` | `APITOOL` | Create a new repository for the authenticated user. |
 | `github_delete_branch` | `APITOOL` | Delete a branch in a repository. |
@@ -153,17 +157,22 @@ _Auto-generated from the live MCP server — do not edit by hand._
 | `github_get_pull_requests` | `APITOOL` | List pull requests for a repository. |
 | `github_get_release` | `APITOOL` | Get a single repository release. |
 | `github_get_releases` | `APITOOL` | List repository releases. |
+| `github_get_repo_secret_public_key` | `APITOOL` | Get the public key for encrypting repository Actions secrets. |
 | `github_get_repo_secrets` | `APITOOL` | List repository Actions secrets names. |
 | `github_get_repositories` | `APITOOL` | List repositories for the authenticated user. |
 | `github_get_repository` | `APITOOL` | Get a specific repository. |
+| `github_get_workflow_job_logs` | `APITOOL` | Download the plaintext logs for a single workflow job. |
 | `github_get_workflow_run` | `APITOOL` | Get a single workflow run. |
+| `github_get_workflow_run_jobs` | `APITOOL` | List the jobs for a workflow run (optional ``filter``: latest/all). |
 | `github_get_workflow_runs` | `APITOOL` | List workflow runs for a repository. |
 | `github_get_workflows` | `APITOOL` | List workflows for a repository. |
 | `github_list_organizations` | `APITOOL` | List organizations. |
 | `github_list_pages_builds` | `APITOOL` | List GitHub Pages builds for a repository (newest first). |
+| `github_merge_pull_request` | `APITOOL` | Merge a pull request (``merge_method`` is merge, squash, or rebase). |
 | `github_remove_collaborator` | `APITOOL` | Remove a collaborator from a repository. |
 | `github_remove_organization_member` | `APITOOL` | Remove a user from an organization (repositories access included). |
 | `github_request_pages_build` | `APITOOL` | Request a fresh GitHub Pages build without pushing a commit. |
+| `github_request_reviewers` | `APITOOL` | Request individual and/or team reviewers on a pull request. |
 | `github_rerun_workflow_run` | `APITOOL` | Re-run a workflow run. |
 | `github_search_code` | `APITOOL` | Search code using query keywords. |
 | `github_search_issues` | `APITOOL` | Search issues using query keywords. |
@@ -181,7 +190,7 @@ _Auto-generated from the live MCP server — do not edit by hand._
 
 </details>
 
-_11 action-routed tool(s) (default) · 66 verbose 1:1 tool(s). Each is enabled unless its `<DOMAIN>TOOL` toggle is set false; `MCP_TOOL_MODE` selects the surface (`condensed` default · `verbose` 1:1 · `both`). Auto-generated — do not edit._
+_14 action-routed tool(s) (default) · 72 verbose 1:1 tool(s). Each is enabled unless its `<DOMAIN>TOOL` toggle is set false; `MCP_TOOL_MODE` selects the surface (`condensed` default · `verbose` 1:1 · `both`). Auto-generated — do not edit._
 <!-- MCP-TOOLS-TABLE:END -->
 
 Detailed tool schemas, parameter shapes, and validation constraints are preserved in [docs/mcp.md](docs/mcp.md).
@@ -243,6 +252,7 @@ When query strings or parameters are supplied, an LLM-free **Knowledge Graph res
         "GITHUB_URL": "https://api.github.com",
         "GITHUB_VERIFY": "True",
         "GRAPHQLTOOL": "True",
+        "INGESTTOOL": "True",
         "ISSUETOOL": "True",
         "ORGTOOL": "True",
         "PULLTOOL": "True",
@@ -288,6 +298,7 @@ When query strings or parameters are supplied, an LLM-free **Knowledge Graph res
         "GITHUB_URL": "https://api.github.com",
         "GITHUB_VERIFY": "True",
         "GRAPHQLTOOL": "True",
+        "INGESTTOOL": "True",
         "ISSUETOOL": "True",
         "ORGTOOL": "True",
         "PULLTOOL": "True",
@@ -334,6 +345,7 @@ docker run -d \
   -e GITHUB_URL=https://api.github.com \
   -e GITHUB_VERIFY=True \
   -e GRAPHQLTOOL=True \
+  -e INGESTTOOL=True \
   -e ISSUETOOL=True \
   -e ORGTOOL=True \
   -e PULLTOOL=True \
@@ -397,6 +409,7 @@ consumed from a **remote deployment**. The
 | `COMMITTOOL` | `True` |  |
 | `CONTENTTOOL` | `True` |  |
 | `GRAPHQLTOOL` | `True` |  |
+| `INGESTTOOL` | `True` |  |
 | `ISSUETOOL` | `True` |  |
 | `ORGTOOL` | `True` |  |
 | `PULLTOOL` | `True` |  |
@@ -421,7 +434,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 |
 
-_32 package + 12 inherited variable(s). Auto-generated from `.env.example` + the shared agent-utilities set — do not edit._
+_33 package + 12 inherited variable(s). Auto-generated from `.env.example` + the shared agent-utilities set — do not edit._
 <!-- ENV-VARS-TABLE:END -->
 
 
@@ -457,6 +470,7 @@ The full list is in the [Available MCP Tools](#available-mcp-tools) table above.
 | `COLLABORATORTOOL` | `github_collaborators` — repository collaborators | `True` |
 | `COMMITTOOL` | `github_commits` — commits | `True` |
 | `CONTENTTOOL` | `github_contents` — file contents | `True` |
+| `INGESTTOOL` | `github_ingest_repos` — KG repository ingestion | `True` |
 | `ISSUETOOL` | `github_issues` — issues | `True` |
 | `ORGTOOL` | `github_orgs` — organizations | `True` |
 | `PULLTOOL` | `github_pulls` — pull requests | `True` |

{github_agent-1.0.2 → github_agent-1.1.0}/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.2*
+*Version: 1.1.0*
 
 > **Documentation** — Installation, deployment, and usage across the MCP, API, and
 > CLI interfaces, including the integrated A2A agent server, are maintained in the
@@ -70,9 +70,12 @@ _Auto-generated from the live MCP server — do not edit by hand._
 | `github_collaborators` | `COLLABORATORTOOL` | Manage repository collaborators. |
 | `github_commits` | `COMMITTOOL` | Manage GitHub commits. |
 | `github_contents` | `CONTENTTOOL` | Manage GitHub contents. |
+| `github_discover_graphql_schema` | `GRAPHQLTOOL` | Discover the live GitHub GraphQL schema (types, fields, and attributes) in real-time. |
+| `github_graphql` | `GRAPHQLTOOL` | Execute raw GraphQL queries and mutations natively on GitHub. |
+| `github_ingest_repos` | `INGESTTOOL` | Natively ingest GitHub repositories into epistemic-graph as typed :Repository nodes. |
 | `github_issues` | `ISSUETOOL` | Manage GitHub issues. |
 | `github_orgs` | `ORGTOOL` | Manage GitHub organizations. |
-| `github_pulls` | `PULLTOOL` | Manage GitHub pull requests. |
+| `github_pulls` | `PULLTOOL` | Manage GitHub pull requests and their review/merge lifecycle. |
 | `github_releases` | `RELEASETOOL` | Manage repository releases. |
 | `github_repos` | `REPOTOOL` | Manage GitHub repositories and their GitHub Pages sites. |
 | `github_search` | `SEARCHTOOL` | Search GitHub repositories, issues, or code. |
@@ -80,7 +83,7 @@ _Auto-generated from the live MCP server — do not edit by hand._
 #### Verbose 1:1 API-mapped tools (`MCP_TOOL_MODE=verbose` or `both`)
 
 <details>
-<summary>66 per-operation tools — one per public API method (click to expand)</summary>
+<summary>72 per-operation tools — one per public API method (click to expand)</summary>
 
 | MCP Tool | Toggle Env Var | Description |
 |----------|----------------|-------------|
@@ -94,6 +97,7 @@ _Auto-generated from the live MCP server — do not edit by hand._
 | `github_create_organization_repository` | `APITOOL` | Create a repository in an organization. |
 | `github_create_pages` | `APITOOL` | Enable GitHub Pages for a repository (HTTP 201). |
 | `github_create_pull_request` | `APITOOL` | Create a new pull request in a repository. |
+| `github_create_pull_request_review` | `APITOOL` | Create a review on a pull request. |
 | `github_create_release` | `APITOOL` | Create a new repository release. |
 | `github_create_repository` | `APITOOL` | Create a new repository for the authenticated user. |
 | `github_delete_branch` | `APITOOL` | Delete a branch in a repository. |
@@ -125,17 +129,22 @@ _Auto-generated from the live MCP server — do not edit by hand._
 | `github_get_pull_requests` | `APITOOL` | List pull requests for a repository. |
 | `github_get_release` | `APITOOL` | Get a single repository release. |
 | `github_get_releases` | `APITOOL` | List repository releases. |
+| `github_get_repo_secret_public_key` | `APITOOL` | Get the public key for encrypting repository Actions secrets. |
 | `github_get_repo_secrets` | `APITOOL` | List repository Actions secrets names. |
 | `github_get_repositories` | `APITOOL` | List repositories for the authenticated user. |
 | `github_get_repository` | `APITOOL` | Get a specific repository. |
+| `github_get_workflow_job_logs` | `APITOOL` | Download the plaintext logs for a single workflow job. |
 | `github_get_workflow_run` | `APITOOL` | Get a single workflow run. |
+| `github_get_workflow_run_jobs` | `APITOOL` | List the jobs for a workflow run (optional ``filter``: latest/all). |
 | `github_get_workflow_runs` | `APITOOL` | List workflow runs for a repository. |
 | `github_get_workflows` | `APITOOL` | List workflows for a repository. |
 | `github_list_organizations` | `APITOOL` | List organizations. |
 | `github_list_pages_builds` | `APITOOL` | List GitHub Pages builds for a repository (newest first). |
+| `github_merge_pull_request` | `APITOOL` | Merge a pull request (``merge_method`` is merge, squash, or rebase). |
 | `github_remove_collaborator` | `APITOOL` | Remove a collaborator from a repository. |
 | `github_remove_organization_member` | `APITOOL` | Remove a user from an organization (repositories access included). |
 | `github_request_pages_build` | `APITOOL` | Request a fresh GitHub Pages build without pushing a commit. |
+| `github_request_reviewers` | `APITOOL` | Request individual and/or team reviewers on a pull request. |
 | `github_rerun_workflow_run` | `APITOOL` | Re-run a workflow run. |
 | `github_search_code` | `APITOOL` | Search code using query keywords. |
 | `github_search_issues` | `APITOOL` | Search issues using query keywords. |
@@ -153,7 +162,7 @@ _Auto-generated from the live MCP server — do not edit by hand._
 
 </details>
 
-_11 action-routed tool(s) (default) · 66 verbose 1:1 tool(s). Each is enabled unless its `<DOMAIN>TOOL` toggle is set false; `MCP_TOOL_MODE` selects the surface (`condensed` default · `verbose` 1:1 · `both`). Auto-generated — do not edit._
+_14 action-routed tool(s) (default) · 72 verbose 1:1 tool(s). Each is enabled unless its `<DOMAIN>TOOL` toggle is set false; `MCP_TOOL_MODE` selects the surface (`condensed` default · `verbose` 1:1 · `both`). Auto-generated — do not edit._
 <!-- MCP-TOOLS-TABLE:END -->
 
 Detailed tool schemas, parameter shapes, and validation constraints are preserved in [docs/mcp.md](docs/mcp.md).
@@ -215,6 +224,7 @@ When query strings or parameters are supplied, an LLM-free **Knowledge Graph res
         "GITHUB_URL": "https://api.github.com",
         "GITHUB_VERIFY": "True",
         "GRAPHQLTOOL": "True",
+        "INGESTTOOL": "True",
         "ISSUETOOL": "True",
         "ORGTOOL": "True",
         "PULLTOOL": "True",
@@ -260,6 +270,7 @@ When query strings or parameters are supplied, an LLM-free **Knowledge Graph res
         "GITHUB_URL": "https://api.github.com",
         "GITHUB_VERIFY": "True",
         "GRAPHQLTOOL": "True",
+        "INGESTTOOL": "True",
         "ISSUETOOL": "True",
         "ORGTOOL": "True",
         "PULLTOOL": "True",
@@ -306,6 +317,7 @@ docker run -d \
   -e GITHUB_URL=https://api.github.com \
   -e GITHUB_VERIFY=True \
   -e GRAPHQLTOOL=True \
+  -e INGESTTOOL=True \
   -e ISSUETOOL=True \
   -e ORGTOOL=True \
   -e PULLTOOL=True \
@@ -369,6 +381,7 @@ consumed from a **remote deployment**. The
 | `COMMITTOOL` | `True` |  |
 | `CONTENTTOOL` | `True` |  |
 | `GRAPHQLTOOL` | `True` |  |
+| `INGESTTOOL` | `True` |  |
 | `ISSUETOOL` | `True` |  |
 | `ORGTOOL` | `True` |  |
 | `PULLTOOL` | `True` |  |
@@ -393,7 +406,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 |
 
-_32 package + 12 inherited variable(s). Auto-generated from `.env.example` + the shared agent-utilities set — do not edit._
+_33 package + 12 inherited variable(s). Auto-generated from `.env.example` + the shared agent-utilities set — do not edit._
 <!-- ENV-VARS-TABLE:END -->
 
 
@@ -429,6 +442,7 @@ The full list is in the [Available MCP Tools](#available-mcp-tools) table above.
 | `COLLABORATORTOOL` | `github_collaborators` — repository collaborators | `True` |
 | `COMMITTOOL` | `github_commits` — commits | `True` |
 | `CONTENTTOOL` | `github_contents` — file contents | `True` |
+| `INGESTTOOL` | `github_ingest_repos` — KG repository ingestion | `True` |
 | `ISSUETOOL` | `github_issues` — issues | `True` |
 | `ORGTOOL` | `github_orgs` — organizations | `True` |
 | `PULLTOOL` | `github_pulls` — pull requests | `True` |

{github_agent-1.0.2 → github_agent-1.1.0}/github_agent/agent_server.py

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

{github_agent-1.0.2 → github_agent-1.1.0}/github_agent/api/api_client_pulls.py

@@ -86,3 +86,88 @@ class Api(BaseApiClient):
             return Response(response=response, data=parsed_data)
         except ValidationError as e:
             raise ParameterError(f"Invalid parameters: {e.errors()}") from e
+
+    @require_auth
+    def create_pull_request_review(
+        self,
+        owner: str,
+        repo: str,
+        number: int,
+        event: str = "APPROVE",
+        body: str | None = None,
+        **kwargs,
+    ) -> Response:
+        """Create a review on a pull request.
+
+        ``event`` is one of APPROVE, REQUEST_CHANGES, or COMMENT (GitHub requires
+        a ``body`` for REQUEST_CHANGES/COMMENT).
+        """
+        payload = {"event": event, **kwargs}
+        if body is not None:
+            payload["body"] = body
+        response = self._session.post(
+            url=f"{self.url}/repos/{owner}/{repo}/pulls/{number}/reviews",
+            json=payload,
+            headers=self.headers,
+            verify=self.verify,
+            proxies=self.proxies,
+        )
+        response.raise_for_status()
+        return Response(response=response, data=response.json())
+
+    @require_auth
+    def merge_pull_request(
+        self,
+        owner: str,
+        repo: str,
+        number: int,
+        merge_method: str = "merge",
+        commit_title: str | None = None,
+        commit_message: str | None = None,
+        sha: str | None = None,
+    ) -> Response:
+        """Merge a pull request (``merge_method`` is merge, squash, or rebase)."""
+        payload: dict = {"merge_method": merge_method}
+        if commit_title is not None:
+            payload["commit_title"] = commit_title
+        if commit_message is not None:
+            payload["commit_message"] = commit_message
+        if sha is not None:
+            payload["sha"] = sha
+        response = self._session.put(
+            url=f"{self.url}/repos/{owner}/{repo}/pulls/{number}/merge",
+            json=payload,
+            headers=self.headers,
+            verify=self.verify,
+            proxies=self.proxies,
+        )
+        response.raise_for_status()
+        return Response(response=response, data=response.json())
+
+    @require_auth
+    def request_reviewers(
+        self,
+        owner: str,
+        repo: str,
+        number: int,
+        reviewers: list | None = None,
+        team_reviewers: list | None = None,
+    ) -> Response:
+        """Request individual and/or team reviewers on a pull request."""
+        payload: dict = {}
+        if reviewers is not None:
+            payload["reviewers"] = reviewers
+        if team_reviewers is not None:
+            payload["team_reviewers"] = team_reviewers
+        response = self._session.post(
+            url=f"{self.url}/repos/{owner}/{repo}/pulls/{number}/requested_reviewers",
+            json=payload,
+            headers=self.headers,
+            verify=self.verify,
+            proxies=self.proxies,
+        )
+        response.raise_for_status()
+        try:
+            return Response(response=response, data=PullRequest(**response.json()))
+        except ValidationError as e:
+            raise ParameterError(f"Invalid parameters: {e.errors()}") from e

{github_agent-1.0.2 → github_agent-1.1.0}/github_agent/api/api_client_repos.py

@@ -157,6 +157,18 @@ class Api(BaseApiClient):
         response.raise_for_status()
         return Response(response=response, data={"status": "removed"})
 
+    @require_auth
+    def get_repo_secret_public_key(self, owner: str, repo: str) -> Response:
+        """Get the public key for encrypting repository Actions secrets."""
+        response = self._session.get(
+            url=f"{self.url}/repos/{owner}/{repo}/actions/secrets/public-key",
+            headers=self.headers,
+            verify=self.verify,
+            proxies=self.proxies,
+        )
+        response.raise_for_status()
+        return Response(response=response, data=response.json())
+
     @require_auth
     def get_repo_secrets(self, owner: str, repo: str) -> Response:
         """List repository Actions secrets names."""

{github_agent-1.0.2 → github_agent-1.1.0}/github_agent/api/api_client_workflows.py

@@ -132,3 +132,39 @@ class Api(BaseApiClient):
         )
         response.raise_for_status()
         return Response(response=response, data={"status": "deleted"})
+
+    @require_auth
+    def get_workflow_run_jobs(
+        self, owner: str, repo: str, run_id: int, **kwargs
+    ) -> Response:
+        """List the jobs for a workflow run (optional ``filter``: latest/all)."""
+        response = self._session.get(
+            url=f"{self.url}/repos/{owner}/{repo}/actions/runs/{run_id}/jobs",
+            params=kwargs or None,
+            headers=self.headers,
+            verify=self.verify,
+            proxies=self.proxies,
+        )
+        response.raise_for_status()
+        res_json = response.json()
+        jobs = res_json.get("jobs", []) if isinstance(res_json, dict) else res_json
+        return Response(response=response, data=jobs)
+
+    @require_auth
+    def get_workflow_job_logs(self, owner: str, repo: str, job_id: int) -> Response:
+        """Download the plaintext logs for a single workflow job.
+
+        GitHub answers with a 302 redirect to a short-lived log URL; the session
+        follows it and returns the decoded text.
+        """
+        response = self._session.get(
+            url=f"{self.url}/repos/{owner}/{repo}/actions/jobs/{job_id}/logs",
+            headers=self.headers,
+            verify=self.verify,
+            proxies=self.proxies,
+            allow_redirects=True,
+        )
+        response.raise_for_status()
+        return Response(
+            response=response, data={"job_id": job_id, "logs": response.text}
+        )

github_agent-1.1.0/github_agent/connectors/mcp_source_presets.json

@@ -0,0 +1,18 @@
+{
+  "_comment": "Tier-1 mcp_tool source presets for github-agent (AU-KG.ingest.mcp-tool-connector). Syncs GitHub repositories into the KG as repository documents via the github-agent MCP server. Contributed presets win over the central MCP_TOOL_PRESETS. Extend with pull-request / issue presets as needed.",
+  "github-repositories": {
+    "server": "github-agent",
+    "tool": "github_repos",
+    "action": "list",
+    "records_path": "data",
+    "id_field": "id",
+    "title_field": "full_name",
+    "text_field": "description",
+    "updated_field": "updated_at",
+    "pagination": "page",
+    "page_kind": "page",
+    "page_param": "page",
+    "page_size_param": "per_page",
+    "doc_type": "repository"
+  }
+}

{github_agent-1.0.2 → github_agent-1.1.0}/github_agent/github_gql.py

@@ -50,7 +50,9 @@ class GraphQL:
             verify=verify,
             proxies=proxies,
         )
-        self.client = Client(transport=self.transport, fetch_schema_from_transport=False)
+        self.client = Client(
+            transport=self.transport, fetch_schema_from_transport=False
+        )
 
     @staticmethod
     def _graphql_endpoint(url: str) -> str:
@@ -86,3 +88,40 @@ class GraphQL:
         except Exception as e:
             logging.error(f"GraphQL execution failed: {str(e)}")
             raise ParameterError(f"Query execution failed: {str(e)}") from e
+
+    def enable_pull_request_auto_merge(
+        self, pull_request_id: str, merge_method: str = "MERGE"
+    ) -> dict[str, Any]:
+        """Enable auto-merge on a pull request (no REST equivalent exists).
+
+        ``pull_request_id`` is the PR's GraphQL node id; ``merge_method`` is one
+        of MERGE, SQUASH, or REBASE. Auto-merge queues the PR to merge once its
+        required status checks pass and approvals are satisfied.
+        """
+        mutation = """
+        mutation($pullRequestId: ID!, $mergeMethod: PullRequestMergeMethod!) {
+          enablePullRequestAutoMerge(
+            input: {pullRequestId: $pullRequestId, mergeMethod: $mergeMethod}
+          ) {
+            pullRequest {
+              number
+              autoMergeRequest { enabledAt mergeMethod }
+            }
+          }
+        }
+        """
+        return self.execute_gql(
+            mutation,
+            {"pullRequestId": pull_request_id, "mergeMethod": merge_method.upper()},
+        )
+
+    def disable_pull_request_auto_merge(self, pull_request_id: str) -> dict[str, Any]:
+        """Disable a previously-enabled auto-merge on a pull request (GraphQL)."""
+        mutation = """
+        mutation($pullRequestId: ID!) {
+          disablePullRequestAutoMerge(input: {pullRequestId: $pullRequestId}) {
+            pullRequest { number }
+          }
+        }
+        """
+        return self.execute_gql(mutation, {"pullRequestId": pull_request_id})