@commandable/integration-data 0.0.6 → 0.1.0

package/integrations/github/handlers/edit_files.js

@@ -0,0 +1,107 @@
+async (input) => {
+  const { owner, repo, branch, message, files } = input
+
+  // Helper: decode base64 GitHub content to UTF-8
+  function decodeContent(b64Raw) {
+    const b64 = b64Raw.replace(/\n/g, '')
+    return decodeURIComponent(
+      atob(b64).split('').map(c => '%' + ('00' + c.charCodeAt(0).toString(16)).slice(-2)).join('')
+    )
+  }
+
+  // Helper: apply search/replace edits to text
+  function applyEdits(text, edits, filePath) {
+    let result = text
+    for (let i = 0; i < edits.length; i++) {
+      const { old_text, new_text } = edits[i]
+      const idx = result.indexOf(old_text)
+      if (idx === -1) {
+        throw new Error(
+          `Edit ${i + 1}/${edits.length} failed on ${filePath}: old_text not found. `
+          + 'Ensure the search text matches exactly, including whitespace and indentation. '
+          + 'Use get_file_contents to verify the current content.'
+        )
+      }
+      result = result.substring(0, idx) + new_text + result.substring(idx + old_text.length)
+    }
+    return result
+  }
+
+  // 1. Get the current commit SHA for the branch
+  const refRes = await integration.fetch(`/repos/${owner}/${repo}/git/refs/heads/${branch}`)
+  const refData = await refRes.json()
+  const currentCommitSha = refData.object.sha
+
+  // 2. Get the current commit to find its tree
+  const commitRes = await integration.fetch(`/repos/${owner}/${repo}/git/commits/${currentCommitSha}`)
+  const commitData = await commitRes.json()
+  const currentTreeSha = commitData.tree.sha
+
+  // 3. Resolve final content for each file
+  const tree = []
+  for (const file of files) {
+    if (file.action === 'delete') {
+      tree.push({ path: file.path, mode: '100644', type: 'blob', sha: null })
+      continue
+    }
+
+    let finalContent
+    if (file.action === 'edit') {
+      if (!file.edits || file.edits.length === 0) {
+        throw new Error(`File ${file.path} has action 'edit' but no edits provided.`)
+      }
+      const params = new URLSearchParams()
+      params.set('ref', branch)
+      const fileRes = await integration.fetch(`/repos/${owner}/${repo}/contents/${file.path}?${params.toString()}`)
+      const fileData = await fileRes.json()
+      if (!fileData || !fileData.content) {
+        throw new Error(`File not found: ${file.path}. Use get_repo_tree to discover file paths.`)
+      }
+      const currentContent = decodeContent(fileData.content)
+      finalContent = applyEdits(currentContent, file.edits, file.path)
+    } else {
+      // action === 'create'
+      if (file.content === undefined || file.content === null) {
+        throw new Error(`File ${file.path} has action 'create' but no content provided.`)
+      }
+      finalContent = file.content
+    }
+
+    // Create blob
+    const blobRes = await integration.fetch(`/repos/${owner}/${repo}/git/blobs`, {
+      method: 'POST',
+      body: { content: finalContent, encoding: 'utf-8' },
+    })
+    const blobData = await blobRes.json()
+    tree.push({ path: file.path, mode: '100644', type: 'blob', sha: blobData.sha })
+  }
+
+  // 4. Create a new tree
+  const treeRes = await integration.fetch(`/repos/${owner}/${repo}/git/trees`, {
+    method: 'POST',
+    body: { base_tree: currentTreeSha, tree: tree },
+  })
+  const treeData = await treeRes.json()
+
+  // 5. Create the commit
+  const newCommitRes = await integration.fetch(`/repos/${owner}/${repo}/git/commits`, {
+    method: 'POST',
+    body: { message: message, tree: treeData.sha, parents: [currentCommitSha] },
+  })
+  const newCommitData = await newCommitRes.json()
+
+  // 6. Update the branch reference
+  await integration.fetch(`/repos/${owner}/${repo}/git/refs/heads/${branch}`, {
+    method: 'PATCH',
+    body: { sha: newCommitData.sha },
+  })
+
+  return {
+    commit: {
+      sha: newCommitData.sha,
+      message: newCommitData.message,
+      url: newCommitData.html_url,
+    },
+    files: files.map(f => ({ path: f.path, action: f.action })),
+  }
+}

package/integrations/github/manifest.json

