github-agent 0.14.0__tar.gz → 0.19.0__tar.gz

{github_agent-0.14.0 → github_agent-0.19.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github-agent
-Version: 0.14.0
+Version: 0.19.0
 Summary: GitHub Agent for MCP
 Author-email: Audel Rouhi <knucklessg1@gmail.com>
 License: MIT
@@ -12,7 +12,7 @@ Classifier: Programming Language :: Python :: 3
 Requires-Python: <3.14,>=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: agent-utilities[agent,logfire]>=0.16.0
+Requires-Dist: agent-utilities[agent,logfire]>=0.26.0
 Provides-Extra: test
 Requires-Dist: pytest-xdist>=3.6.0; extra == "test"
 Requires-Dist: pytest; extra == "test"
@@ -41,7 +41,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: 0.14.0*
+*Version: 0.19.0*
 
 ---
 
@@ -64,7 +64,7 @@ Dynamic: license-file
 
 This agent wraps the GitHub Agent for MCP 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/github-agent/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).
 
 ---
 
@@ -75,14 +75,40 @@ 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 |
 |-------------|----------------|--------------------|------------------------------|
-| **Repo** | `REPOSTOOL` | `True` | Manage GitHub repositories. Action-routed methods: `list`, `get`, `create`, `delete`, `update`. |
-| **Issue** | `ISSUETOOL` | `True` | Manage GitHub issues. Action-routed methods: `list`, `get`, `create`, `update`. |
-| **Pull** | `PULLSTOOL` | `True` | Manage GitHub pull requests. Action-routed methods: `list`, `get`, `create`, `update`. |
-| **Content** | `CONTENTSTOOL` | `True` | Manage GitHub contents. Action-routed methods: `get`, `create`, `update`, `delete`. |
-| **Branch** | `BRANCHESTOOL` | `True` | Manage GitHub branches. Action-routed methods: `list`, `get`, `create`, `delete`. |
-| **Commit** | `COMMITSTOOL` | `True` | Manage GitHub commits. Action-routed methods: `list`, `get`. |
+| **Repo** | `REPO_TOOL` | `True` | Manage GitHub repositories. Action-routed methods: `create`, `delete`, `get`, `list`, `update`. |
+| **Issue** | `ISSUE_TOOL` | `True` | Manage GitHub issues. Action-routed methods: `create`, `get`, `list`, `update`. |
+| **Pull** | `PULL_TOOL` | `True` | Manage GitHub pull requests. Action-routed methods: `create`, `get`, `list`, `update`. |
+| **Content** | `CONTENT_TOOL` | `True` | Manage GitHub contents. Action-routed methods: `create`, `delete`, `get`, `update`. |
+| **Branch** | `BRANCH_TOOL` | `True` | Manage GitHub branches. Action-routed methods: `create`, `delete`, `get`, `list`. |
+| **Commit** | `COMMIT_TOOL` | `True` | Manage GitHub commits. Action-routed methods: `get`, `list`. |
+| **Search** | `SEARCH_TOOL` | `True` | Search GitHub repositories, issues, or code. Action-routed methods: `code`, `issues`, `repositories`. |
+| **Org** | `ORG_TOOL` | `True` | Manage GitHub organizations. Action-routed methods: `members`, `repos`, `teams`. |
+| **Collaborator** | `COLLABORATOR_TOOL` | `True` | Manage repository collaborators. Action-routed methods: `add`, `list`, `remove`. |
+| **Action** | `ACTION_TOOL` | `True` | Manage GitHub actions workflows and runs. Action-routed methods: `cancel`, `delete_run`, `get_run`, `list_runs`, `list_workflows`, `rerun`, `trigger_dispatch`. |
+| **Release** | `RELEASE_TOOL` | `True` | Manage repository releases. Action-routed methods: `create`, `delete`, `get`, `list`, `update`. |
+
+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.
 
-Detailed tool schemas, parameter shapes, and validation constraints are preserved in [docs/mcp.md](file:///home/apps/workspace/agent-packages/agents/github-agent/docs/mcp.md).
+---
 
 ### MCP Configuration Examples
 
@@ -256,7 +282,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/github-agent/docs/agent.md).
+Detailed graph node architecture explanations, custom skill configurations, and agentic trace guides are available in [docs/agent.md](docs/agent.md).
 
 ---
 

