@commandable/integration-data 0.0.5 → 0.0.6

package/integrations/github/handlers/create_pull_request_review.js

@@ -0,0 +1,10 @@
+async (input) => {
+  const body = { event: input.event }
+  if (input.body !== undefined) body.body = input.body
+  if (input.commit_id !== undefined) body.commit_id = input.commit_id
+  const res = await integration.fetch(
+    `/repos/${input.owner}/${input.repo}/pulls/${input.pull_number}/reviews`,
+    { method: 'POST', body }
+  )
+  return await res.json()
+}

package/integrations/github/handlers/create_release.js

@@ -0,0 +1,14 @@
+async (input) => {
+  const body = { tag_name: input.tag_name }
+  if (input.name !== undefined) body.name = input.name
+  if (input.body !== undefined) body.body = input.body
+  if (input.draft !== undefined) body.draft = input.draft
+  if (input.prerelease !== undefined) body.prerelease = input.prerelease
+  if (input.target_commitish !== undefined) body.target_commitish = input.target_commitish
+  if (input.generate_release_notes !== undefined) body.generate_release_notes = input.generate_release_notes
+  const res = await integration.fetch(
+    `/repos/${input.owner}/${input.repo}/releases`,
+    { method: 'POST', body }
+  )
+  return await res.json()
+}

package/integrations/github/handlers/delete_branch.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const res = await integration.fetch(
+    `/repos/${input.owner}/${input.repo}/git/refs/heads/${input.branch}`,
+    { method: 'DELETE' }
+  )
+  if (res.status === 204) return { success: true, branch: input.branch }
+  return await res.json()
+}

package/integrations/github/handlers/delete_file.js

@@ -0,0 +1,9 @@
+async (input) => {
+  const body = { message: input.message, sha: input.sha }
+  if (input.branch) body.branch = input.branch
+  const res = await integration.fetch(
+    `/repos/${input.owner}/${input.repo}/contents/${input.path}`,
+    { method: 'DELETE', body }
+  )
+  return await res.json()
+}

package/integrations/github/handlers/fork_repo.js

@@ -0,0 +1,10 @@
+async (input) => {
+  const body = {}
+  if (input.organization) body.organization = input.organization
+  if (input.name) body.name = input.name
+  const res = await integration.fetch(
+    `/repos/${input.owner}/${input.repo}/forks`,
+    { method: 'POST', body }
+  )
+  return await res.json()
+}

package/integrations/github/handlers/get_commit.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/commits/${input.sha}${query}`)
+  return await res.json()
+}

package/integrations/github/handlers/get_file_contents.js

@@ -0,0 +1,21 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.ref) params.set('ref', input.ref)
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/contents/${input.path}${query}`)
+  const data = await res.json()
+  if (data && data.content && data.encoding === 'base64') {
+    try {
+      const b64 = data.content.replace(/\n/g, '')
+      // Decode base64 → binary string → percent-encode each byte → UTF-8 decode
+      data.content = decodeURIComponent(
+        atob(b64).split('').map(c => '%' + ('00' + c.charCodeAt(0).toString(16)).slice(-2)).join('')
+      )
+      data.encoding = 'utf-8'
+    }
+    catch (e) {
+      // Binary file — leave content as base64
+    }
+  }
+  return data
+}

package/integrations/github/handlers/get_job_logs.js

@@ -0,0 +1,6 @@
+async (input) => {
+  // GitHub returns a redirect to the actual log blob URL; fetch follows it automatically
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/actions/jobs/${input.job_id}/logs`)
+  const logs = await res.text()
+  return { logs }
+}

package/integrations/github/handlers/get_latest_release.js

@@ -0,0 +1,4 @@
+async (input) => {
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/releases/latest`)
+  return await res.json()
+}

package/integrations/github/handlers/get_me.js

@@ -0,0 +1,4 @@
+async (input) => {
+  const res = await integration.fetch('/user')
+  return await res.json()
+}

package/integrations/github/handlers/get_pull_request.js

