@matimo/github 0.1.0-alpha.8

package/tools/search-users/definition.yaml

@@ -0,0 +1,69 @@
+name: github-search-users
+description: Search for GitHub users by name, location, or follower count
+version: '1.0.0'
+
+parameters:
+  query:
+    type: string
+    required: true
+    description: Search query (e.g., 'location:San Francisco followers:>5000')
+  sort:
+    type: string
+    required: false
+    description: Sort field - followers, repositories, or joined
+    default: followers
+  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/users?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
+    optional: Can be called without authentication (public users only)
+    rate_limit: 30 req/min authenticated
+
+output_schema:
+  type: object
+  properties:
+    total_count:
+      type: number
+    items:
+      type: array
+      description: Array of user objects
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: Find developers in San Francisco
+    params:
+      query: 'location:"San Francisco" followers:>100'
+  - name: Find contributors to TypeScript
+    params:
+      query: 'org:microsoft followers:>50'

package/tools/update-code-alert/definition.yaml

@@ -0,0 +1,86 @@
+name: github-update-code-alert
+description: Update the status of a code scanning security alert
+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
+  alert_number:
+    type: number
+    required: true
+    description: Alert number
+  state:
+    type: string
+    required: true
+    description: New state - open, dismissed, or fixed
+  dismissed_reason:
+    type: string
+    required: false
+    description: If dismissing, the reason - false positive, won't fix, used in tests, etc.
+  dismissed_comment:
+    type: string
+    required: false
+    description: Optional comment when dismissing
+
+execution:
+  type: http
+  method: PATCH
+  url: 'https://api.github.com/repos/{owner}/{repo}/code-scanning/alerts/{alert_number}'
+  headers:
+    Accept: application/vnd.github+json
+    Authorization: 'Bearer {GITHUB_TOKEN}'
+    X-GitHub-Api-Version: '2022-11-28'
+    Content-Type: application/json
+  body:
+    state: '{state}'
+    dismissed_reason: '{dismissed_reason}'
+    dismissed_comment: '{dismissed_comment}'
+  timeout: 15000
+
+authentication:
+  type: bearer
+  location: header
+  notes:
+    env: GITHUB_TOKEN
+    required: true
+    permission: Security events write
+    note: Requires GitHub Advanced Security enabled
+
+output_schema:
+  type: object
+  properties:
+    number:
+      type: number
+    state:
+      type: string
+    dismissed_at:
+      type: string
+    dismissed_reason:
+      type: string
+
+error_handling:
+  retry: 1
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: Dismiss false positive
+    params:
+      owner: myorg
+      repo: myrepo
+      alert_number: 42
+      state: dismissed
+      dismissed_reason: false positive
+  - name: Reopen alert
+    params:
+      owner: myorg
+      repo: myrepo
+      alert_number: 42
+      state: open

package/tools/update-issue/definition.yaml

@@ -0,0 +1,98 @@
+name: github-update-issue
+description: Update an issue - title, body, state, assignees, labels
+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
+  issue_number:
+    type: number
+    required: true
+    description: Issue number
+  title:
+    type: string
+    required: false
+    description: New issue title
+  body:
+    type: string
+    required: false
+    description: New issue body
+  state:
+    type: string
+    required: false
+    description: New state - open or closed
+  assignees:
+    type: array
+    required: false
+    description: Array of usernames to assign
+  labels:
+    type: array
+    required: false
+    description: Array of label names
+
+execution:
+  type: http
+  method: PATCH
+  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'
+    Content-Type: application/json
+  body:
+    title: '{title}'
+    body: '{body}'
+    state: '{state}'
+    assignees: '{assignees}'
+    labels: '{labels}'
+  timeout: 15000
+
+authentication:
+  type: bearer
+  location: header
+  notes:
+    env: GITHUB_TOKEN
+    required: true
+    permission: Issues write
+
+output_schema:
+  type: object
+  properties:
+    id:
+      type: number
+    number:
+      type: number
+    title:
+      type: string
+    state:
+      type: string
+    updated_at:
+      type: string
+
+error_handling:
+  retry: 1
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: Close an issue
+    params:
+      owner: myorg
+      repo: myrepo
+      issue_number: 42
+      state: closed
+  - name: Update issue labels
+    params:
+      owner: myorg
+      repo: myrepo
+      issue_number: 42
+      labels:
+        - fixed
+        - closed