matimo-github 0.1.0__py3-none-any.whl

matimo_github/tools/list-code-alerts/definition.yaml

@@ -0,0 +1,85 @@
+name: github-list-code-alerts
+description: List code scanning security alerts 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
+  state:
+    type: string
+    required: false
+    description: Filter by state - open, closed, dismissed, or fixed
+  severity:
+    type: string
+    required: false
+    description: Filter by severity - critical, high, medium, low, warning, note, or error
+  sort:
+    type: string
+    required: false
+    description: Sort by - created or updated
+    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
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.github.com/repos/{owner}/{repo}/code-scanning/alerts'
+  query_params:
+    state: '{state}'
+    severity: '{severity}'
+    sort: '{sort}'
+    direction: '{direction}'
+    per_page: '{per_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
+    required: true
+    permission: Security events read
+    note: Requires GitHub Advanced Security enabled
+
+output_schema:
+  type: array
+  items:
+    type: object
+    description: Code alert object with severity and status
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: List critical security alerts
+    params:
+      owner: myorg
+      repo: myrepo
+      state: open
+      severity: critical
+  - name: List all alerts
+    params:
+      owner: myorg
+      repo: myrepo
+      sort: updated

matimo_github/tools/list-collaborators/definition.yaml

@@ -0,0 +1,77 @@
+name: github-list-collaborators
+description: List collaborators on 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
+  affiliation:
+    type: string
+    required: false
+    description: Filter by affiliation - all, outside, or direct
+    default: all
+  permission:
+    type: string
+    required: false
+    description: Filter by permission - pull, triage, push, maintain, or admin
+  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}/collaborators'
+  query_params:
+    affiliation: '{affiliation}'
+    permission: '{permission}'
+    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
+    required: true
+    permission: Repository metadata read
+
+output_schema:
+  type: array
+  items:
+    type: object
+    description: Collaborator object with permissions
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: List all collaborators
+    params:
+      owner: myorg
+      repo: myrepo
+  - name: List admin collaborators
+    params:
+      owner: myorg
+      repo: myrepo
+      permission: admin

matimo_github/tools/list-commits/definition.yaml

@@ -0,0 +1,81 @@
+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'
+  query_params:
+    sha: '{sha}'
+    path: '{path}'
+    author: '{author}'
+    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

matimo_github/tools/list-issues/definition.yaml

@@ -0,0 +1,96 @@
+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'
+  query_params:
+    state: '{state}'
+    assignee: '{assignee}'
+    labels: '{labels}'
+    sort: '{sort}'
+    direction: '{direction}'
+    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

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

@@ -0,0 +1,93 @@
+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'
+  query_params:
+    state: '{state}'
+    sort: '{sort}'
+    direction: '{direction}'
+    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

matimo_github/tools/list-releases/definition.yaml

@@ -0,0 +1,66 @@
+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'
+  query_params:
+    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

matimo_github/tools/list-repositories/definition.yaml

@@ -0,0 +1,79 @@
+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'
+  query_params:
+    type: '{type}'
+    sort: '{sort}'
+    direction: '{direction}'
+    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

matimo_github/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