@commandable/integration-data 0.4.0 → 0.4.1

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/merge_pull_request.js

@@ -0,0 +1,14 @@
+async (input) => {
+  const body = {
+    commit_title: input.commit_title,
+    commit_message: input.commit_message,
+    merge_method: input.merge_method || 'merge',
+  }
+  
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/pulls/${input.pull_number}/merge`, { 
+    method: 'PUT', 
+    body 
+  })
+  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_issue.js

@@ -0,0 +1,15 @@
+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.assignees !== undefined)
+    body.assignees = input.assignees
+  if (input.labels !== undefined)
+    body.labels = input.labels
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/issues/${input.issue_number}`, { method: 'PATCH', body })
+  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

@@ -0,0 +1,92 @@
+{
+  "name": "github",
+  "version": "0.3.0",
+  "baseUrl": "https://api.github.com",
+  "toolsets": {
+    "code": {
+      "label": "Code & Files",
+      "description": "Read, search, and manage repository code and branches"
+    },
+    "issues": {
+      "label": "Issues",
+      "description": "Create, search, and manage GitHub issues"
+    },
+    "pull_requests": {
+      "label": "Pull Requests",
+      "description": "Create, review, and merge pull requests"
+    },
+    "ci": {
+      "label": "CI / Actions",
+      "description": "Monitor GitHub Actions workflows and debug failures"
+    },
+    "releases": {
+      "label": "Releases & Tags",
+      "description": "Manage releases and view tags"
+    },
+    "repo_admin": {
+      "label": "Repository Management",
+      "description": "Create, delete, fork, and discover repositories"
+    }
+  },
+  "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", "toolset": "repo_admin" },
+    { "name": "list_repos", "description": "List repositories for the authenticated user. Use get_repo for full metadata.", "inputSchema": "schemas/empty.json", "handler": "handlers/list_repos_user.js", "scope": "read", "toolset": "repo_admin" },
+    { "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", "toolset": "code" },
+    { "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", "toolset": "repo_admin" },
+
+    { "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", "toolset": "code" },
+    { "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", "toolset": "code" },
+    { "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", "toolset": "code" },
+
+    { "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", "toolset": "code" },
+    { "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", "toolset": "code" },
+    { "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", "toolset": "code" },
+    { "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", "toolset": "code" },
+
+    { "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", "toolset": "issues" },
+    { "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", "toolset": "issues" },
+    { "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", "toolset": "issues" },
+    { "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", "toolset": "issues" },
+    { "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", "toolset": "issues" },
+
+    { "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", "toolset": "pull_requests" },
+    { "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", "toolset": "pull_requests" },
+    { "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", "toolset": "pull_requests" },
+    { "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", "toolset": "pull_requests" },
+    { "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", "toolset": "pull_requests" },
+    { "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", "toolset": "pull_requests" },
+
+    { "name": "list_releases", "description": "List all releases for a repository, newest first.", "inputSchema": "schemas/list_releases.json", "handler": "handlers/list_releases.js", "scope": "read", "toolset": "releases" },
+    { "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", "toolset": "releases" },
+
+    { "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", "toolset": "ci" },
+    { "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", "toolset": "ci" },
+    { "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", "toolset": "ci" },
+
+    { "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"], "toolset": "repo_admin" },
+    { "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"], "toolset": "repo_admin" },
+    { "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", "toolset": "repo_admin" },
+
+    { "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", "toolset": "code" },
+    { "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", "toolset": "code" },
+
+    { "name": "edit_file", "description": "Edit a file using search/replace. Fetches the file, applies edits, and commits the result. Each old_text must match the file content exactly, including whitespace and indentation. Use get_file_contents to verify content before editing. For multi-file atomic changes, use edit_files instead.", "inputSchema": "schemas/edit_file.json", "handler": "handlers/edit_file.js", "scope": "write", "toolset": "code" },
+    { "name": "edit_files", "description": "Create, edit, and delete multiple files in a single atomic commit. Use action 'create' with content for new files, 'edit' with old_text/new_text search/replace pairs for existing files, 'delete' to remove files. All changes are committed together. For single-file edits, use edit_file instead.", "inputSchema": "schemas/edit_files.json", "handler": "handlers/edit_files.js", "scope": "write", "toolset": "code" },
+    { "name": "create_file", "description": "Create a new file or overwrite an existing file's content in a single commit. Handles SHA resolution internally -- no need to fetch the file first. For partial edits to existing files, use edit_file instead.", "inputSchema": "schemas/create_file.json", "handler": "handlers/create_file.js", "scope": "write", "toolset": "code" },
+    { "name": "delete_file", "description": "Delete a file from a repository. The file's SHA is fetched automatically. Creates a commit with the deletion.", "inputSchema": "schemas/delete_file.json", "handler": "handlers/delete_file.js", "scope": "write", "toolset": "code" },
+
+    { "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", "toolset": "pull_requests" },
+    { "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", "toolset": "pull_requests" },
+    { "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", "toolset": "pull_requests" },
+    { "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", "toolset": "pull_requests" },
+    { "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", "toolset": "pull_requests" },
+
+    { "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", "toolset": "issues" },
+    { "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", "toolset": "issues" },
+    { "name": "close_issue", "description": "Close an issue.", "inputSchema": "schemas/close_issue.json", "handler": "handlers/close_issue.js", "scope": "write", "toolset": "issues" },
+    { "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", "toolset": "issues" },
+    { "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", "toolset": "issues" },
+
+    { "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", "toolset": "releases" }
+  ]
+}

