@matimo/github 0.1.0-alpha.8

package/tools/list-commits/definition.yaml

@@ -0,0 +1,75 @@
+name: github-list-commits
+description: List commits in a repository
+version: '1.0.0'
+
+parameters:
+  owner:
+    type: string
+    required: true
+    description: Repository owner username or organization
+  repo:
+    type: string
+    required: true
+    description: Repository name
+  sha:
+    type: string
+    required: false
+    description: SHA or branch name (default is main/master)
+  path:
+    type: string
+    required: false
+    description: Only commits modifying this path
+  author:
+    type: string
+    required: false
+    description: Filter by commit author (login or email)
+  per_page:
+    type: number
+    required: false
+    description: Results per page (max 100)
+    default: 30
+  page:
+    type: number
+    required: false
+    description: Page number for pagination
+    default: 1
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.github.com/repos/{owner}/{repo}/commits?per_page={per_page}&page={page}'
+  headers:
+    Accept: application/vnd.github+json
+    Authorization: 'Bearer {GITHUB_TOKEN}'
+    X-GitHub-Api-Version: '2022-11-28'
+  timeout: 15000
+
+authentication:
+  type: bearer
+  location: header
+  notes:
+    env: GITHUB_TOKEN
+    optional: Public repos don't require authentication
+
+output_schema:
+  type: array
+  items:
+    type: object
+    description: Commit object
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: List recent commits
+    params:
+      owner: kubernetes
+      repo: kubernetes
+      sha: main
+  - name: Commits by author
+    params:
+      owner: nodejs
+      repo: node
+      author: torvalds@linux-foundation.org

package/tools/list-issues/definition.yaml

@@ -0,0 +1,88 @@
+name: github-list-issues
+description: List issues in a repository with filtering and sorting options
+version: '1.0.0'
+
+parameters:
+  owner:
+    type: string
+    required: true
+    description: Repository owner username or organization
+  repo:
+    type: string
+    required: true
+    description: Repository name
+  state:
+    type: string
+    required: false
+    description: Filter by state - open, closed, or all
+    default: open
+  assignee:
+    type: string
+    required: false
+    description: Filter by assignee username or 'none' for unassigned
+  labels:
+    type: string
+    required: false
+    description: Comma-separated label names
+  sort:
+    type: string
+    required: false
+    description: Sort by - created, updated, or comments
+    default: created
+  direction:
+    type: string
+    required: false
+    description: Sort direction - asc or desc
+    default: desc
+  per_page:
+    type: number
+    required: false
+    description: Results per page (max 100)
+    default: 30
+  page:
+    type: number
+    required: false
+    description: Page number for pagination
+    default: 1
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.github.com/repos/{owner}/{repo}/issues?state={state}&per_page={per_page}&page={page}'
+  headers:
+    Accept: application/vnd.github+json
+    Authorization: 'Bearer {GITHUB_TOKEN}'
+    X-GitHub-Api-Version: '2022-11-28'
+  timeout: 15000
+
+authentication:
+  type: bearer
+  location: header
+  notes:
+    env: GITHUB_TOKEN
+    scope: Public repos don't require authentication
+    public: Can query without token
+
+output_schema:
+  type: array
+  items:
+    type: object
+    description: Issue object
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: List open issues
+    params:
+      owner: kubernetes
+      repo: kubernetes
+      state: open
+  - name: List issues assigned to user
+    params:
+      owner: nodejs
+      repo: node
+      assignee: username
+      sort: updated

package/tools/list-pull-requests/definition.yaml

@@ -0,0 +1,87 @@
+name: github-list-pull-requests
+description: List pull requests in a repository with filtering and sorting options
+version: '1.0.0'
+
+parameters:
+  owner:
+    type: string
+    required: true
+    description: Repository owner username or organization
+  repo:
+    type: string
+    required: true
+    description: Repository name
+  state:
+    type: string
+    required: false
+    description: Filter by state - open, closed, or all
+    default: open
+  head:
+    type: string
+    required: false
+    description: Filter by head branch (user:ref-name)
+  base:
+    type: string
+    required: false
+    description: Filter by base branch name
+  sort:
+    type: string
+    required: false
+    description: Sort by - created, updated, popularity, or long-running
+    default: created
+  direction:
+    type: string
+    required: false
+    description: Sort direction - asc or desc
+    default: desc
+  per_page:
+    type: number
+    required: false
+    description: Results per page (max 100)
+    default: 30
+  page:
+    type: number
+    required: false
+    description: Page number for pagination
+    default: 1
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.github.com/repos/{owner}/{repo}/pulls?state={state}&per_page={per_page}&page={page}'
+  headers:
+    Accept: application/vnd.github+json
+    Authorization: 'Bearer {GITHUB_TOKEN}'
+    X-GitHub-Api-Version: '2022-11-28'
+  timeout: 15000
+
+authentication:
+  type: bearer
+  location: header
+  notes:
+    env: GITHUB_TOKEN
+    optional: Public repos don't require authentication
+
+output_schema:
+  type: array
+  items:
+    type: object
+    description: Pull request object
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: List open PRs
+    params:
+      owner: kubernetes
+      repo: kubernetes
+      state: open
+  - name: List recently updated PRs
+    params:
+      owner: nodejs
+      repo: node
+      sort: updated
+      direction: desc

