github-agent 2.3.0__py3-none-any.whl → 2.4.0__py3-none-any.whl

github_agent/__init__.py

@@ -1 +1 @@
-__version__ = "2.3.0"
+__version__ = "2.4.0"

github_agent/connectors/mcp_source_presets.json

@@ -2,8 +2,7 @@
   "_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-mcp",
-    "tool": "github_repos",
-    "action": "list",
+    "tool": "github_get_repositories",
     "records_path": "data",
     "id_field": "id",
     "title_field": "full_name",

github_agent/connectors/tool_schema_fingerprints.json

@@ -1,8 +1,8 @@
 {
-  "algorithm": "agent-connector-sdk:mcp-tool-schema-compat:v1",
+  "algorithm": "agent-connector-sdk:mcp-tool-contract-compat:v2",
   "connector": "github-agent",
   "schema_version": "1",
   "tools": {
-    "github_repos": "125cd86b75abcb9a0ac47575ffbdda660260ded083695f69fe9725b3858cd46f"
+    "github_get_repositories": "ec6c06fe206534df752bc4035d4cf81c952d448441a7e9271b800175357c3360"
   }
 }

github_agent/mcp_server.py

@@ -39,7 +39,7 @@ from github_agent.auth import (
 )
 from github_agent.github_response_models import PagesAlreadyEnabled, PagesNotEnabled
 
-__version__ = "2.3.0"
+__version__ = "2.4.0"
 logger = get_logger("GithubMCPServer")
 logger.setLevel(logging.INFO)
 
@@ -3643,7 +3643,14 @@ TOOL_REGISTRY = [
 ]
 
 
-def get_mcp_instance() -> tuple[Any, Any, Any, Any, Any]:
+def get_mcp_instance(
+    *, action_dispatch: bool = False
+) -> tuple[Any, Any, Any, Any, Any]:
+    """Build the server: one tool per GitHub API operation.
+
+    ``action_dispatch=True`` also keeps the condensed ``github_<domain>`` action
+    tools, a compatibility mode that is off by default.
+    """
     load_config()
     args, mcp, middlewares = create_mcp_server(
         name="Github MCP",
@@ -3657,6 +3664,7 @@ def get_mcp_instance() -> tuple[Any, Any, Any, Any, Any]:
         get_client=get_client,
         service="github-agent",
         tool_registry=TOOL_REGISTRY,
+        action_dispatch=action_dispatch,
     )
 
     for mw in middlewares:

github_agent/ontology/certification.json