package/integrations/github/prompt.md

@@ -0,0 +1,36 @@
+# GitHub coding workflow
+
+## Branch-based workflow
+
+Always work on a feature branch, never commit directly to main:
+
+1. `create_branch` from the default branch
+2. Make changes with `edit_file`, `edit_files`, `create_file`, or `delete_file` -- each call auto-commits to the branch
+3. `create_pull_request` when done
+4. `merge_pull_request` with `merge_method: "squash"` to collapse all commits into one clean commit on main
+
+Multiple small commits on a feature branch are fine -- they get squash-merged into a single commit.
+
+## Choosing the right write tool
+
+- **`edit_file`** -- Surgical edits to a single existing file. Use for most code changes. Each call is a commit.
+- **`edit_files`** -- Atomic multi-file changes (create + edit + delete in one commit). Use when files must change together to stay consistent (e.g. renaming across files, adding a module + updating imports).
+- **`create_file`** -- Create a new file or completely replace an existing file's content. Use for new files or full rewrites.
+- **`delete_file`** -- Remove a file.
+
+## Search/replace rules for edit_file and edit_files
+
+The `old_text` field must be an **exact match** of the text currently in the file:
+
+- Whitespace matters: spaces, tabs, and indentation must match exactly
+- Line breaks matter: include the exact newline characters
+- Include enough surrounding context to uniquely identify the location
+- Each edit replaces the **first occurrence** only. To replace multiple occurrences, use separate edits.
+
+**Before editing**, call `get_file_contents` to see the file's current content. This avoids failed edits from stale or incorrect assumptions about file content.
+
+## Reading before writing
+
+- Use `get_repo_tree` to discover the project structure and file paths
+- Use `get_file_contents` to read a file before editing it
+- Use `search_code` to find where something is defined or used across the repo

package/integrations/github/schemas/add_labels_to_issue.json

@@ -0,0 +1,12 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "The account owner of the repository" },
+    "repo": { "type": "string", "description": "The name of the repository" },
+    "issue_number": { "type": "number", "description": "The number of the issue" },
+    "labels": { "type": "array", "items": { "type": "string" }, "description": "The names of the labels to add" }
+  },
+  "required": ["owner", "repo", "issue_number", "labels"],
+  "additionalProperties": false
+}
+

package/integrations/github/schemas/close_issue.json

@@ -0,0 +1,10 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string" },
+    "repo": { "type": "string" },
+    "issue_number": { "type": "integer", "minimum": 1 }
+  },
+  "required": ["owner", "repo", "issue_number"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/comment_on_issue.json

@@ -0,0 +1,11 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string" },
+    "repo": { "type": "string" },
+    "issue_number": { "type": "integer", "minimum": 1 },
+    "body": { "type": "string" }
+  },
+  "required": ["owner", "repo", "issue_number", "body"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/create_branch.json

@@ -0,0 +1,12 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "The account owner of the repository" },
+    "repo": { "type": "string", "description": "The name of the repository" },
+    "branch": { "type": "string", "description": "The name of the new branch" },
+    "from_branch": { "type": "string", "description": "The branch to create from. Defaults to the repository's default branch" }
+  },
+  "required": ["owner", "repo", "branch"],
+  "additionalProperties": false
+}
+

package/integrations/github/schemas/create_commit.json

@@ -0,0 +1,25 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "The account owner of the repository" },
+    "repo": { "type": "string", "description": "The name of the repository" },
+    "branch": { "type": "string", "description": "The branch to commit to" },
+    "message": { "type": "string", "description": "The commit message" },
+    "files": {
+      "type": "array",
+      "description": "Array of files to add/update/delete in this commit",
+      "items": {
+        "type": "object",
+        "properties": {
+          "path": { "type": "string", "description": "File path in the repository" },
+          "content": { "type": "string", "description": "Plain text file content (omit to delete). Do NOT base64; encoding handled internally." },
+          "mode": { "type": "string", "enum": ["100644", "100755", "040000", "160000", "120000"], "description": "File mode (100644 for regular files, 100755 for executable)" }
+        },
+        "required": ["path"]
+      }
+    }
+  },
+  "required": ["owner", "repo", "branch", "message", "files"],
+  "additionalProperties": false
+}
+

package/integrations/github/schemas/create_file.json