package/tools/list-releases/definition.yaml

@@ -0,0 +1,63 @@
+name: github-list-releases
+description: List releases for a repository
+version: '1.0.0'
+
+parameters:
+  owner:
+    type: string
+    required: true
+    description: Repository owner username or organization
+  repo:
+    type: string
+    required: true
+    description: Repository name
+  per_page:
+    type: number
+    required: false
+    description: Results per page (max 100)
+    default: 30
+  page:
+    type: number
+    required: false
+    description: Page number for pagination
+    default: 1
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.github.com/repos/{owner}/{repo}/releases?per_page={per_page}&page={page}'
+  headers:
+    Accept: application/vnd.github+json
+    Authorization: 'Bearer {GITHUB_TOKEN}'
+    X-GitHub-Api-Version: '2022-11-28'
+  timeout: 15000
+
+authentication:
+  type: bearer
+  location: header
+  notes:
+    env: GITHUB_TOKEN
+    optional: Public repos don't require authentication
+
+output_schema:
+  type: array
+  items:
+    type: object
+    description: Release object
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: List all releases
+    params:
+      owner: kubernetes
+      repo: kubernetes
+  - name: List with pagination
+    params:
+      owner: nodejs
+      repo: node
+      per_page: 10
+      page: 2

package/tools/list-repositories/definition.yaml

@@ -0,0 +1,73 @@
+name: github-list-repositories
+description: List repositories for an organization or user with filtering and sorting
+version: '1.0.0'
+
+parameters:
+  owner:
+    type: string
+    required: true
+    description: Organization or user login/username
+  type:
+    type: string
+    required: false
+    description: Filter by type - all, public, private, forks, sources, member
+    default: all
+  sort:
+    type: string
+    required: false
+    description: Sort by - created, updated, pushed, or full_name
+    default: created
+  direction:
+    type: string
+    required: false
+    description: Sort direction - asc or desc
+    default: desc
+  per_page:
+    type: number
+    required: false
+    description: Results per page (max 100)
+    default: 30
+  page:
+    type: number
+    required: false
+    description: Page number for pagination
+    default: 1
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.github.com/orgs/{owner}/repos?type={type}&per_page={per_page}&page={page}'
+  headers:
+    Accept: application/vnd.github+json
+    Authorization: 'Bearer {GITHUB_TOKEN}'
+    X-GitHub-Api-Version: '2022-11-28'
+  timeout: 15000
+
+authentication:
+  type: bearer
+  location: header
+  notes:
+    env: GITHUB_TOKEN
+    optional: Public repos don't require authentication
+
+output_schema:
+  type: array
+  items:
+    type: object
+    description: Repository object
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: List organization repositories
+    params:
+      owner: kubernetes
+      type: all
+      sort: updated
+  - name: List user public repositories
+    params:
+      owner: torvalds
+      type: public

package/tools/merge-pull-request/definition.yaml

@@ -0,0 +1,88 @@
+name: github-merge-pull-request
+description: Merge a pull request into the base branch
+version: '1.0.0'
+requires_approval: true
+
+parameters:
+  owner:
+    type: string
+    required: true
+    description: Repository owner username or organization
+  repo:
+    type: string
+    required: true
+    description: Repository name
+  pull_number:
+    type: number
+    required: true
+    description: Pull request number
+  commit_title:
+    type: string
+    required: false
+    description: Custom commit title
+  commit_message:
+    type: string
+    required: false
+    description: Custom commit message
+  merge_method:
+    type: string
+    required: false
+    description: Merge method - merge, squash, or rebase
+    default: merge
+  sha:
+    type: string
+    required: false
+    description: Expected SHA of the PR head commit (for safety check)
+
+execution:
+  type: http
+  method: PUT
+  url: 'https://api.github.com/repos/{owner}/{repo}/pulls/{pull_number}/merge'
+  headers:
+    Accept: application/vnd.github+json
+    Authorization: 'Bearer {GITHUB_TOKEN}'
+    X-GitHub-Api-Version: '2022-11-28'
+    Content-Type: application/json
+  body:
+    commit_title: '{commit_title}'
+    commit_message: '{commit_message}'
+    merge_method: '{merge_method}'
+    sha: '{sha}'
+  timeout: 15000
+
+authentication:
+  type: bearer
+  location: header
+  notes:
+    env: GITHUB_TOKEN
+    required: true
+    permission: Pull requests write
+
+output_schema:
+  type: object
+  properties:
+    sha:
+      type: string
+      description: Merge commit SHA
+    merged:
+      type: boolean
+    message:
+      type: string
+
+error_handling:
+  retry: 1
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: Merge pull request
+    params:
+      owner: myorg
+      repo: myrepo
+      pull_number: 42
+  - name: Squash merge
+    params:
+      owner: myorg
+      repo: myrepo
+      pull_number: 42
+      merge_method: squash