@@ -1,9 +1,9 @@
 {
   "api_version": "arbora.io/v1",
   "artifacts": {
-    "connector_manifest.yml": "6623b7cb91f43491ee013b45588c98a5dddd975568469541b5e81a3393448c6d",
-    "github_agent/connectors/mcp_source_presets.json": "907153ae71c042156cc521d11d57a8517fd1a332b9cc7738245f2cd57ac3d964",
-    "github_agent/connectors/tool_schema_fingerprints.json": "a91f112bdc54280ccfefe4d475ad51848b94ef668cb6dedaed20ec1404168609",
+    "connector_manifest.yml": "412bbd8242cdac75754d89b9cc1fa81cec7c2f70e2b29f822eca336b1f725f25",
+    "github_agent/connectors/mcp_source_presets.json": "312ec35c48d40253afcd8dba445afee9f41b5ac910e11a435d7c02ee63b5967f",
+    "github_agent/connectors/tool_schema_fingerprints.json": "c80f708a9aac0ec9dd4352be0db40295f203f734b88193ce7f03b6c41f07be6e",
     "github_agent/ontology/fixtures/records.json": "12f5b54b0ae98770f279f99e136788d063340042a9d6ff4bac0c22a886d2dc7b",
     "github_agent/ontology/github.ttl": "ad0ad6d295143b38725866b5b5c59a824f10bfc4219794ac2d9a2274f11bbdb5",
     "github_agent/ontology/mappings/source.yaml": "7ff7a37550f825a61fe6d0f9529206f4efe2727431e32b8ab95a39a32bdced43",

{github_agent-2.3.0.dist-info → github_agent-2.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github-agent
-Version: 2.3.0
+Version: 2.4.0
 Summary: GitHub Agent for MCP
 Author-email: Project Maintainers <maintainers@users.noreply.github.com>
 License: MIT
@@ -14,7 +14,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: gql[requests]>=4.4.0
 Requires-Dist: requests>=2.34.2
-Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.2.1
+Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.3.0
 Provides-Extra: mcp
 Provides-Extra: all
 Provides-Extra: test
@@ -45,7 +45,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: 2.3.0*
+*Version: 2.4.0*
 
 > **Documentation** — Installation, deployment, and usage across the MCP, API, and
 > [official documentation](https://knuckles-team.github.io/github-agent/).

{github_agent-2.3.0.dist-info → github_agent-2.4.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-github_agent/__init__.py,sha256=CpK8IH_dCUAwg9tqv7zm9FxbBFkxCnED1JUiRe7cftU,22
+github_agent/__init__.py,sha256=yLaFvd-K80rs_ClRVYULStijkok4RfYSaanIt_E-aKM,22
 github_agent/__main__.py,sha256=O4Xg__fMvKfUsA6m61pLV56jlYY6EORiLhgDLlp0vJ8,92
 github_agent/api_client.py,sha256=O69YfkXBKyVd59EC8szaMlw3_ZxwEEvsLSvhWlfYnvk,1581
 github_agent/auth.py,sha256=isNd6DYbl_syB_wIbC399d_-157jqH1jqJfDmBn8h-0,4671
@@ -8,7 +8,7 @@ github_agent/github_input_models.py,sha256=yqqPGHb206th736MZvbnxq9F1JRsBUBODNeNV
 github_agent/github_response_models.py,sha256=mllSt0frBgzklUtfuHywJ2Ald3m99So948Xikt3H2Tc,8859
 github_agent/kg_ingest.py,sha256=tMCy8jz8bAEEld_AhTSifdgvSsnBTrp_9DKSmworsuQ,17982
 github_agent/mcp_config.json,sha256=2OOXrwO1sDLyHQqpZwhvDHizPIe3by6YmK4KFE333gI,23
-github_agent/mcp_server.py,sha256=ZUIuawv4bIq3o3G2WPKhlQZ5SBu5EMAQDhV2uTiM0oA,126335
+github_agent/mcp_server.py,sha256=QhaJuYIYBVCAWNFZ9jum0ejPERQgg3PdlLqHSm-oKcI,126620
 github_agent/api/__init__.py,sha256=ntaEPqk-dsAV3HyyDLc2hYpc9nTTyG5CKI-SVDDjc24,27
 github_agent/api/api_client_base.py,sha256=tMXKrZIXg6aQ6OK4kNKBDcNc8BrM0Vml_66SwA5ZgEw,7485
 github_agent/api/api_client_branches.py,sha256=bCmqGUWQ27GFTGxcFkQ7D-ZEltKp6APVsk_Fw9wzdjY,3940
@@ -25,8 +25,8 @@ github_agent/api/api_client_repos.py,sha256=f-gc9xPDp4bp6CYlkaszt7MGhsW21dCw4FD2
 github_agent/api/api_client_search.py,sha256=zWFexkXZYFzDvWackxM33uWdEDYsA54lWlOSf6atLVE,2232
 github_agent/api/api_client_workflows.py,sha256=Y6iHgLujZksI9jAZb1tkFnEv3f-l4bd-fiUtSu3vVw4,5799
 github_agent/connectors/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-github_agent/connectors/mcp_source_presets.json,sha256=kHFTrnHAQhVsxSHRHVeoUX_RozK5zHc4JF8s1XrD2WQ,710
-github_agent/connectors/tool_schema_fingerprints.json,sha256=cJPHoy6aie-DsN6cBkoZghDIXOALgzpziMfMuw9gptg,228
+github_agent/connectors/mcp_source_presets.json,sha256=MS7DXEjUAlOvzY26RFr-6fQbWskQ4RpDXXwC7mO1ln8,699
+github_agent/connectors/tool_schema_fingerprints.json,sha256=yA9wipqsDsndQ1K-DbQClfID9zS4gZPOfwO2xB8Hvm4,241
 github_agent/mcp/__init__.py,sha256=mO-LvCC1TIs-T9f7oDToOq7LsZUMx04Aa3h0LjIi6eA,1290
 github_agent/mcp/mcp_action.py,sha256=oz3CcAMw8Uc_MC7us_pUn4nbwdNqR_ePIjDzckID5Wo,9583
 github_agent/mcp/mcp_branch.py,sha256=lACUOIPRPiLD9lv4DzKJ2n9IvOsq97mHk8lxTat1zWk,4785
@@ -41,7 +41,7 @@ github_agent/mcp/mcp_release.py,sha256=WnuZ2wjcTBVl8Jzog_4a9HjbxDAh6aXdN-mdzDUZt
 github_agent/mcp/mcp_repo.py,sha256=ny5GdawCFZxlbjpOc3ttnn-NIs9QDQLAxRdAWEWLUdc,18344
 github_agent/mcp/mcp_search.py,sha256=3ZBGNKkVu5oBXgN9MBWd-ve4NDCzcwP9sY22bp4hqKs,2963
 github_agent/ontology/__init__.py,sha256=-qc7ZPSgdaCLrD1AH_7TFXWikEpSH9rVmBciCC9gtCY,552
-github_agent/ontology/certification.json,sha256=17Ojwz_F_sHzxwYvNoQHKz1sSVpTD_YKitB-CfFUWoA,1666
+github_agent/ontology/certification.json,sha256=Fisfx2auUAisXHeN8AiNxMj9LHZOoGhqve5baWnSc9I,1666
 github_agent/ontology/github.ttl,sha256=socWm6ST7jnTqZFxurxYdNIY1Ivx6JaW7MiJiX3-onk,9154
 github_agent/ontology/fixtures/records.json,sha256=EvW1Swrph3DyefmeE2eI0GM0AEKp1v9LrAwiqIbS3Hs,543
 github_agent/ontology/mappings/source.yaml,sha256=f_ejdVD4JaYf5tD5UpIG9O_icnQx4yuKuVo5oyvc7UM,533
@@ -92,15 +92,15 @@ github_agent/skills/github-triage-resolver/WORKFLOW.md,sha256=orvcRmaV-qb_JKoGSw
 github_agent/skills/github-triage-resolver/references/resolution-rules.md,sha256=lGPvfLCSHpNIeh2rKWcH2k_2lla3ovgBxzwvtMmyQ-0,4133
 github_agent/skills/github-triage-resolver/scripts/classify_safe.py,sha256=8BhcDF9Q8rjJIEVOmdyO-dO-eHBjW7T-bzaYC16uY5I,9556
 github_agent/skills/github-triage-resolver/scripts/gh_write.py,sha256=SL5oA1A3lFRLepNri4CzEcuEsg9D5WKJ1000fCRKBEM,4125
-github_agent-2.3.0.dist-info/licenses/LICENSE,sha256=5ALbh4fIALWVsUhO7q1nFT1bQb-CL9sWKf7p3GgLEG8,1070
+github_agent-2.4.0.dist-info/licenses/LICENSE,sha256=5ALbh4fIALWVsUhO7q1nFT1bQb-CL9sWKf7p3GgLEG8,1070
 scripts/security_sanitizer.py,sha256=gE65xtYMGx43oYUnK0kozBm73Hx97mCdrQUM7GGzIbk,9449
 scripts/verify_api_integration.py,sha256=3AK8HKW52o1yxCDaEUtXngnh7CjYw6NiG9Eb3EIoXNE,10256
 tests/conftest.py,sha256=kgpOLUp_q8IZaI6Xd7F1tbFuio81-_l5Gd4jaGiMrnY,3636
-tests/test_action_discovery.py,sha256=6PQwXpNBGNaARaao0cUYGVM_Lln9hKqm5oc_Yw9VFkc,5842
+tests/test_action_discovery.py,sha256=Mh8EEr0H2G66zHkK3uobGNlCltCGPX_AyXWh1Im5YfI,6683
 tests/test_api_client_endpoints.py,sha256=Hbw0vssQU5Up-KvJmUDLDCP4t2u8pU-xPfWAhFKymyQ,6582
 tests/test_api_validation.py,sha256=CRZq7kfc1U8CLZJRTGusBhTN2Tlfc1FIeDqIm895XoI,3301
 tests/test_auth_client_edge_cases.py,sha256=QjQAtjd7vDDsSSvIZuUXbd9Z58te8Xp9giPFmwJTBsA,6470
-tests/test_comment_crud.py,sha256=HVFw7lRQ2aeFskyVZ7_djOlwL1m_ZIcLSUIuQbanVmo,27321
+tests/test_comment_crud.py,sha256=mHA0scds_0W0oND-VI0QMvNaYarYkHjiXd4H9-9d5kE,27341
 tests/test_github_agent_api_brute_force_coverage.py,sha256=5jWW6oVU7cmXL2sS3OZ-3gbYGhyjlYPIWqH2rsdF2fw,7347
 tests/test_github_agent_brute_force_coverage.py,sha256=Z_voXtChOYRqaNEmNzMfzvwQMj2xFBn1m8mXx5ubUe8,4849
 tests/test_github_gql.py,sha256=mpn814s9UhN4jnlp1TB8XE3OZ04adR9nhfPM9j0Gpyc,1892
@@ -108,12 +108,12 @@ tests/test_github_http.py,sha256=HcWWZsQ7ATdcWpQCTJdNDJkiwiwgujO4JgjNE1Ls64U,697
 tests/test_hardening.py,sha256=sdlKmtk7B5yncc-r1LuFgoJfro6wNlCqY0xI73IVC4M,3710
 tests/test_init_dynamics.py,sha256=fPE_4M-bONKiqvtWLn12A0q18CUlzQhdx1UoXYkbbPk,1839
 tests/test_kg_ingest.py,sha256=DrTfBlHncZLyrhAWcYyWiVxVOiqI9r8f8gG2CtBJFns,9432
-tests/test_mcp_coverage.py,sha256=cpuqawTm9kTkQpriMqSItiAhEBZpMPXIHi5AwA3efns,43530
+tests/test_mcp_coverage.py,sha256=W_7fbCWoFd4mDwKvah2DmQRcy0fD7tI4ykFTne69tNM,43550
 tests/test_mcp_package_dispatch.py,sha256=mzrC-jGl3DlrQx9z5uIxy1m0x9qsxfMo6eJImx844WY,22993
 tests/test_model_fields.py,sha256=GvVFFedjdL0KBl328-NZ0SM6olv7muiglsMh0Vd59As,3388
-tests/test_org_crud.py,sha256=9eNFHDkovU39ekh2I8XwpRDKTQumVPF4UIuW3MFZw04,19918
-tests/test_pages.py,sha256=0V6-q59Foq5F0nC9WhbNwafdNmd8Xkfp2l5HWC5NABw,18706
-tests/test_repo_secrets_characterization.py,sha256=Nlv8EG7BwRGGl67pqQ0sMQwjeSfEabOwvWELsVJP2Xc,6023
+tests/test_org_crud.py,sha256=7WMb8eCWSsl_rCILBmsJ4OFnmwtb_GXmebf51O8xsxI,19938
+tests/test_pages.py,sha256=CGlxgPVrhvPnnXuFZwzF4VqsV4ygBDY8w8Cqr6KqJmI,18726
+tests/test_repo_secrets_characterization.py,sha256=-9NkJlROsKIYKcNEZpVYy7tkJg-lB0_8We1RvOW1EaY,6043
 tests/test_skill_backlog_build_plan.py,sha256=DdvwgZKQnQ-d_SxErxKoTpjOROuCijr4q7CVAqB82BI,4569
 tests/test_skill_ci_failure_sweep_summarize_runs.py,sha256=lFHXWuIzGHCzHQpBBqF4VSHIfzO6cKVgstZHdXqE7U0,3933
 tests/test_skill_github_tools_fetch_comments.py,sha256=ofB_kQoY8HBbatEjk854lUAm6PGFEDldYQscekmGlYE,3468
@@ -122,8 +122,8 @@ tests/test_skill_org_remediation_classify_fix_risk.py,sha256=0Y8289lhxtJ3pxYUHzO
 tests/test_skill_pr_review_sweep_summarize_prs.py,sha256=NrNaucQvM7K-k1WBcOBKtTGjxJbW16VgTHbC7dSsjm4,3821
 tests/test_skill_triage_resolver_classify_safe.py,sha256=B-aDeVmsKTsxYO8TwMEx-cmpVSmZdlKXw5993Da2ubc,9489
 tests/test_startup.py,sha256=Ix_g69k0tsZbY0-Vkeh8ADWojUdbYwTwwmnM4_hVuCc,1245
-github_agent-2.3.0.dist-info/METADATA,sha256=ZONH8Qc9Mfdsw6WnAU69_OiUw7IH8c5-eGTkZPseGqk,34535
-github_agent-2.3.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-github_agent-2.3.0.dist-info/entry_points.txt,sha256=HGhTmPWGQVM2uJ-RfkiYdIYasr4coyzet1qKhR4AcOg,308
-github_agent-2.3.0.dist-info/top_level.txt,sha256=53Ecr8n7o_EMIqZClc11PBU07uQIggYZOk5WnvBbeOQ,50
-github_agent-2.3.0.dist-info/RECORD,,
+github_agent-2.4.0.dist-info/METADATA,sha256=jEkDUGpzEfBzovgUCRTqyyoo40fsKSiTesubU-GEHqk,34535
+github_agent-2.4.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+github_agent-2.4.0.dist-info/entry_points.txt,sha256=HGhTmPWGQVM2uJ-RfkiYdIYasr4coyzet1qKhR4AcOg,308
+github_agent-2.4.0.dist-info/top_level.txt,sha256=53Ecr8n7o_EMIqZClc11PBU07uQIggYZOk5WnvBbeOQ,50
+github_agent-2.4.0.dist-info/RECORD,,

tests/test_action_discovery.py

@@ -15,7 +15,7 @@ import pytest
 async def _registered_tools():
     from github_agent.mcp_server import get_mcp_instance
 
-    mcp = get_mcp_instance()[0]
+    mcp = get_mcp_instance(action_dispatch=True)[0]
     if inspect.iscoroutinefunction(mcp.list_tools):
         tools = await mcp.list_tools()
     else:
@@ -156,3 +156,22 @@ def test_search_actions_matches_the_if_elif_branches():
     from github_agent import mcp_server
 
     assert set(mcp_server.SEARCH_ACTIONS) == {"repositories", "issues", "code"}
+
+
+@pytest.mark.asyncio
+async def test_default_surface_is_one_tool_per_api_operation():
+    """By default every GitHub client operation is its own typed MCP tool."""
+    from github_agent.mcp_server import get_mcp_instance
+
+    mcp = get_mcp_instance()[0]
+    tools = {tool.name: tool for tool in await mcp.local_provider.list_tools()}
+    operations = {name for name, tool in tools.items() if "operation" in tool.tags}
+    assert len(operations) == 95
+    assert "github_get_repositories" in operations
+    assert not [
+        name
+        for name, tool in tools.items()
+        if name not in operations and "action" in tool.parameters.get("properties", {})
+    ]
+    assert tools["github_delete_repository"].annotations.destructive_hint is True
+    assert tools["github_get_pages"].annotations.read_only_hint is True

tests/test_comment_crud.py

@@ -442,7 +442,7 @@ def make_comment_client():
 async def get_github_comments_tool():
     from github_agent.mcp_server import get_mcp_instance
 
-    mcp = get_mcp_instance()[0]
+    mcp = get_mcp_instance(action_dispatch=True)[0]
     if inspect.iscoroutinefunction(mcp.list_tools):
         tools = await mcp.list_tools()
     else:

tests/test_mcp_coverage.py

@@ -347,7 +347,7 @@ def create_mock_client():
 async def get_registered_tools():
     from github_agent.mcp_server import get_mcp_instance
 
-    mcp_data = get_mcp_instance()
+    mcp_data = get_mcp_instance(action_dispatch=True)
     mcp = mcp_data[0] if isinstance(mcp_data, tuple) else mcp_data
     # FastMCP list_tools can be sync or async
     import inspect

tests/test_org_crud.py

@@ -386,7 +386,7 @@ def make_org_client():
 async def get_github_orgs_tool():
     from github_agent.mcp_server import get_mcp_instance
 
-    mcp = get_mcp_instance()[0]
+    mcp = get_mcp_instance(action_dispatch=True)[0]
     if inspect.iscoroutinefunction(mcp.list_tools):
         tools = await mcp.list_tools()
     else:

tests/test_pages.py

@@ -334,7 +334,7 @@ def make_pages_client():
 async def get_github_repos_tool():
     from github_agent.mcp_server import get_mcp_instance
 
-    mcp = get_mcp_instance()[0]
+    mcp = get_mcp_instance(action_dispatch=True)[0]
     if inspect.iscoroutinefunction(mcp.list_tools):
         tools = await mcp.list_tools()
     else:

tests/test_repo_secrets_characterization.py

@@ -41,7 +41,7 @@ def make_secrets_client():
 async def get_github_repos_tool():
     from github_agent.mcp_server import get_mcp_instance
 
-    mcp = get_mcp_instance()[0]
+    mcp = get_mcp_instance(action_dispatch=True)[0]
     if inspect.iscoroutinefunction(mcp.list_tools):
         tools = await mcp.list_tools()
     else: