@matimo/github 0.1.0-alpha.8

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

@@ -0,0 +1,103 @@
+name: github-create-pull-request
+description: Create a new pull request
+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
+  title:
+    type: string
+    required: true
+    description: Pull request title
+  body:
+    type: string
+    required: false
+    description: Pull request description
+  head:
+    type: string
+    required: true
+    description: Head branch name or user:ref
+  base:
+    type: string
+    required: true
+    description: Base branch name
+  draft:
+    type: boolean
+    required: false
+    description: Whether PR is a draft
+    default: false
+  maintainer_can_modify:
+    type: boolean
+    required: false
+    description: Allow maintainers to edit PR
+    default: true
+
+execution:
+  type: http
+  method: POST
+  url: 'https://api.github.com/repos/{owner}/{repo}/pulls'
+  headers:
+    Accept: application/vnd.github+json
+    Authorization: 'Bearer {GITHUB_TOKEN}'
+    X-GitHub-Api-Version: '2022-11-28'
+    Content-Type: application/json
+  body:
+    title: '{title}'
+    body: '{body}'
+    head: '{head}'
+    base: '{base}'
+    draft: '{draft}'
+    maintainer_can_modify: '{maintainer_can_modify}'
+  timeout: 15000
+
+authentication:
+  type: bearer
+  location: header
+  notes:
+    env: GITHUB_TOKEN
+    required: true
+    permission: Pull requests write
+
+output_schema:
+  type: object
+  properties:
+    id:
+      type: number
+    number:
+      type: number
+    title:
+      type: string
+    state:
+      type: string
+    html_url:
+      type: string
+
+error_handling:
+  retry: 1
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: Create pull request
+    params:
+      owner: myorg
+      repo: myrepo
+      title: Add new feature
+      body: This PR adds support for...
+      head: feature/new-feature
+      base: main
+  - name: Create draft PR
+    params:
+      owner: myorg
+      repo: myrepo
+      title: WIP - Feature in progress
+      head: feature/experimental
+      base: main
+      draft: true

package/tools/create-release/definition.yaml

@@ -0,0 +1,103 @@
+name: github-create-release
+description: Create a new release in a repository
+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
+  tag_name:
+    type: string
+    required: true
+    description: Release tag name (e.g., v1.0.0)
+  name:
+    type: string
+    required: false
+    description: Release name
+  body:
+    type: string
+    required: false
+    description: Release notes/description
+  draft:
+    type: boolean
+    required: false
+    description: Create as draft release
+    default: false
+  prerelease:
+    type: boolean
+    required: false
+    description: Mark as prerelease
+    default: false
+  target_commitish:
+    type: string
+    required: false
+    description: Target branch or commit SHA
+
+execution:
+  type: http
+  method: POST
+  url: 'https://api.github.com/repos/{owner}/{repo}/releases'
+  headers:
+    Accept: application/vnd.github+json
+    Authorization: 'Bearer {GITHUB_TOKEN}'
+    X-GitHub-Api-Version: '2022-11-28'
+    Content-Type: application/json
+  body:
+    tag_name: '{tag_name}'
+    name: '{name}'
+    body: '{body}'
+    draft: '{draft}'
+    prerelease: '{prerelease}'
+    target_commitish: '{target_commitish}'
+  timeout: 15000
+
+authentication:
+  type: bearer
+  location: header
+  notes:
+    env: GITHUB_TOKEN
+    required: true
+    permission: Repository content write
+
+output_schema:
+  type: object
+  properties:
+    id:
+      type: number
+    tag_name:
+      type: string
+    name:
+      type: string
+    draft:
+      type: boolean
+    prerelease:
+      type: boolean
+    html_url:
+      type: string
+
+error_handling:
+  retry: 1
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: Create release
+    params:
+      owner: myorg
+      repo: myrepo
+      tag_name: v1.0.0
+      name: Version 1.0.0
+      body: Initial release with core features
+  - name: Create prerelease
+    params:
+      owner: myorg
+      repo: myrepo
+      tag_name: v2.0.0-beta
+      prerelease: true
+      draft: true

package/tools/create-repository/definition.yaml

@@ -0,0 +1,112 @@
+name: github-create-repository
+description: Create a new repository in an organization or user account
+version: '1.0.0'
+requires_approval: true
+
+parameters:
+  org:
+    type: string
+    required: false
+    description: Organization name (omit for personal repos)
+  name:
+    type: string
+    required: true
+    description: Repository name
+  description:
+    type: string
+    required: false
+    description: Repository description
+  private:
+    type: boolean
+    required: false
+    description: Whether repo is private
+    default: false
+  has_issues:
+    type: boolean
+    required: false
+    description: Enable issues feature
+    default: true
+  has_wiki:
+    type: boolean
+    required: false
+    description: Enable wiki feature
+    default: true
+  has_downloads:
+    type: boolean
+    required: false
+    description: Enable downloads feature
+    default: true
+  auto_init:
+    type: boolean
+    required: false
+    description: Initialize with README, .gitignore, license
+    default: false
+  license_template:
+    type: string
+    required: false
+    description: License template (mit, apache-2.0, etc.)
+  gitignore_template:
+    type: string
+    required: false
+    description: Gitignore template (Node, Python, etc.)
+
+execution:
+  type: http
+  method: POST
+  url: 'https://api.github.com/orgs/{org}/repos'
+  headers:
+    Accept: application/vnd.github+json
+    Authorization: 'Bearer {GITHUB_TOKEN}'
+    X-GitHub-Api-Version: '2022-11-28'
+    Content-Type: application/json
+  body:
+    name: '{name}'
+    description: '{description}'
+    private: '{private}'
+    has_issues: '{has_issues}'
+    has_wiki: '{has_wiki}'
+    auto_init: '{auto_init}'
+    license_template: '{license_template}'
+    gitignore_template: '{gitignore_template}'
+  timeout: 15000
+
+authentication:
+  type: bearer
+  location: header
+  notes:
+    env: GITHUB_TOKEN
+    required: true
+    permission: Repo write
+
+output_schema:
+  type: object
+  properties:
+    id:
+      type: number
+    name:
+      type: string
+    full_name:
+      type: string
+    private:
+      type: boolean
+    html_url:
+      type: string
+
+error_handling:
+  retry: 1
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: Create public repository
+    params:
+      org: myorg
+      name: new-project
+      description: My new project
+  - name: Create private repo with license
+    params:
+      org: myorg
+      name: private-tools
+      private: true
+      license_template: mit
+      auto_init: true

package/tools/delete-repository/definition.yaml

@@ -0,0 +1,51 @@
+name: github-delete-repository
+description: Delete a repository (requires admin access)
+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
+
+execution:
+  type: http
+  method: DELETE
+  url: 'https://api.github.com/repos/{owner}/{repo}'
+  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: Admin (repository deletion/destruction)
+    caution: This is a destructive operation and cannot be undone
+
+output_schema:
+  type: object
+  properties:
+    status:
+      type: number
+      description: HTTP 204 status code on success
+
+error_handling:
+  retry: 1
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: Delete repository
+    params:
+      owner: myorg
+      repo: deprecated-project

package/tools/get-issue/definition.yaml

@@ -0,0 +1,70 @@
+name: github-get-issue
+description: Get details of a specific issue
+version: '1.0.0'
+
+parameters:
+  owner:
+    type: string
+    required: true
+    description: Repository owner username or organization
+  repo:
+    type: string
+    required: true
+    description: Repository name
+  issue_number:
+    type: number
+    required: true
+    description: Issue number
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.github.com/repos/{owner}/{repo}/issues/{issue_number}'
+  headers:
+    Accept: application/vnd.github+json
+    Authorization: 'Bearer {GITHUB_TOKEN}'
+    X-GitHub-Api-Version: '2022-11-28'
+  timeout: 10000
+
+authentication:
+  type: bearer
+  location: header
+  notes:
+    env: GITHUB_TOKEN
+    optional: Public repos don't require authentication
+
+output_schema:
+  type: object
+  properties:
+    id:
+      type: number
+    number:
+      type: number
+    title:
+      type: string
+    body:
+      type: string
+    state:
+      type: string
+    assignees:
+      type: array
+    labels:
+      type: array
+    created_at:
+      type: string
+    updated_at:
+      type: string
+    html_url:
+      type: string
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+examples:
+  - name: Get issue details
+    params:
+      owner: kubernetes
+      repo: kubernetes
+      issue_number: 12345

package/tools/get-repository/definition.yaml

@@ -0,0 +1,83 @@
+name: github-get-repository
+description: Get detailed information about 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
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.github.com/repos/{owner}/{repo}'
+  headers:
+    Accept: application/vnd.github+json
+    Authorization: 'Bearer {GITHUB_TOKEN}'
+    X-GitHub-Api-Version: '2022-11-28'
+  timeout: 10000
+
+authentication:
+  type: bearer
+  location: header
+  notes:
+    env: GITHUB_TOKEN
+    optional: Public repos don't require authentication
+
+output_schema:
+  type: object
+  properties:
+    id:
+      type: number
+    name:
+      type: string
+    full_name:
+      type: string
+    owner:
+      type: object
+    private:
+      type: boolean
+    description:
+      type: string
+    fork:
+      type: boolean
+    created_at:
+      type: string
+    updated_at:
+      type: string
+    pushed_at:
+      type: string
+    homepage:
+      type: string
+    language:
+      type: string
+    stargazers_count:
+      type: number
+    watchers_count:
+      type: number
+    forks_count:
+      type: number
+    open_issues_count:
+      type: number
+    topics:
+      type: array
+    archived:
+      type: boolean
+    disabled:
+      type: boolean
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+examples:
+  - name: Get repository info
+    params:
+      owner: kubernetes
+      repo: kubernetes

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

@@ -0,0 +1,79 @@
+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?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

package/tools/list-collaborators/definition.yaml

@@ -0,0 +1,72 @@
+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?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