package/tools/search-code/definition.yaml

@@ -0,0 +1,69 @@
+name: github-search-code
+description: Search for code content across GitHub repositories
+version: '1.0.0'
+
+parameters:
+  query:
+    type: string
+    required: true
+    description: Code search query with qualifiers (e.g., 'className:MyClass repo:owner/repo')
+  sort:
+    type: string
+    required: false
+    description: Sort field - indexed (default)
+    default: indexed
+  order:
+    type: string
+    required: false
+    description: Sort order - asc or desc
+    default: desc
+  per_page:
+    type: number
+    required: false
+    description: Results per page (max 100)
+    default: 30
+  page:
+    type: number
+    required: false
+    description: Page number for pagination
+    default: 1
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.github.com/search/code?q={query}&sort={sort}&order={order}&per_page={per_page}&page={page}'
+  headers:
+    Accept: application/vnd.github+json
+    Authorization: 'Bearer {GITHUB_TOKEN}'
+    X-GitHub-Api-Version: '2022-11-28'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  notes:
+    env: GITHUB_TOKEN
+    rate_limit: 10 req/min authenticated (requires authentication)
+    note: Code search requires authentication and only searches default branch
+
+output_schema:
+  type: object
+  properties:
+    total_count:
+      type: number
+    items:
+      type: array
+      description: Array of code search result objects
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: Find function definitions
+    params:
+      query: 'function handleSubmit repo:facebook/react'
+  - name: Search for configuration files
+    params:
+      query: 'filename:tsconfig.json'

package/tools/search-issues/definition.yaml

@@ -0,0 +1,69 @@
+name: github-search-issues
+description: Search for issues and pull requests across GitHub
+version: '1.0.0'
+
+parameters:
+  query:
+    type: string
+    required: true
+    description: Search query with qualifiers (e.g., 'is:open type:issue repo:owner/repo')
+  sort:
+    type: string
+    required: false
+    description: Sort field - comments, reactions, created, or updated
+    default: created
+  order:
+    type: string
+    required: false
+    description: Sort order - asc or desc
+    default: desc
+  per_page:
+    type: number
+    required: false
+    description: Results per page (max 100)
+    default: 30
+  page:
+    type: number
+    required: false
+    description: Page number for pagination
+    default: 1
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.github.com/search/issues?q={query}&sort={sort}&order={order}&per_page={per_page}&page={page}'
+  headers:
+    Accept: application/vnd.github+json
+    Authorization: 'Bearer {GITHUB_TOKEN}'
+    X-GitHub-Api-Version: '2022-11-28'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  notes:
+    env: GITHUB_TOKEN
+    rate_limit: 30 req/min authenticated
+    scope: Searches both issues and pull requests
+
+output_schema:
+  type: object
+  properties:
+    total_count:
+      type: number
+    items:
+      type: array
+      description: Array of issue/PR objects
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: Find open issues with bug label
+    params:
+      query: 'is:open label:bug type:issue'
+  - name: Find pull requests awaiting review
+    params:
+      query: 'is:open type:pr review:pending'

package/tools/search-repositories/definition.yaml

@@ -0,0 +1,77 @@
+name: github-search-repositories
+description: Search for repositories on GitHub by name, description, topics, or stars
+version: '1.0.0'
+
+parameters:
+  query:
+    type: string
+    required: true
+    description: Search query (e.g., 'language:javascript stars:>1000')
+  sort:
+    type: string
+    required: false
+    description: Sort field - stars, forks, help-wanted-issues, or updated
+    default: stars
+  order:
+    type: string
+    required: false
+    description: Sort order - asc or desc
+    default: desc
+  per_page:
+    type: number
+    required: false
+    description: Results per page (max 100)
+    default: 30
+  page:
+    type: number
+    required: false
+    description: Page number for pagination
+    default: 1
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.github.com/search/repositories?q={query}&sort={sort}&order={order}&per_page={per_page}&page={page}'
+  headers:
+    Accept: application/vnd.github+json
+    Authorization: 'Bearer {GITHUB_TOKEN}'
+    X-GitHub-Api-Version: '2022-11-28'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+  notes:
+    env: GITHUB_TOKEN
+    types: OAuth2 token or Personal Access Token
+    rate_limit: 30 req/min authenticated
+
+output_schema:
+  type: object
+  properties:
+    total_count:
+      type: number
+      description: Total number of matching repositories
+    incomplete_results:
+      type: boolean
+      description: Whether results were truncated
+    items:
+      type: array
+      description: Array of repository objects
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: Search popular JavaScript repos
+    params:
+      query: 'language:javascript stars:>5000'
+      sort: stars
+  - name: Search recently updated Python projects
+    params:
+      query: 'language:python updated:>2024-01-01'
+      sort: updated
+      order: desc