@@ -0,0 +1,13 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "branch": { "type": "string", "description": "Branch to commit to" },
+    "path": { "type": "string", "description": "File path to create (e.g. 'src/utils/helpers.ts')" },
+    "content": { "type": "string", "description": "Plain text file content" },
+    "message": { "type": "string", "description": "Commit message" }
+  },
+  "required": ["owner", "repo", "branch", "path", "content", "message"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/create_issue.json

@@ -0,0 +1,13 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string" },
+    "repo": { "type": "string" },
+    "title": { "type": "string" },
+    "body": { "type": "string" },
+    "assignees": { "type": "array", "items": { "type": "string" } },
+    "labels": { "type": "array", "items": { "type": "string" } }
+  },
+  "required": ["owner", "repo", "title"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/create_or_update_file.json

@@ -0,0 +1,15 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "The account owner of the repository" },
+    "repo": { "type": "string", "description": "The name of the repository" },
+    "path": { "type": "string", "description": "Path to the file in the repository" },
+    "message": { "type": "string", "description": "The commit message" },
+    "content": { "type": "string", "description": "Plain text file content. Do NOT base64; encoding handled internally." },
+    "branch": { "type": "string", "description": "The branch name. Defaults to the repository's default branch" },
+    "sha": { "type": "string", "description": "Required if updating an existing file. The blob SHA of the file being replaced" }
+  },
+  "required": ["owner", "repo", "path", "message", "content"],
+  "additionalProperties": false
+}
+

package/integrations/github/schemas/create_pull_request.json

@@ -0,0 +1,15 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "The account owner of the repository" },
+    "repo": { "type": "string", "description": "The name of the repository" },
+    "title": { "type": "string", "description": "The title of the pull request" },
+    "body": { "type": "string", "description": "The contents of the pull request" },
+    "head": { "type": "string", "description": "The name of the branch where your changes are implemented" },
+    "base": { "type": "string", "description": "The name of the branch you want the changes pulled into" },
+    "draft": { "type": "boolean", "description": "Whether to create the pull request as a draft" }
+  },
+  "required": ["owner", "repo", "title", "head", "base"],
+  "additionalProperties": false
+}
+

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/create_repo.json

@@ -0,0 +1,12 @@
+{
+  "type": "object",
+  "properties": {
+    "name": { "type": "string", "description": "The name of the repository" },
+    "description": { "type": "string", "description": "A short description of the repository" },
+    "private": { "type": "boolean", "description": "Whether the repository is private", "default": false },
+    "auto_init": { "type": "boolean", "description": "Pass true to create an initial commit with empty README", "default": false }
+  },
+  "required": ["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": "Optional blob SHA. If omitted, the SHA is fetched automatically." },
+    "branch": { "type": "string", "description": "Branch to delete the file from (defaults to the repo's default branch)" }
+  },
+  "required": ["owner", "repo", "path", "message"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/delete_repo.json

@@ -0,0 +1,10 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "The account owner of the repository" },
+    "repo": { "type": "string", "description": "The name of the repository" }
+  },
+  "required": ["owner", "repo"],
+  "additionalProperties": false
+}
+

package/integrations/github/schemas/edit_file.json

@@ -0,0 +1,26 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "branch": { "type": "string", "description": "Branch to commit to" },
+    "path": { "type": "string", "description": "Path of the file to edit (e.g. 'src/index.ts')" },
+    "edits": {
+      "type": "array",
+      "description": "Search/replace operations applied in order. Each old_text must match the file content exactly, including whitespace and indentation.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "old_text": { "type": "string", "description": "Exact text to find in the file" },
+          "new_text": { "type": "string", "description": "Text to replace it with" }
+        },
+        "required": ["old_text", "new_text"],
+        "additionalProperties": false
+      },
+      "minItems": 1
+    },
+    "message": { "type": "string", "description": "Commit message" }
+  },
+  "required": ["owner", "repo", "branch", "path", "edits", "message"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/edit_files.json

@@ -0,0 +1,39 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "branch": { "type": "string", "description": "Branch to commit to" },
+    "message": { "type": "string", "description": "Commit message" },
+    "files": {
+      "type": "array",
+      "description": "Files to create, edit, or delete in this commit",
+      "items": {
+        "type": "object",
+        "properties": {
+          "path": { "type": "string", "description": "File path in the repository" },
+          "action": { "type": "string", "enum": ["create", "edit", "delete"], "description": "'create': new file or overwrite with content. 'edit': apply search/replace edits to existing file. 'delete': remove the file." },
+          "content": { "type": "string", "description": "Full file content (required for 'create' action)" },
+          "edits": {
+            "type": "array",
+            "description": "Search/replace pairs (required for 'edit' action). Each old_text must match exactly, including whitespace.",
+            "items": {
+              "type": "object",
+              "properties": {
+                "old_text": { "type": "string", "description": "Exact text to find" },
+                "new_text": { "type": "string", "description": "Text to replace it with" }
+              },
+              "required": ["old_text", "new_text"],
+              "additionalProperties": false
+            }
+          }
+        },
+        "required": ["path", "action"],
+        "additionalProperties": false
+      },
+      "minItems": 1
+    }
+  },
+  "required": ["owner", "repo", "branch", "message", "files"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/empty.json

@@ -0,0 +1,5 @@
+{
+  "type": "object",
+  "properties": {},
+  "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
+}