{github_agent-0.14.0 → github_agent-0.19.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: 0.14.0*
+*Version: 0.19.0*
 
 ---
 
@@ -43,7 +43,7 @@
 
 This agent wraps the GitHub Agent for MCP 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/github-agent/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,14 +54,40 @@ 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 |
 |-------------|----------------|--------------------|------------------------------|
-| **Repo** | `REPOSTOOL` | `True` | Manage GitHub repositories. Action-routed methods: `list`, `get`, `create`, `delete`, `update`. |
-| **Issue** | `ISSUETOOL` | `True` | Manage GitHub issues. Action-routed methods: `list`, `get`, `create`, `update`. |
-| **Pull** | `PULLSTOOL` | `True` | Manage GitHub pull requests. Action-routed methods: `list`, `get`, `create`, `update`. |
-| **Content** | `CONTENTSTOOL` | `True` | Manage GitHub contents. Action-routed methods: `get`, `create`, `update`, `delete`. |
-| **Branch** | `BRANCHESTOOL` | `True` | Manage GitHub branches. Action-routed methods: `list`, `get`, `create`, `delete`. |
-| **Commit** | `COMMITSTOOL` | `True` | Manage GitHub commits. Action-routed methods: `list`, `get`. |
+| **Repo** | `REPO_TOOL` | `True` | Manage GitHub repositories. Action-routed methods: `create`, `delete`, `get`, `list`, `update`. |
+| **Issue** | `ISSUE_TOOL` | `True` | Manage GitHub issues. Action-routed methods: `create`, `get`, `list`, `update`. |
+| **Pull** | `PULL_TOOL` | `True` | Manage GitHub pull requests. Action-routed methods: `create`, `get`, `list`, `update`. |
+| **Content** | `CONTENT_TOOL` | `True` | Manage GitHub contents. Action-routed methods: `create`, `delete`, `get`, `update`. |
+| **Branch** | `BRANCH_TOOL` | `True` | Manage GitHub branches. Action-routed methods: `create`, `delete`, `get`, `list`. |
+| **Commit** | `COMMIT_TOOL` | `True` | Manage GitHub commits. Action-routed methods: `get`, `list`. |
+| **Search** | `SEARCH_TOOL` | `True` | Search GitHub repositories, issues, or code. Action-routed methods: `code`, `issues`, `repositories`. |
+| **Org** | `ORG_TOOL` | `True` | Manage GitHub organizations. Action-routed methods: `members`, `repos`, `teams`. |
+| **Collaborator** | `COLLABORATOR_TOOL` | `True` | Manage repository collaborators. Action-routed methods: `add`, `list`, `remove`. |
+| **Action** | `ACTION_TOOL` | `True` | Manage GitHub actions workflows and runs. Action-routed methods: `cancel`, `delete_run`, `get_run`, `list_runs`, `list_workflows`, `rerun`, `trigger_dispatch`. |
+| **Release** | `RELEASE_TOOL` | `True` | Manage repository releases. Action-routed methods: `create`, `delete`, `get`, `list`, `update`. |
+
+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.
 
-Detailed tool schemas, parameter shapes, and validation constraints are preserved in [docs/mcp.md](file:///home/apps/workspace/agent-packages/agents/github-agent/docs/mcp.md).
+---
 
 ### MCP Configuration Examples
 
@@ -235,7 +261,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/github-agent/docs/agent.md).
+Detailed graph node architecture explanations, custom skill configurations, and agentic trace guides are available in [docs/agent.md](docs/agent.md).
 
 ---
 

{github_agent-0.14.0 → github_agent-0.19.0}/github_agent/agent_server.py

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

github_agent-0.19.0/github_agent/api/__init__.py

@@ -0,0 +1 @@
+# github_agent.api package

github_agent-0.19.0/github_agent/api/api_client_base.py

@@ -0,0 +1,147 @@
+#!/usr/bin/env python
+import logging
+import re
+from concurrent.futures import ThreadPoolExecutor, as_completed
+from typing import TypeVar
+
+import requests
+import urllib3
+from agent_utilities.base_utilities import get_logger
+from agent_utilities.exceptions import (
+    AuthError,
+    MissingParameterError,
+    UnauthorizedError,
+)
+from pydantic import BaseModel
+
+logger = get_logger(__name__)
+T = TypeVar("T", bound=BaseModel)
+
+
+class BaseApiClient:
+    def __init__(
+        self,
+        url: str | None = "https://api.github.com",
+        token: str | None = None,
+        proxies: dict | None = None,
+        verify: bool = True,
+        debug: bool = False,
+    ):
+        if debug:
+            logger.setLevel(logging.DEBUG)
+        else:
+            logger.setLevel(logging.ERROR)
+
+        if url is None:
+            raise MissingParameterError
+
+        self._session = requests.Session()
+        self.url = url.rstrip("/")
+        self.headers = {
+            "Accept": "application/vnd.github+json",
+            "X-GitHub-Api-Version": "2022-11-28",
+        }
+        self.verify = verify
+        self.proxies = proxies
+        self.debug = debug
+
+        if self.verify is False:
+            urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)
+
+        if token:
+            self.headers["Authorization"] = f"Bearer {token}"
+        else:
+            logger.warning("No token provided for GitHub API")
+
+        try:
+            response = self._session.get(
+                url=f"{self.url}/user",
+                headers=self.headers,
+                verify=self.verify,
+                proxies=self.proxies,
+            )
+            if response.status_code in (401, 403):
+                logger.error(f"Authentication Error: {response.text}")
+                raise AuthError if response.status_code == 401 else UnauthorizedError
+        except requests.exceptions.RequestException as e:
+            logger.error(f"Connection Error: {str(e)}")
+
+    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"""
+        model.page = page  # type: ignore[attr-defined]
+        model.model_post_init(None)
+        response = self._session.get(
+            url=f"{self.url}{endpoint}" if endpoint.startswith("/") else endpoint,
+            params=model.api_parameters,  # type: ignore[attr-defined]
+            headers=header,
+            verify=self.verify,
+            proxies=self.proxies,
+        )
+        response.raise_for_status()
+        page_data = response.json()
+        return page_data if isinstance(page_data, list) else []
+
+    def _get_total_pages(self, response: requests.Response) -> int:
+        """Extract total pages from GitHub Link header"""
+        link = response.headers.get("Link")
+        if not link:
+            return 1
+
+        last_match = re.search(r'page=(\d+)>; rel="last"', link)
+        if last_match:
+            return int(last_match.group(1))
+        return 1
+
+    def _fetch_all_pages(
+        self, endpoint: str, model: T
+    ) -> tuple[requests.Response, list[dict]]:
+        """Generic method to fetch all pages with parallelization if possible"""
+        all_data = []
+
+        initial_url = f"{self.url}{endpoint}" if endpoint.startswith("/") else endpoint
+
+        response = self._session.get(
+            url=initial_url,
+            params=model.api_parameters,  # type: ignore[attr-defined]
+            headers=self.headers,
+            verify=self.verify,
+            proxies=self.proxies,
+        )
+        response.raise_for_status()
+        initial_data = response.json()
+
+        if isinstance(initial_data, list):
+            all_data.extend(initial_data)
+        else:
+            return response, [initial_data]
+
+        total_pages = self._get_total_pages(response)
+
+        max_pages = getattr(model, "max_pages", total_pages)
+        if not max_pages or max_pages == 0 or max_pages > total_pages:
+            max_pages = total_pages
+            model.max_pages = total_pages  # type: ignore[attr-defined]
+
+        if max_pages > 1:
+            with ThreadPoolExecutor(max_workers=5) as executor:
+                futures = []
+                for page in range(2, max_pages + 1):
+                    futures.append(
+                        executor.submit(
+                            self._fetch_next_page,
+                            initial_url,
+                            model,
+                            self.headers,
+                            page,
+                        )
+                    )
+
+                for future in as_completed(futures):
+                    try:
+                        all_data.extend(future.result())
+                    except Exception as e:
+                        logger.error(f"Error fetching page: {str(e)}")
+
+        return response, all_data

github_agent-0.19.0/github_agent/api/api_client_branches.py

@@ -0,0 +1,114 @@
+#!/usr/bin/env python
+from agent_utilities.decorators import require_auth
+from agent_utilities.exceptions import (
+    ParameterError,
+)
+from pydantic import ValidationError
+
+from github_agent.api.api_client_base import BaseApiClient
+from github_agent.github_input_models import (
+    BranchModel,
+)
+from github_agent.github_response_models import (
+    Branch,
+    Response,
+)
+
+
+class Api(BaseApiClient):
+    @require_auth
+    def get_branches(self, **kwargs) -> Response:
+        """List branches for a repository."""
+        model = BranchModel(**kwargs)
+        try:
+            response, data = self._fetch_all_pages(
+                f"/repos/{model.owner}/{model.repo}/branches", model
+            )
+            parsed_data = [Branch(**item) for item in data]
+            return Response(response=response, data=parsed_data)
+        except ValidationError as e:
+            raise ParameterError(f"Invalid parameters: {e.errors()}") from e
+
+    @require_auth
+    def create_branch(self, owner: str, repo: str, branch: str, ref: str) -> Response:
+        """Create a new branch in a repository (using git ref creation)."""
+        try:
+            payload = {"ref": f"refs/heads/{branch}", "sha": ref}
+            response = self._session.post(
+                url=f"{self.url}/repos/{owner}/{repo}/git/refs",
+                json=payload,
+                headers=self.headers,
+                verify=self.verify,
+                proxies=self.proxies,
+            )
+            response.raise_for_status()
+            return Response(response=response, data=response.json())
+        except ValidationError as e:
+            raise ParameterError(f"Invalid parameters: {e.errors()}") from e
+
+    @require_auth
+    def delete_branch(self, owner: str, repo: str, branch: str) -> Response:
+        """Delete a branch in a repository."""
+        response = self._session.delete(
+            url=f"{self.url}/repos/{owner}/{repo}/git/refs/heads/{branch}",
+            headers=self.headers,
+            verify=self.verify,
+            proxies=self.proxies,
+        )
+        response.raise_for_status()
+        return Response(response=response, data={"status": "deleted"})
+
+    @require_auth
+    def get_branch(self, owner: str, repo: str, branch: str) -> Response:
+        """Get a single branch in a repository."""
+        response = self._session.get(
+            url=f"{self.url}/repos/{owner}/{repo}/branches/{branch}",
+            headers=self.headers,
+            verify=self.verify,
+            proxies=self.proxies,
+        )
+        response.raise_for_status()
+        try:
+            parsed_data = Branch(**response.json())
+            return Response(response=response, data=parsed_data)
+        except ValidationError as e:
+            raise ParameterError(f"Invalid parameters: {e.errors()}") from e
+
+    @require_auth
+    def get_branch_protection(self, owner: str, repo: str, branch: str) -> Response:
+        """Get branch protection configuration."""
+        response = self._session.get(
+            url=f"{self.url}/repos/{owner}/{repo}/branches/{branch}/protection",
+            headers=self.headers,
+            verify=self.verify,
+            proxies=self.proxies,
+        )
+        response.raise_for_status()
+        return Response(response=response, data=response.json())
+
+    @require_auth
+    def update_branch_protection(
+        self, owner: str, repo: str, branch: str, protection_config: dict
+    ) -> Response:
+        """Update branch protection configuration."""
+        response = self._session.put(
+            url=f"{self.url}/repos/{owner}/{repo}/branches/{branch}/protection",
+            json=protection_config,
+            headers=self.headers,
+            verify=self.verify,
+            proxies=self.proxies,
+        )
+        response.raise_for_status()
+        return Response(response=response, data=response.json())
+
+    @require_auth
+    def delete_branch_protection(self, owner: str, repo: str, branch: str) -> Response:
+        """Delete branch protection configuration."""
+        response = self._session.delete(
+            url=f"{self.url}/repos/{owner}/{repo}/branches/{branch}/protection",
+            headers=self.headers,
+            verify=self.verify,
+            proxies=self.proxies,
+        )
+        response.raise_for_status()
+        return Response(response=response, data={"status": "protection_deleted"})

github_agent-0.19.0/github_agent/api/api_client_commits.py

@@ -0,0 +1,46 @@
+#!/usr/bin/env python
+from agent_utilities.decorators import require_auth
+from agent_utilities.exceptions import (
+    ParameterError,
+)
+from pydantic import ValidationError
+
+from github_agent.api.api_client_base import BaseApiClient
+from github_agent.github_input_models import (
+    CommitModel,
+)
+from github_agent.github_response_models import (
+    Commit,
+    Response,
+)
+
+
+class Api(BaseApiClient):
+    @require_auth
+    def get_commits(self, **kwargs) -> Response:
+        """List commits for a repository."""
+        model = CommitModel(**kwargs)
+        try:
+            response, data = self._fetch_all_pages(
+                f"/repos/{model.owner}/{model.repo}/commits", model
+            )
+            parsed_data = [Commit(**item) for item in data]
+            return Response(response=response, data=parsed_data)
+        except ValidationError as e:
+            raise ParameterError(f"Invalid parameters: {e.errors()}") from e
+
+    @require_auth
+    def get_commit(self, owner: str, repo: str, sha: str) -> Response:
+        """Get a single commit in a repository."""
+        response = self._session.get(
+            url=f"{self.url}/repos/{owner}/{repo}/commits/{sha}",
+            headers=self.headers,
+            verify=self.verify,
+            proxies=self.proxies,
+        )
+        response.raise_for_status()
+        try:
+            parsed_data = Commit(**response.json())
+            return Response(response=response, data=parsed_data)
+        except ValidationError as e:
+            raise ParameterError(f"Invalid parameters: {e.errors()}") from e

github_agent-0.19.0/github_agent/api/api_client_contents.py

@@ -0,0 +1,112 @@
+#!/usr/bin/env python
+from agent_utilities.decorators import require_auth
+from agent_utilities.exceptions import (
+    ParameterError,
+)
+from pydantic import ValidationError
+
+from github_agent.api.api_client_base import BaseApiClient
+from github_agent.github_input_models import (
+    ContentModel,
+)
+from github_agent.github_response_models import (
+    Content,
+    Response,
+)
+
+
+class Api(BaseApiClient):
+    @require_auth
+    def get_contents(self, **kwargs) -> Response:
+        """Get contents of a file or directory in a repository."""
+        model = ContentModel(**kwargs)
+        try:
+            response = self._session.get(
+                url=f"{self.url}/repos/{model.owner}/{model.repo}/contents/{model.path}",
+                params=model.api_parameters,
+                headers=self.headers,
+                verify=self.verify,
+                proxies=self.proxies,
+            )
+            response.raise_for_status()
+            data = response.json()
+            parsed_data: list[Content] | Content
+            if isinstance(data, list):
+                parsed_data = [Content(**item) for item in data]
+            else:
+                parsed_data = Content(**data)
+            return Response(response=response, data=parsed_data)
+        except ValidationError as e:
+            raise ParameterError(f"Invalid parameters: {e.errors()}") from e
+
+    @require_auth
+    def create_content(
+        self, owner: str, repo: str, path: str, message: str, content: str, **kwargs
+    ) -> Response:
+        """Create a file in a repository."""
+        try:
+            payload = {"message": message, "content": content, **kwargs}
+            response = self._session.put(
+                url=f"{self.url}/repos/{owner}/{repo}/contents/{path}",
+                json=payload,
+                headers=self.headers,
+                verify=self.verify,
+                proxies=self.proxies,
+            )
+            response.raise_for_status()
+            res_json = response.json()
+            if not isinstance(res_json, dict) or "content" not in res_json:
+                raise ParameterError("Invalid parameters: missing 'content' key")
+            parsed_data = Content(**res_json["content"])
+            return Response(response=response, data=parsed_data)
+        except ValidationError as e:
+            raise ParameterError(f"Invalid parameters: {e.errors()}") from e
+
+    @require_auth
+    def update_content(
+        self,
+        owner: str,
+        repo: str,
+        path: str,
+        message: str,
+        content: str,
+        sha: str,
+        **kwargs,
+    ) -> Response:
+        """Update a file in a repository."""
+        try:
+            payload = {"message": message, "content": content, "sha": sha, **kwargs}
+            response = self._session.put(
+                url=f"{self.url}/repos/{owner}/{repo}/contents/{path}",
+                json=payload,
+                headers=self.headers,
+                verify=self.verify,
+                proxies=self.proxies,
+            )
+            response.raise_for_status()
+            res_json = response.json()
+            if not isinstance(res_json, dict) or "content" not in res_json:
+                raise ParameterError("Invalid parameters: missing 'content' key")
+            parsed_data = Content(**res_json["content"])
+            return Response(response=response, data=parsed_data)
+        except ValidationError as e:
+            raise ParameterError(f"Invalid parameters: {e.errors()}") from e
+
+    @require_auth
+    def delete_content(
+        self, owner: str, repo: str, path: str, message: str, sha: str, **kwargs
+    ) -> Response:
+        """Delete a file in a repository."""
+        try:
+            payload = {"message": message, "sha": sha, **kwargs}
+            response = self._session.delete(
+                url=f"{self.url}/repos/{owner}/{repo}/contents/{path}",
+                json=payload,
+                headers=self.headers,
+                verify=self.verify,
+                proxies=self.proxies,
+            )
+            response.raise_for_status()
+            return Response(response=response, data=response.json())
+        except ValidationError as e:
+            raise ParameterError(f"Invalid parameters: {e.errors()}") from e