@@ -1,64 +1,91 @@
 {
   "name": "github",
-  "version": "0.2.0",
+  "version": "0.3.0",
+  "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" },
-    { "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 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_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.", "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" },
-    { "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": "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" },
-    { "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_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" },
-    { "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_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" },
-    { "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_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" },
-    { "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_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" },
-    { "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": "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"] },
-    { "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_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" },
-    { "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_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": "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": "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" },
-    { "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_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" },
-    { "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_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" }
+    { "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/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/delete_file.json

@@ -5,9 +5,9 @@
     "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)." },
+    "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", "sha"],
+  "required": ["owner", "repo", "path", "message"],
   "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/google-calendar/.env.test.example

@@ -0,0 +1,11 @@
+# Google Calendar live integration tests
+# Shared Google credentials live in /.env.test.google — set those up first.
+#
+# Calendar ID to run tests against (defaults to 'primary' if omitted)
+GOOGLE_CALENDAR_TEST_CALENDAR_ID=
+# Set to any non-empty value to enable admin write tests (creates/deletes calendars)
+GOOGLE_CALENDAR_TEST_ADMIN_WRITE=
+# A plain-text quick-add string for the quick_add_event test (e.g. "Lunch tomorrow at noon")
+GOOGLE_CALENDAR_TEST_QUICK_ADD=
+# Calendar ID to use as the move destination in move_event tests
+GOOGLE_CALENDAR_TEST_MOVE_DEST=

package/integrations/google-calendar/README.md

