feat: Add get organization members and list all outside collaborators of an organization

[cointem]

This pull request adds two new tools for organization management in the GitHub integration, along with their documentation, implementation, and test coverage. The new tools enable fetching organization members and listing outside collaborators, both with support for pagination and filtering. The changes are grouped into tool additions, documentation updates, and test enhancements.

New organization management tools:

• Added the get_org_members tool, which retrieves members of a specified organization, with support for pagination and filtering by role (all, admin, member). [1] [2]
• Added the list_outside_collaborators tool, which lists users who have access to organization repositories but are not organization members, also supporting pagination. [1] [2]
• Registered both new tools in the default toolset group so they are available for use.

Documentation updates:

• Updated README.md to include usage details for the new get_org_members and list_outside_collaborators tools, including their parameters and descriptions.

Test coverage:

• Added comprehensive unit tests for both new tools, covering successful calls, empty results, client errors, and API errors.

These changes improve the ability to manage and audit organization membership and access via the GitHub integration.

[cointem]

refs #1331

[Copilot]

Pull request overview

This PR adds two new tools for organization management: get_org_members to retrieve organization members with role filtering and pagination, and list_outside_collaborators to list users with repository access who aren't organization members. The implementation follows existing patterns with comprehensive test coverage and documentation updates.

• Adds organization member and outside collaborator listing capabilities
• Includes full test coverage with success and error scenarios
• Updates README and toolsnap schema files

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
pkg/github/context_tools.go	Implements the two new organization tools with pagination support and user data transformation
pkg/github/context_tools_test.go	Adds comprehensive unit tests for both tools covering success, empty results, client errors, and API errors
pkg/github/tools.go	Registers the new tools in the context toolset and refactors type declarations into grouped format
pkg/github/toolsnaps/get_org_members.snap	Documents the API schema for the get_org_members tool
pkg/github/toolsnaps/list_outside_collaborators.snap	Documents the API schema for the list_outside_collaborators tool
README.md	Adds documentation for both new tools in the Context section

[Copilot]

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 6 comments.

[KevinPartingtonTR]

@SamMorrowDrums Any chance you could approve the running of workflows on this PR? And could you or another maintainer please review this PR when you have a chance? It's been sitting since November. Thank you!

[SamMorrowDrums]

@KevinPartingtonTR thanks for the ping, we have to strike a pretty delicate balance for adding new tools, vs keeping context usage low as possible, so we often don't move fast on tool additions.

That said we have new mechanisms available for testing things out, and mentioning the workflows and use-cases you have is most important in convincing us why some tools should be merged over others etc.

Prompts you wish would work and examples like that are also incredibly valuable.