@commandable/integration-data 0.0.5 → 0.0.7

package/integrations/github/README.md

@@ -0,0 +1,75 @@
+# GitHub
+
+**47 tools** across 6 toolsets
+
+![GitHub tests](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/theomccabe/771bd329f303087690c522afa1baa6f3/raw/test-github.json)
+
+## Credential variants
+
+| Variant | Label |
+|---|---|
+| `classic_pat` | Classic Personal Access Token _(default)_ |
+| `fine_grained_pat` | Fine-Grained Personal Access Token |
+
+## Toolsets
+
+| Toolset | Description |
+|---|---|
+| `code` | Read, search, and manage repository code and branches |
+| `issues` | Create, search, and manage GitHub issues |
+| `pull_requests` | Create, review, and merge pull requests |
+| `ci` | Monitor GitHub Actions workflows and debug failures |
+| `releases` | Manage releases and view tags |
+| `repo_admin` | Create, delete, fork, and discover repositories |
+
+## Tools
+
+| Tool | Scope | Toolset | Description |
+|---|---|---|---|
+| `get_me` | read | `repo_admin` | Get the authenticated user's profile. Use this to find out who you are authenticated as b… |
+| `list_repos` | read | `repo_admin` | List repositories for the authenticated user. |
+| `get_repo` | read | `code` | Get details for a repository (description, default branch, visibility, topics, stats). |
+| `search_repos` | read | `repo_admin` | Search GitHub repositories. Supports stars, forks, language, topic, and user filters (e.g… |
+| `get_file_contents` | read | `code` | Get the content of a file from a repository. Returns decoded UTF-8 text. Use ref to read … |
+| `get_repo_tree` | read | `code` | Get the full file/directory tree of a repository. Returns all paths and types. Use path_f… |
+| `search_code` | read | `code` | Search for code across GitHub repositories using GitHub's code search syntax. Examples: '… |
+| `list_branches` | read | `code` | List branches in a repository. Supports pagination and filtering by protection status. |
+| `list_commits` | read | `code` | List commits for a repository. Filter by branch/tag (sha), file path, or author. Paginate… |
+| `get_commit` | read | `code` | Get the full details of a specific commit including its message, author, file changes, an… |
+| `list_tags` | read | `code` | List tags for a repository. Use this to see available versions before creating a release. |
+| `list_issues` | read | `issues` | List issues for a repository. Filter by state (open/closed/all), labels (comma-separated)… |
+| `get_issue` | read | `issues` | Get full details of a specific issue including its body, labels, assignees, and milestone. |
+| `list_issue_comments` | read | `issues` | List all comments on an issue. Use this to read the full discussion thread before replyin… |
+| `search_issues` | read | `issues` | Search issues using GitHub search syntax (e.g. 'is:open is:issue label:bug repo:owner/rep… |
+| `list_labels` | read | `issues` | List all labels available in a repository. Call this before add_labels_to_issue to see wh… |
+| `list_pull_requests` | read | `pull_requests` | List pull requests for a repository. Filter by state, head branch, base branch. Sort and … |
+| `get_pull_request` | read | `pull_requests` | Get full details of a specific pull request including title, body, state, merge status, h… |
+| `get_pull_request_diff` | read | `pull_requests` | Get the raw unified diff for a pull request. Returns the complete diff of all changes. Fo… |
+| `list_pull_request_files` | read | `pull_requests` | List the files changed in a pull request with their status (added/modified/deleted) and p… |
+| `list_pull_request_comments` | read | `pull_requests` | List inline review comments on a pull request (comments attached to specific lines of cod… |
+| `search_pull_requests` | read | `pull_requests` | Search pull requests using GitHub search syntax. Use 'is:pr' to scope to PRs (e.g. 'is:pr… |
+| `list_releases` | read | `releases` | List all releases for a repository, newest first. |
+| `get_latest_release` | read | `releases` | Get the latest published release for a repository. Use this to quickly check the current … |
+| `list_workflow_runs` | read | `ci` | List GitHub Actions workflow runs for a repository. Filter by branch, status (e.g. 'failu… |
+| `get_workflow_run` | read | `ci` | Get details of a specific GitHub Actions workflow run including its status, conclusion, t… |
+| `get_job_logs` | read | `ci` | Get the log output for a specific GitHub Actions workflow job. Use this to diagnose CI fa… |
+| `create_repo` | write | `repo_admin` | Create a new GitHub repository under the authenticated user's account. |
+| `delete_repo` | write | `repo_admin` | Permanently delete a repository. This is irreversible. Requires the delete_repo scope on … |
+| `fork_repo` | write | `repo_admin` | Fork a repository into your account or an organization. The fork is created asynchronousl… |
+| `create_branch` | write | `code` | Create a new branch in a repository, branching from the repo's default branch by default. |
+| `delete_branch` | write | `code` | Delete a branch. Typically used after a pull request is merged. Use list_branches to find… |
+| `edit_file` | write | `code` | Edit a file using search/replace. Fetches the file, applies edits, and commits the result… |
+| `edit_files` | write | `code` | Create, edit, and delete multiple files in a single atomic commit. Use action 'create' wi… |
+| `create_file` | write | `code` | Create a new file or overwrite an existing file's content in a single commit. Handles SHA… |
+| `delete_file` | write | `code` | Delete a file from a repository. The file's SHA is fetched automatically. Creates a commi… |
+| `create_pull_request` | write | `pull_requests` | Open a new pull request from a head branch into a base branch. |
+| `update_pull_request` | write | `pull_requests` | Edit a pull request's title, body, state (open/closed), base branch, or draft status. |
+| `merge_pull_request` | write | `pull_requests` | Merge a pull request. Supports merge, squash, and rebase merge methods. |
+| `request_pull_request_reviewers` | write | `pull_requests` | Request specific users or teams to review a pull request. |
+| `create_pull_request_review` | write | `pull_requests` | Submit a pull request review. Use event=APPROVE to approve, REQUEST_CHANGES to request ch… |
+| `create_issue` | write | `issues` | Create a new issue in a repository. Optionally assign users and add labels. |
+| `update_issue` | write | `issues` | Update fields on an existing issue (title, body, state, assignees, labels, milestone). |
+| `close_issue` | write | `issues` | Close an issue. |
+| `comment_on_issue` | write | `issues` | Add a comment to an issue or pull request (GitHub PRs share the issue comment thread). Us… |
+| `add_labels_to_issue` | write | `issues` | Add labels to an issue or pull request. Use list_labels to discover available labels befo… |
+| `create_release` | write | `releases` | Create a new release from a tag. Can auto-generate release notes from commits. Set draft=… |

package/integrations/github/__tests__/get_handlers.test.ts

@@ -3,19 +3,19 @@ import { createCredentialStore, createIntegrationNode, createProxy, createToolbo
 
 // LIVE GitHub read tests -- runs once per available credential variant.
 // Required env vars (at least one):
-// - GITHUB_CLASSIC_PAT
-// - GITHUB_FINE_GRAINED_PAT
+// - _GITHUB_CLASSIC_PAT
+// - _GITHUB_FINE_GRAINED_PAT
 
 const env = process.env as Record<string, string | undefined>
 
 interface VariantConfig {
-  key: string
+  key: string 
   token: string
 }
 
 const variants: VariantConfig[] = [
-  { key: 'classic_pat', token: env.GITHUB_CLASSIC_PAT || '' },
-  { key: 'fine_grained_pat', token: env.GITHUB_FINE_GRAINED_PAT || '' },
+  { key: 'classic_pat', token: env._GITHUB_CLASSIC_PAT || '' },
+  { key: 'fine_grained_pat', token: env._GITHUB_FINE_GRAINED_PAT || '' },
 ].filter(v => v.token.trim().length > 0)
 
 const suiteOrSkip = variants.length > 0 ? describe : describe.skip
@@ -27,6 +27,8 @@ suiteOrSkip('github read handlers (live)', () => {
         owner?: string
         repo?: string
         issue_number?: number
+        pull_number?: number
+        commit_sha?: string
       }
 
       const ctx: Ctx = {}
@@ -49,9 +51,25 @@ suiteOrSkip('github read handlers (live)', () => {
           const issues = await list_issues({ owner: ctx.owner, repo: ctx.repo, state: 'all' })
           const firstIssue = Array.isArray(issues) ? issues.find((i: any) => typeof i.number === 'number') : undefined
           ctx.issue_number = firstIssue?.number
+
+          const list_commits = toolbox.read('list_commits')
+          const commits = await list_commits({ owner: ctx.owner, repo: ctx.repo })
+          const firstCommit = Array.isArray(commits) ? commits[0] : undefined
+          ctx.commit_sha = firstCommit?.sha
+
+          const list_pull_requests = toolbox.read('list_pull_requests')
+          const prs = await list_pull_requests({ owner: ctx.owner, repo: ctx.repo, state: 'all' })
+          const firstPr = Array.isArray(prs) ? prs.find((p: any) => typeof p.number === 'number') : undefined
+          ctx.pull_number = firstPr?.number
         }
       }, 60000)
 
+      it('get_me returns authenticated user', async () => {
+        const handler = toolbox.read('get_me')
+        const result = await handler({})
+        expect(result?.login).toBeTruthy()
+      }, 30000)
+
       it('list_repos returns repositories', async () => {
         const handler = toolbox.read('list_repos')
         const result = await handler({})
@@ -66,6 +84,75 @@ suiteOrSkip('github read handlers (live)', () => {
         expect(result?.name?.toLowerCase?.()).toBe(ctx.repo?.toLowerCase?.())
       }, 30000)
 
+      it('search_repos returns repositories', async () => {
+        const handler = toolbox.read('search_repos')
+        const result = await handler({ query: 'commandable-mcp language:typescript' })
+        expect(result?.items).toBeTruthy()
+      }, 30000)
+
+      it('get_repo_tree returns file tree', async () => {
+        if (!ctx.owner || !ctx.repo)
+          return expect(true).toBe(true)
+        const handler = toolbox.read('get_repo_tree')
+        const result = await handler({ owner: ctx.owner, repo: ctx.repo, recursive: true })
+        expect(result?.tree).toBeTruthy()
+        expect(Array.isArray(result.tree)).toBe(true)
+      }, 30000)
+
+      it('get_file_contents returns decoded file content', async () => {
+        if (!ctx.owner || !ctx.repo)
+          return expect(true).toBe(true)
+        // Find a known small text file (README is common)
+        const handler = toolbox.read('get_file_contents')
+        const result = await handler({ owner: ctx.owner, repo: ctx.repo, path: 'README.md' })
+        // It's OK if there's no README — just check for a usable response shape
+        if (result?.message === 'Not Found')
+          return expect(true).toBe(true)
+        expect(result?.path).toBe('README.md')
+        expect(result?.encoding).toBe('utf-8')
+        expect(typeof result?.content).toBe('string')
+      }, 30000)
+
+      it('search_code returns results', async () => {
+        if (!ctx.owner || !ctx.repo)
+          return expect(true).toBe(true)
+        const handler = toolbox.read('search_code')
+        const result = await handler({ query: `repo:${ctx.owner}/${ctx.repo}` })
+        expect(result?.items).toBeTruthy()
+      }, 30000)
+
+      it('list_branches returns branches with pagination', async () => {
+        if (!ctx.owner || !ctx.repo)
+          return expect(true).toBe(true)
+        const handler = toolbox.read('list_branches')
+        const result = await handler({ owner: ctx.owner, repo: ctx.repo, per_page: 10 })
+        expect(Array.isArray(result)).toBe(true)
+      }, 30000)
+
+      it('list_commits returns commits with pagination', async () => {
+        if (!ctx.owner || !ctx.repo)
+          return expect(true).toBe(true)
+        const handler = toolbox.read('list_commits')
+        const result = await handler({ owner: ctx.owner, repo: ctx.repo, per_page: 5 })
+        expect(Array.isArray(result)).toBe(true)
+      }, 30000)
+
+      it('get_commit returns commit details', async () => {
+        if (!ctx.owner || !ctx.repo || !ctx.commit_sha)
+          return expect(true).toBe(true)
+        const handler = toolbox.read('get_commit')
+        const result = await handler({ owner: ctx.owner, repo: ctx.repo, sha: ctx.commit_sha })
+        expect(result?.sha).toBe(ctx.commit_sha)
+      }, 30000)
+
+      it('list_tags returns tags', async () => {
+        if (!ctx.owner || !ctx.repo)
+          return expect(true).toBe(true)
+        const handler = toolbox.read('list_tags')
+        const result = await handler({ owner: ctx.owner, repo: ctx.repo })
+        expect(Array.isArray(result)).toBe(true)
+      }, 30000)
+
       it('list_issues returns issues for repo', async () => {
         if (!ctx.owner || !ctx.repo)
           return expect(true).toBe(true)
@@ -82,28 +169,136 @@ suiteOrSkip('github read handlers (live)', () => {
         expect(result?.number).toBe(ctx.issue_number)
       }, 30000)
 
-      it('list_pull_requests returns PRs', async () => {
+      it('list_issue_comments returns comments array', async () => {
+        if (!ctx.owner || !ctx.repo || !ctx.issue_number)
+          return expect(true).toBe(true)
+        const handler = toolbox.read('list_issue_comments')
+        const result = await handler({ owner: ctx.owner, repo: ctx.repo, issue_number: ctx.issue_number })
+        expect(Array.isArray(result)).toBe(true)
+      }, 30000)
+
+      it('search_issues returns results', async () => {
+        if (!ctx.owner || !ctx.repo)
+          return expect(true).toBe(true)
+        const handler = toolbox.read('search_issues')
+        const result = await handler({ query: `is:issue repo:${ctx.owner}/${ctx.repo}` })
+        expect(result?.items).toBeTruthy()
+      }, 30000)
+
+      it('list_labels returns labels array', async () => {
+        if (!ctx.owner || !ctx.repo)
+          return expect(true).toBe(true)
+        const handler = toolbox.read('list_labels')
+        const result = await handler({ owner: ctx.owner, repo: ctx.repo })
+        expect(Array.isArray(result)).toBe(true)
+      }, 30000)
+
+      it('list_pull_requests returns PRs with pagination', async () => {
         if (!ctx.owner || !ctx.repo)
           return expect(true).toBe(true)
         const handler = toolbox.read('list_pull_requests')
-        const result = await handler({ owner: ctx.owner, repo: ctx.repo, state: 'all' })
+        const result = await handler({ owner: ctx.owner, repo: ctx.repo, state: 'all', per_page: 5 })
+        expect(Array.isArray(result)).toBe(true)
+      }, 30000)
+
+      it('get_pull_request returns PR details if available', async () => {
+        if (!ctx.owner || !ctx.repo || !ctx.pull_number)
+          return expect(true).toBe(true)
+        const handler = toolbox.read('get_pull_request')
+        const result = await handler({ owner: ctx.owner, repo: ctx.repo, pull_number: ctx.pull_number })
+        expect(result?.number).toBe(ctx.pull_number)
+      }, 30000)
+
+      it('get_pull_request_diff returns diff text if PR available', async () => {
+        if (!ctx.owner || !ctx.repo || !ctx.pull_number)
+          return expect(true).toBe(true)
+        const handler = toolbox.read('get_pull_request_diff')
+        const result = await handler({ owner: ctx.owner, repo: ctx.repo, pull_number: ctx.pull_number })
+        expect(typeof result?.diff).toBe('string')
+      }, 30000)
+
+      it('list_pull_request_files returns files if PR available', async () => {
+        if (!ctx.owner || !ctx.repo || !ctx.pull_number)
+          return expect(true).toBe(true)
+        const handler = toolbox.read('list_pull_request_files')
+        const result = await handler({ owner: ctx.owner, repo: ctx.repo, pull_number: ctx.pull_number })
+        expect(Array.isArray(result)).toBe(true)
+      }, 30000)
+
+      it('list_pull_request_comments returns comments if PR available', async () => {
+        if (!ctx.owner || !ctx.repo || !ctx.pull_number)
+          return expect(true).toBe(true)
+        const handler = toolbox.read('list_pull_request_comments')
+        const result = await handler({ owner: ctx.owner, repo: ctx.repo, pull_number: ctx.pull_number })
         expect(Array.isArray(result)).toBe(true)
       }, 30000)
 
-      it('list_branches returns branches', async () => {
+      it('search_pull_requests returns results', async () => {
         if (!ctx.owner || !ctx.repo)
           return expect(true).toBe(true)
-        const handler = toolbox.read('list_branches')
+        const handler = toolbox.read('search_pull_requests')
+        const result = await handler({ query: `is:pr repo:${ctx.owner}/${ctx.repo}` })
+        expect(result?.items).toBeTruthy()
+      }, 30000)
+
+      it('list_releases returns releases', async () => {
+        if (!ctx.owner || !ctx.repo)
+          return expect(true).toBe(true)
+        const handler = toolbox.read('list_releases')
         const result = await handler({ owner: ctx.owner, repo: ctx.repo })
         expect(Array.isArray(result)).toBe(true)
       }, 30000)
 
-      it('list_commits returns commits', async () => {
+      it('get_latest_release returns latest release or not found', async () => {
         if (!ctx.owner || !ctx.repo)
           return expect(true).toBe(true)
-        const handler = toolbox.read('list_commits')
+        const handler = toolbox.read('get_latest_release')
         const result = await handler({ owner: ctx.owner, repo: ctx.repo })
-        expect(Array.isArray(result)).toBe(true)
+        // Repo might have no releases — 404 is acceptable
+        expect(result).toBeTruthy()
+      }, 30000)
+
+      it('list_workflow_runs returns workflow runs', async () => {
+        if (!ctx.owner || !ctx.repo)
+          return expect(true).toBe(true)
+        const handler = toolbox.read('list_workflow_runs')
+        const result = await handler({ owner: ctx.owner, repo: ctx.repo })
+        expect(result?.workflow_runs).toBeTruthy()
+      }, 30000)
+
+      it('get_workflow_run returns run details if any runs exist', async () => {
+        if (!ctx.owner || !ctx.repo)
+          return expect(true).toBe(true)
+        const list_runs = toolbox.read('list_workflow_runs')
+        const runs = await list_runs({ owner: ctx.owner, repo: ctx.repo, per_page: 1 })
+        const firstRun = Array.isArray(runs?.workflow_runs) ? runs.workflow_runs[0] : undefined
+        if (!firstRun)
+          return expect(true).toBe(true)
+        const handler = toolbox.read('get_workflow_run')
+        const result = await handler({ owner: ctx.owner, repo: ctx.repo, run_id: firstRun.id })
+        expect(result?.id).toBe(firstRun.id)
+      }, 30000)
+
+      it('get_job_logs returns log text if any completed runs exist', async () => {
+        if (!ctx.owner || !ctx.repo)
+          return expect(true).toBe(true)
+        const list_runs = toolbox.read('list_workflow_runs')
+        const runs = await list_runs({ owner: ctx.owner, repo: ctx.repo, status: 'completed', per_page: 1 })
+        const firstRun = Array.isArray(runs?.workflow_runs) ? runs.workflow_runs[0] : undefined
+        if (!firstRun)
+          return expect(true).toBe(true)
+        // Use native fetch to retrieve job list for this run
+        const jobsResp = await fetch(
+          `https://api.github.com/repos/${ctx.owner}/${ctx.repo}/actions/runs/${firstRun.id}/jobs`,
+          { headers: { 'Authorization': `Bearer ${variant.token}`, 'Accept': 'application/vnd.github.v3+json' } },
+        )
+        const jobsData = await jobsResp.json()
+        const firstJob = Array.isArray(jobsData?.jobs) ? jobsData.jobs[0] : undefined
+        if (!firstJob)
+          return expect(true).toBe(true)
+        const handler = toolbox.read('get_job_logs')
+        const result = await handler({ owner: ctx.owner, repo: ctx.repo, job_id: firstJob.id })
+        expect(result).toBeTruthy()
       }, 30000)
     })
   }