@@ -0,0 +1,4 @@
+async (input) => {
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/pulls/${input.pull_number}`)
+  return await res.json()
+}

package/integrations/github/handlers/get_pull_request_diff.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const res = await integration.fetch(
+    `/repos/${input.owner}/${input.repo}/pulls/${input.pull_number}`,
+    { headers: { 'Accept': 'application/vnd.github.diff' } }
+  )
+  const diff = await res.text()
+  return { diff }
+}

package/integrations/github/handlers/get_repo_tree.js

@@ -0,0 +1,12 @@
+async (input) => {
+  const ref = input.ref || 'HEAD'
+  const params = new URLSearchParams()
+  if (input.recursive !== false) params.set('recursive', '1')
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/git/trees/${ref}${query}`)
+  const data = await res.json()
+  if (input.path_filter && Array.isArray(data.tree)) {
+    data.tree = data.tree.filter((item) => item.path && item.path.startsWith(input.path_filter))
+  }
+  return data
+}

package/integrations/github/handlers/get_workflow_run.js

@@ -0,0 +1,4 @@
+async (input) => {
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/actions/runs/${input.run_id}`)
+  return await res.json()
+}

package/integrations/github/handlers/list_branches.js

@@ -1,4 +1,9 @@
 async (input) => {
-  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/branches`)
+  const params = new URLSearchParams()
+  if (input.protected !== undefined) params.set('protected', String(input.protected))
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/branches${query}`)
   return await res.json()
 }

package/integrations/github/handlers/list_commits.js

@@ -1,11 +1,10 @@
 async (input) => {
   const params = new URLSearchParams()
-  if (input.sha)
-    params.set('sha', input.sha)
-  if (typeof input.path === 'string' && input.path.length > 0)
-    params.set('path', input.path)
-  if (input.author)
-    params.set('author', input.author)
+  if (input.sha) params.set('sha', input.sha)
+  if (typeof input.path === 'string' && input.path.length > 0) params.set('path', input.path)
+  if (input.author) params.set('author', input.author)
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
   const query = params.toString() ? `?${params.toString()}` : ''
   const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/commits${query}`)
   return await res.json()

package/integrations/github/handlers/list_issue_comments.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/issues/${input.issue_number}/comments${query}`)
+  return await res.json()
+}

package/integrations/github/handlers/list_issues.js

@@ -1,11 +1,10 @@
 async (input) => {
   const params = new URLSearchParams()
-  if (input.state)
-    params.set('state', input.state)
-  if (input.labels)
-    params.set('labels', input.labels)
-  if (input.assignee)
-    params.set('assignee', input.assignee)
+  if (input.state) params.set('state', input.state)
+  if (input.labels) params.set('labels', input.labels)
+  if (input.assignee) params.set('assignee', input.assignee)
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
   const query = params.toString() ? `?${params.toString()}` : ''
   const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/issues${query}`)
   return await res.json()

package/integrations/github/handlers/list_labels.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/labels${query}`)
+  return await res.json()
+}

package/integrations/github/handlers/list_pull_request_comments.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/pulls/${input.pull_number}/comments${query}`)
+  return await res.json()
+}

package/integrations/github/handlers/list_pull_request_files.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/pulls/${input.pull_number}/files${query}`)
+  return await res.json()
+}

package/integrations/github/handlers/list_pull_requests.js

@@ -1,7 +1,12 @@
 async (input) => {
   const params = new URLSearchParams()
-  if (input.state)
-    params.set('state', input.state)
+  if (input.state) params.set('state', input.state)
+  if (input.head) params.set('head', input.head)
+  if (input.base) params.set('base', input.base)
+  if (input.sort) params.set('sort', input.sort)
+  if (input.direction) params.set('direction', input.direction)
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
   const query = params.toString() ? `?${params.toString()}` : ''
   const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/pulls${query}`)
   return await res.json()

package/integrations/github/handlers/list_releases.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/releases${query}`)
+  return await res.json()
+}

package/integrations/github/handlers/list_tags.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/tags${query}`)
+  return await res.json()
+}

package/integrations/github/handlers/list_workflow_runs.js