@@ -0,0 +1,41 @@
+# Google Calendar
+
+**17 tools** across 2 toolsets
+
+![Google Calendar tests](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/theomccabe/771bd329f303087690c522afa1baa6f3/raw/test-google-calendar.json)
+
+## Credential variants
+
+| Variant | Label |
+|---|---|
+| `service_account` | Service Account (recommended) _(default)_ |
+| `oauth_token` | OAuth Access Token (short-lived) |
+
+## Toolsets
+
+| Toolset | Description |
+|---|---|
+| `events` | Browse, schedule, and manage calendar events |
+| `sharing` | Control who can access calendars |
+
+## Tools
+
+| Tool | Scope | Toolset | Description |
+|---|---|---|---|
+| `list_calendars` | read | `events` | List all calendars in the authenticated user's calendar list, including the primary calen… |
+| `get_calendar` | read | `events` | Get details for a specific calendar by ID, including its summary, description, timezone, … |
+| `list_events` | read | `events` | List events in a calendar with optional time range, text search, and pagination. Use cale… |
+| `get_event` | read | `events` | Get a specific event by its ID from a calendar. Returns full event details including summ… |
+| `list_colors` | read | `events` | Get the set of color definitions available for calendars and events. Returns colorId valu… |
+| `freebusy_query` | read | `events` | Query free/busy availability for one or more calendars within a time range. Useful for fi… |
+| `list_settings` | read | `events` | List the authenticated user's Google Calendar settings, such as timezone, date format, an… |
+| `create_event` | write | `events` | Create a new event in a calendar. Required fields: calendarId, summary, start, end. Use {… |
+| `patch_event` | write | `events` | Partially update an event by providing only the fields to change. All other fields are pr… |
+| `delete_event` | write | `events` | Delete an event from a calendar. This permanently removes the event. For recurring events… |
+| `move_event` | write | `events` | Move an event from one calendar to another. Provide the source calendarId, eventId, and t… |
+| `quick_add` | write | `events` | Create an event using a natural language text string. Parses the text to extract event de… |
+| `list_acl` | admin | `sharing` | List the Access Control List (ACL) rules for a calendar. Returns rules defining who has a… |
+| `get_acl` | admin | `sharing` | Get a specific ACL rule by its rule ID for a calendar. Use list_acl to find rule IDs. |
+| `insert_acl` | admin | `sharing` | Add a new ACL rule to grant a user or group access to a calendar. Roles: 'reader' (view),… |
+| `update_acl` | admin | `sharing` | Update an existing ACL rule to change a user's or group's permission level on a calendar.… |
+| `delete_acl` | admin | `sharing` | Remove an ACL rule from a calendar, revoking the associated user's or group's access. Use… |

package/integrations/google-calendar/__tests__/write_and_admin_handlers.test.ts

@@ -6,7 +6,7 @@ import { loadIntegrationTools } from '../../../../server/src/integrations/dataLo
 // Required env vars:
 // - Either GOOGLE_TOKEN, OR (GOOGLE_SERVICE_ACCOUNT_JSON + GOOGLE_IMPERSONATE_SUBJECT)
 // Optional:
-// - GCAL_TEST_CALENDAR_ID (defaults to 'primary')
+// - GOOGLE_CALENDAR_TEST_CALENDAR_ID (defaults to 'primary')
 
 interface Ctx {
   calendarId: string
@@ -27,9 +27,9 @@ suite('google-calendar write & admin handlers (live)', () => {
   let buildAdmin: (name: string) => ((input: any) => Promise<any>)
 
   beforeAll(async () => {
-    const { GCAL_TEST_CALENDAR_ID } = env
+    const { GOOGLE_CALENDAR_TEST_CALENDAR_ID } = env
 
-    ctx.calendarId = GCAL_TEST_CALENDAR_ID || 'primary'
+    ctx.calendarId = GOOGLE_CALENDAR_TEST_CALENDAR_ID || 'primary'
 
     const credentialStore = {
       getCredentials: async () => ({
@@ -114,7 +114,7 @@ suite('google-calendar write & admin handlers (live)', () => {
   }, 30000)
 
   it('insert_acl -> get_acl -> update_acl -> delete_acl (admin)', async () => {
-    if (!process.env.GCAL_TEST_ADMIN_WRITE)
+    if (!process.env.GOOGLE_CALENDAR_TEST_ADMIN_WRITE)
       return expect(true).toBe(true)
     const insert_acl = buildAdmin('insert_acl')
     const created = await insert_acl({ calendarId: ctx.calendarId, rule: { scope: { type: 'default' }, role: 'reader' } })
@@ -132,7 +132,7 @@ suite('google-calendar write & admin handlers (live)', () => {
   }, 90000)
 
   it('quick_add creates a simple event', async () => {
-    if (!process.env.GCAL_TEST_QUICK_ADD)
+    if (!process.env.GOOGLE_CALENDAR_TEST_QUICK_ADD)
       return expect(true).toBe(true)
     const quick_add = buildWrite('quick_add')
     const res = await quick_add({ calendarId: ctx.calendarId, text: `Lunch tomorrow ${Date.now()}` })
@@ -140,7 +140,7 @@ suite('google-calendar write & admin handlers (live)', () => {
   }, 60000)
 
   it('move_event moves an event when provided a source event', async () => {
-    if (!process.env.GCAL_TEST_MOVE_DEST)
+    if (!process.env.GOOGLE_CALENDAR_TEST_MOVE_DEST)
       return expect(true).toBe(true)
     const create_event = buildWrite('create_event')
     const now = new Date()
@@ -149,7 +149,7 @@ suite('google-calendar write & admin handlers (live)', () => {
     const eventId = created?.id
     expect(eventId).toBeTruthy()
     const move_event = buildWrite('move_event')
-    const moved = await move_event({ calendarId: ctx.calendarId, eventId, destinationId: process.env.GCAL_TEST_MOVE_DEST })
+    const moved = await move_event({ calendarId: ctx.calendarId, eventId, destinationId: process.env.GOOGLE_CALENDAR_TEST_MOVE_DEST })
     expect(moved?.id).toBeTruthy()
   }, 90000)
 })

package/integrations/google-calendar/credentials.json

@@ -30,7 +30,8 @@
           "Authorization": "Bearer {{token}}"
         }
       },
-      "preprocess": "google_service_account"
+      "preprocess": "google_service_account",
+      "healthCheck": { "path": "/users/me/calendarList?maxResults=1" }
     },
     "oauth_token": {
       "label": "OAuth Access Token (short-lived)",
@@ -50,7 +51,8 @@
         "headers": {
           "Authorization": "Bearer {{token}}"
         }
-      }
+      },
+      "healthCheck": { "path": "/users/me/calendarList?maxResults=1" }
     }
   },
   "default": "service_account"

package/integrations/google-calendar/credentials_hint.md

@@ -2,7 +2,7 @@ Recommended: use a Google service account.
 
 - Create a service account in Google Cloud
 - Download a JSON key
-- Paste the JSON into `serviceAccountJson` (or use `env:GOOGLE_SERVICE_ACCOUNT_JSON`)
+- Paste the JSON into `serviceAccountJson`
 
 Note: Calendar often needs Google Workspace domain-wide delegation if you want to impersonate a user (`subject`).
 For simple setups, use a short-lived OAuth access token in `token`.