@@ -0,0 +1,11 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.branch) params.set('branch', input.branch)
+  if (input.status) params.set('status', input.status)
+  if (input.event) params.set('event', input.event)
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/actions/runs${query}`)
+  return await res.json()
+}

package/integrations/github/handlers/request_pull_request_reviewers.js

@@ -0,0 +1,10 @@
+async (input) => {
+  const body = {}
+  if (input.reviewers) body.reviewers = input.reviewers
+  if (input.team_reviewers) body.team_reviewers = input.team_reviewers
+  const res = await integration.fetch(
+    `/repos/${input.owner}/${input.repo}/pulls/${input.pull_number}/requested_reviewers`,
+    { method: 'POST', body }
+  )
+  return await res.json()
+}

package/integrations/github/handlers/search_code.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const params = new URLSearchParams()
+  params.set('q', input.query)
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const res = await integration.fetch(`/search/code?${params.toString()}`)
+  return await res.json()
+}

package/integrations/github/handlers/search_issues.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const params = new URLSearchParams()
+  params.set('q', input.query)
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const res = await integration.fetch(`/search/issues?${params.toString()}`)
+  return await res.json()
+}

package/integrations/github/handlers/search_pull_requests.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const params = new URLSearchParams()
+  params.set('q', input.query)
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const res = await integration.fetch(`/search/issues?${params.toString()}`)
+  return await res.json()
+}

package/integrations/github/handlers/search_repos.js

@@ -0,0 +1,10 @@
+async (input) => {
+  const params = new URLSearchParams()
+  params.set('q', input.query)
+  if (input.sort) params.set('sort', input.sort)
+  if (input.order) params.set('order', input.order)
+  if (input.page) params.set('page', String(input.page))
+  if (input.per_page) params.set('per_page', String(input.per_page))
+  const res = await integration.fetch(`/search/repositories?${params.toString()}`)
+  return await res.json()
+}

package/integrations/github/handlers/update_pull_request.js

@@ -0,0 +1,13 @@
+async (input) => {
+  const body = {}
+  if (input.title !== undefined) body.title = input.title
+  if (input.body !== undefined) body.body = input.body
+  if (input.state !== undefined) body.state = input.state
+  if (input.base !== undefined) body.base = input.base
+  if (input.draft !== undefined) body.draft = input.draft
+  const res = await integration.fetch(
+    `/repos/${input.owner}/${input.repo}/pulls/${input.pull_number}`,
+    { method: 'PATCH', body }
+  )
+  return await res.json()
+}

package/integrations/github/manifest.json

@@ -1,26 +1,64 @@
 {
   "name": "github",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "tools": [
+    { "name": "get_me", "description": "Get the authenticated user's profile. Use this to find out who you are authenticated as before performing operations.", "inputSchema": "schemas/empty.json", "handler": "handlers/get_me.js", "scope": "read" },
     { "name": "list_repos", "description": "List repositories for the authenticated user.", "inputSchema": "schemas/empty.json", "handler": "handlers/list_repos_user.js", "scope": "read" },
-    { "name": "get_repo", "description": "Get a repository by owner and name.", "inputSchema": "schemas/get_repo.json", "handler": "handlers/get_repo.js", "scope": "read" },
-    { "name": "list_issues", "description": "List issues for a repository.", "inputSchema": "schemas/list_issues.json", "handler": "handlers/list_issues.js", "scope": "read" },
-    { "name": "get_issue", "description": "Get a specific issue by number.", "inputSchema": "schemas/get_issue.json", "handler": "handlers/get_issue.js", "scope": "read" },
-    { "name": "list_pull_requests", "description": "List pull requests for a repository.", "inputSchema": "schemas/list_pull_requests.json", "handler": "handlers/list_pull_requests.js", "scope": "read" },
-    { "name": "list_branches", "description": "List branches for a repository.", "inputSchema": "schemas/owner_repo.json", "handler": "handlers/list_branches.js", "scope": "read" },
-    { "name": "list_commits", "description": "List commits for a repository.", "inputSchema": "schemas/list_commits.json", "handler": "handlers/list_commits.js", "scope": "read" },
-
-    { "name": "create_repo", "description": "Create a new repository.", "inputSchema": "schemas/create_repo.json", "handler": "handlers/create_repo.js", "scope": "write", "credentialVariants": ["classic_pat"] },
-    { "name": "delete_repo", "description": "Delete a repository (requires delete_repo scope).", "inputSchema": "schemas/delete_repo.json", "handler": "handlers/delete_repo.js", "scope": "write", "credentialVariants": ["classic_pat"] },
-    { "name": "create_branch", "description": "Create a new branch in a repository.", "inputSchema": "schemas/create_branch.json", "handler": "handlers/create_branch.js", "scope": "write" },
-    { "name": "create_or_update_file", "description": "Create or update a single file (content must be plain text; base64 handled internally).", "inputSchema": "schemas/create_or_update_file.json", "handler": "handlers/create_or_update_file.js", "scope": "write" },
-    { "name": "create_commit", "description": "Create a commit with multiple files (content must be plain text; base64 handled internally).", "inputSchema": "schemas/create_commit.json", "handler": "handlers/create_commit.js", "scope": "write" },
-    { "name": "create_pull_request", "description": "Create a pull request.", "inputSchema": "schemas/create_pull_request.json", "handler": "handlers/create_pull_request.js", "scope": "write" },
-    { "name": "merge_pull_request", "description": "Merge a pull request.", "inputSchema": "schemas/merge_pull_request.json", "handler": "handlers/merge_pull_request.js", "scope": "write" },
-    { "name": "create_issue", "description": "Create an issue in a repository.", "inputSchema": "schemas/create_issue.json", "handler": "handlers/create_issue.js", "scope": "write" },
-    { "name": "update_issue", "description": "Update fields on an issue.", "inputSchema": "schemas/update_issue.json", "handler": "handlers/update_issue.js", "scope": "write" },
-    { "name": "comment_on_issue", "description": "Add a comment to an issue.", "inputSchema": "schemas/comment_on_issue.json", "handler": "handlers/comment_on_issue.js", "scope": "write" },
-    { "name": "add_labels_to_issue", "description": "Add labels to an issue or pull request.", "inputSchema": "schemas/add_labels_to_issue.json", "handler": "handlers/add_labels_to_issue.js", "scope": "write" },
-    { "name": "close_issue", "description": "Close an issue.", "inputSchema": "schemas/close_issue.json", "handler": "handlers/close_issue.js", "scope": "write" }
+    { "name": "get_repo", "description": "Get details for a repository (description, default branch, visibility, topics, stats).", "inputSchema": "schemas/get_repo.json", "handler": "handlers/get_repo.js", "scope": "read" },
+    { "name": "search_repos", "description": "Search GitHub repositories. Supports stars, forks, language, topic, and user filters (e.g. 'topic:react stars:>1000 language:javascript'). Use this to discover repos.", "inputSchema": "schemas/search_repos.json", "handler": "handlers/search_repos.js", "scope": "read" },
+
+    { "name": "get_file_contents", "description": "Get the content of a file from a repository. Returns decoded UTF-8 text. Use ref to read from a specific branch, tag, or commit. Call get_repo_tree first to discover file paths.", "inputSchema": "schemas/get_file_contents.json", "handler": "handlers/get_file_contents.js", "scope": "read" },
+    { "name": "get_repo_tree", "description": "Get the full file/directory tree of a repository. Returns all paths and types. Use path_filter to scope to a subdirectory (e.g. 'src/'). Use this before get_file_contents to discover what files exist.", "inputSchema": "schemas/get_repo_tree.json", "handler": "handlers/get_repo_tree.js", "scope": "read" },
+    { "name": "search_code", "description": "Search for code across GitHub repositories using GitHub's code search syntax. Examples: 'useState language:typescript repo:facebook/react', 'console.error path:src/'. Returns file paths and matched fragments.", "inputSchema": "schemas/search_code.json", "handler": "handlers/search_code.js", "scope": "read" },
+
+    { "name": "list_branches", "description": "List branches in a repository. Supports pagination and filtering by protection status.", "inputSchema": "schemas/list_branches.json", "handler": "handlers/list_branches.js", "scope": "read" },
+    { "name": "list_commits", "description": "List commits for a repository. Filter by branch/tag (sha), file path, or author. Paginate with page/per_page.", "inputSchema": "schemas/list_commits.json", "handler": "handlers/list_commits.js", "scope": "read" },
+    { "name": "get_commit", "description": "Get the full details of a specific commit including its message, author, file changes, and diff stats.", "inputSchema": "schemas/get_commit.json", "handler": "handlers/get_commit.js", "scope": "read" },
+    { "name": "list_tags", "description": "List tags for a repository. Use this to see available versions before creating a release.", "inputSchema": "schemas/list_tags.json", "handler": "handlers/list_tags.js", "scope": "read" },
+
+    { "name": "list_issues", "description": "List issues for a repository. Filter by state (open/closed/all), labels (comma-separated), and assignee. Paginate with page/per_page. Note: this also returns pull requests; use search_issues to exclude them.", "inputSchema": "schemas/list_issues.json", "handler": "handlers/list_issues.js", "scope": "read" },
+    { "name": "get_issue", "description": "Get full details of a specific issue including its body, labels, assignees, and milestone.", "inputSchema": "schemas/get_issue.json", "handler": "handlers/get_issue.js", "scope": "read" },
+    { "name": "list_issue_comments", "description": "List all comments on an issue. Use this to read the full discussion thread before replying.", "inputSchema": "schemas/list_issue_comments.json", "handler": "handlers/list_issue_comments.js", "scope": "read" },
+    { "name": "search_issues", "description": "Search issues using GitHub search syntax (e.g. 'is:open is:issue label:bug repo:owner/repo', 'is:issue no:assignee milestone:v2.0'). More powerful than list_issues for finding specific issues.", "inputSchema": "schemas/search_issues.json", "handler": "handlers/search_issues.js", "scope": "read" },
+    { "name": "list_labels", "description": "List all labels available in a repository. Call this before add_labels_to_issue to see which labels exist.", "inputSchema": "schemas/list_labels.json", "handler": "handlers/list_labels.js", "scope": "read" },
+
+    { "name": "list_pull_requests", "description": "List pull requests for a repository. Filter by state, head branch, base branch. Sort and paginate results.", "inputSchema": "schemas/list_pull_requests.json", "handler": "handlers/list_pull_requests.js", "scope": "read" },
+    { "name": "get_pull_request", "description": "Get full details of a specific pull request including title, body, state, merge status, head/base refs, reviewers, and labels.", "inputSchema": "schemas/get_pull_request.json", "handler": "handlers/get_pull_request.js", "scope": "read" },
+    { "name": "get_pull_request_diff", "description": "Get the raw unified diff for a pull request. Returns the complete diff of all changes. For per-file details, use list_pull_request_files instead.", "inputSchema": "schemas/get_pull_request_diff.json", "handler": "handlers/get_pull_request_diff.js", "scope": "read" },
+    { "name": "list_pull_request_files", "description": "List the files changed in a pull request with their status (added/modified/deleted) and patch diff per file. Essential for code review.", "inputSchema": "schemas/list_pull_request_files.json", "handler": "handlers/list_pull_request_files.js", "scope": "read" },
+    { "name": "list_pull_request_comments", "description": "List inline review comments on a pull request (comments attached to specific lines of code).", "inputSchema": "schemas/list_pull_request_comments.json", "handler": "handlers/list_pull_request_comments.js", "scope": "read" },
+    { "name": "search_pull_requests", "description": "Search pull requests using GitHub search syntax. Use 'is:pr' to scope to PRs (e.g. 'is:pr is:open author:octocat', 'is:pr review:required label:bug'). Returns matching PRs across repos.", "inputSchema": "schemas/search_pull_requests.json", "handler": "handlers/search_pull_requests.js", "scope": "read" },
+
+    { "name": "list_releases", "description": "List all releases for a repository, newest first.", "inputSchema": "schemas/list_releases.json", "handler": "handlers/list_releases.js", "scope": "read" },
+    { "name": "get_latest_release", "description": "Get the latest published release for a repository. Use this to quickly check the current version.", "inputSchema": "schemas/owner_repo.json", "handler": "handlers/get_latest_release.js", "scope": "read" },
+
+    { "name": "list_workflow_runs", "description": "List GitHub Actions workflow runs for a repository. Filter by branch, status (e.g. 'failure', 'success'), or triggering event. Use this to check CI status.", "inputSchema": "schemas/list_workflow_runs.json", "handler": "handlers/list_workflow_runs.js", "scope": "read" },
+    { "name": "get_workflow_run", "description": "Get details of a specific GitHub Actions workflow run including its status, conclusion, timing, and associated commit.", "inputSchema": "schemas/get_workflow_run.json", "handler": "handlers/get_workflow_run.js", "scope": "read" },
+    { "name": "get_job_logs", "description": "Get the log output for a specific GitHub Actions workflow job. Use this to diagnose CI failures. Get job_id from the GitHub Actions UI or the jobs list of a workflow run.", "inputSchema": "schemas/get_job_logs.json", "handler": "handlers/get_job_logs.js", "scope": "read" },
+
+    { "name": "create_repo", "description": "Create a new GitHub repository under the authenticated user's account.", "inputSchema": "schemas/create_repo.json", "handler": "handlers/create_repo.js", "scope": "write", "credentialVariants": ["classic_pat"] },
+    { "name": "delete_repo", "description": "Permanently delete a repository. This is irreversible. Requires the delete_repo scope on classic PATs.", "inputSchema": "schemas/delete_repo.json", "handler": "handlers/delete_repo.js", "scope": "write", "credentialVariants": ["classic_pat"] },
+    { "name": "fork_repo", "description": "Fork a repository into your account or an organization. The fork is created asynchronously; the response returns immediately with the new repo details.", "inputSchema": "schemas/fork_repo.json", "handler": "handlers/fork_repo.js", "scope": "write" },
+
+    { "name": "create_branch", "description": "Create a new branch in a repository, branching from the repo's default branch by default.", "inputSchema": "schemas/create_branch.json", "handler": "handlers/create_branch.js", "scope": "write" },
+    { "name": "delete_branch", "description": "Delete a branch. Typically used after a pull request is merged. Use list_branches to find the branch name first.", "inputSchema": "schemas/delete_branch.json", "handler": "handlers/delete_branch.js", "scope": "write" },
+
+    { "name": "create_or_update_file", "description": "Create or update a single file in a repository. Content must be plain text (base64 encoding is handled internally). Provide sha when updating an existing file (get it from get_file_contents).", "inputSchema": "schemas/create_or_update_file.json", "handler": "handlers/create_or_update_file.js", "scope": "write" },
+    { "name": "delete_file", "description": "Delete a file from a repository. Requires the file's blob SHA (get it from get_file_contents). Creates a commit with the deletion.", "inputSchema": "schemas/delete_file.json", "handler": "handlers/delete_file.js", "scope": "write" },
+    { "name": "create_commit", "description": "Create a commit with multiple file changes in a single operation. Supports adding, modifying, and deleting files atomically. Content must be plain text (base64 handled internally). Omit content to delete a file.", "inputSchema": "schemas/create_commit.json", "handler": "handlers/create_commit.js", "scope": "write" },
+
+    { "name": "create_pull_request", "description": "Open a new pull request from a head branch into a base branch.", "inputSchema": "schemas/create_pull_request.json", "handler": "handlers/create_pull_request.js", "scope": "write" },
+    { "name": "update_pull_request", "description": "Edit a pull request's title, body, state (open/closed), base branch, or draft status.", "inputSchema": "schemas/update_pull_request.json", "handler": "handlers/update_pull_request.js", "scope": "write" },
+    { "name": "merge_pull_request", "description": "Merge a pull request. Supports merge, squash, and rebase merge methods.", "inputSchema": "schemas/merge_pull_request.json", "handler": "handlers/merge_pull_request.js", "scope": "write" },
+    { "name": "request_pull_request_reviewers", "description": "Request specific users or teams to review a pull request.", "inputSchema": "schemas/request_pull_request_reviewers.json", "handler": "handlers/request_pull_request_reviewers.js", "scope": "write" },
+    { "name": "create_pull_request_review", "description": "Submit a pull request review. Use event=APPROVE to approve, REQUEST_CHANGES to request changes, or COMMENT to leave a comment-only review.", "inputSchema": "schemas/create_pull_request_review.json", "handler": "handlers/create_pull_request_review.js", "scope": "write" },
+
+    { "name": "create_issue", "description": "Create a new issue in a repository. Optionally assign users and add labels.", "inputSchema": "schemas/create_issue.json", "handler": "handlers/create_issue.js", "scope": "write" },
+    { "name": "update_issue", "description": "Update fields on an existing issue (title, body, state, assignees, labels, milestone).", "inputSchema": "schemas/update_issue.json", "handler": "handlers/update_issue.js", "scope": "write" },
+    { "name": "close_issue", "description": "Close an issue.", "inputSchema": "schemas/close_issue.json", "handler": "handlers/close_issue.js", "scope": "write" },
+    { "name": "comment_on_issue", "description": "Add a comment to an issue or pull request (GitHub PRs share the issue comment thread). Use list_issue_comments to read existing comments first.", "inputSchema": "schemas/comment_on_issue.json", "handler": "handlers/comment_on_issue.js", "scope": "write" },
+    { "name": "add_labels_to_issue", "description": "Add labels to an issue or pull request. Use list_labels to discover available labels before calling this.", "inputSchema": "schemas/add_labels_to_issue.json", "handler": "handlers/add_labels_to_issue.js", "scope": "write" },
+
+    { "name": "create_release", "description": "Create a new release from a tag. Can auto-generate release notes from commits. Set draft=true to save without publishing, prerelease=true for alpha/beta/rc versions.", "inputSchema": "schemas/create_release.json", "handler": "handlers/create_release.js", "scope": "write" }
   ]
 }

package/integrations/github/schemas/create_pull_request_review.json

@@ -0,0 +1,17 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "pull_number": { "type": "integer", "description": "Pull request number" },
+    "event": {
+      "type": "string",
+      "enum": ["APPROVE", "REQUEST_CHANGES", "COMMENT"],
+      "description": "Review action: APPROVE to approve, REQUEST_CHANGES to request changes, COMMENT to leave a comment only"
+    },
+    "body": { "type": "string", "description": "Review summary comment (required when event is REQUEST_CHANGES or COMMENT)" },
+    "commit_id": { "type": "string", "description": "SHA of the commit to review. Defaults to the latest commit on the PR." }
+  },
+  "required": ["owner", "repo", "pull_number", "event"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/create_release.json

@@ -0,0 +1,16 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "tag_name": { "type": "string", "description": "Tag to create the release from (e.g. 'v1.2.0'). The tag must already exist or target_commitish must be provided." },
+    "name": { "type": "string", "description": "Release title (defaults to tag_name)" },
+    "body": { "type": "string", "description": "Release notes in markdown" },
+    "draft": { "type": "boolean", "description": "Create as an unpublished draft release", "default": false },
+    "prerelease": { "type": "boolean", "description": "Mark as a pre-release (alpha, beta, rc, etc.)", "default": false },
+    "target_commitish": { "type": "string", "description": "Branch name or commit SHA to tag from (defaults to the repo's default branch). Required if the tag does not yet exist." },
+    "generate_release_notes": { "type": "boolean", "description": "Auto-generate release notes from commits merged since the previous release", "default": false }
+  },
+  "required": ["owner", "repo", "tag_name"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/delete_branch.json

@@ -0,0 +1,10 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "branch": { "type": "string", "description": "Branch name to delete (e.g. 'feature/my-feature')" }
+  },
+  "required": ["owner", "repo", "branch"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/delete_file.json

@@ -0,0 +1,13 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "path": { "type": "string", "description": "Path of the file to delete (e.g. 'src/old-file.js')" },
+    "message": { "type": "string", "description": "Commit message" },
+    "sha": { "type": "string", "description": "The blob SHA of the file to delete. Obtain this from get_file_contents (the 'sha' field on the response)." },
+    "branch": { "type": "string", "description": "Branch to delete the file from (defaults to the repo's default branch)" }
+  },
+  "required": ["owner", "repo", "path", "message", "sha"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/fork_repo.json

@@ -0,0 +1,11 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner to fork from" },
+    "repo": { "type": "string", "description": "Repository name to fork" },
+    "organization": { "type": "string", "description": "Organization to fork into (defaults to the authenticated user's account)" },
+    "name": { "type": "string", "description": "New name for the forked repository (defaults to the original name)" }
+  },
+  "required": ["owner", "repo"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/get_commit.json

@@ -0,0 +1,12 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "sha": { "type": "string", "description": "Commit SHA, branch name, or tag name" },
+    "page": { "type": "integer", "default": 1, "description": "Page for paginating large diffs (when a commit touches many files)" },
+    "per_page": { "type": "integer", "default": 30, "maximum": 100 }
+  },
+  "required": ["owner", "repo", "sha"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/get_file_contents.json

@@ -0,0 +1,11 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner (user or org)" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "path": { "type": "string", "description": "File path within the repository (e.g. 'src/index.js')" },
+    "ref": { "type": "string", "description": "Branch name, tag, or commit SHA (defaults to the repo's default branch)" }
+  },
+  "required": ["owner", "repo", "path"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/get_job_logs.json

@@ -0,0 +1,10 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "job_id": { "type": "integer", "description": "Workflow job ID. Get this from the 'jobs' field of get_workflow_run, or from the GitHub Actions UI URL." }
+  },
+  "required": ["owner", "repo", "job_id"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/get_pull_request.json

@@ -0,0 +1,10 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "pull_number": { "type": "integer", "description": "Pull request number" }
+  },
+  "required": ["owner", "repo", "pull_number"],
+  "additionalProperties": false
+}