Github Bubble

GitHub API integration for repository operations

Quick Start

import { GithubBubble } from '@bubblelab/bubble-core';
import { CredentialType } from '@bubblelab/shared-schemas';
const result = await new GithubBubble({
  operation: 'get_file',
  credentials: {
    [CredentialType.GITHUB_TOKEN]: process.env.GITHUB_TOKEN as string,
  },
}).action();

Operation Details

`get_file`

Input Schema
Output Schema

operation 'get_file' required: Get the contents of a file from a GitHub repository
owner string required: Repository owner (username or organization name)
repo string required: Repository name
path string required: Path to the file in the repository (e.g., src/index.ts)
ref string: Git reference (branch, tag, or commit SHA). Defaults to the default branch
credentials Record<CredentialType,string>: Object mapping credential types to values (injected at runtime)

operation 'get_file' required
success boolean required: Whether the operation succeeded
error string required: Error message if operation failed
name string: File name
path string: Full path to the file in the repository
sha string: Git SHA hash of the file
size number: File size in bytes
url string: API URL for this file
html_url string: Web URL to view the file on GitHub
git_url string: Git URL for the file object
download_url string: Direct download URL for the file
type 'file' | 'dir' | 'symlink' | 'submodule': Type of the content
content string: Base64 encoded content (for files)
encoding string: Encoding type (usually base64)

`get_directory`

Input Schema
Output Schema

operation 'get_directory' required: Get the contents of a directory from a GitHub repository
owner string required: Repository owner (username or organization name)
repo string required: Repository name
path string: Path to the directory in the repository (empty string for root)
ref string: Git reference (branch, tag, or commit SHA). Defaults to the default branch
credentials Record<CredentialType,string>: Object mapping credential types to values (injected at runtime)

operation 'get_directory' required
success boolean required: Whether the operation succeeded
error string required: Error message if operation failed
contents object[]: Array of directory contents

`list_pull_requests`

Input Schema
Output Schema

operation 'list_pull_requests' required: List pull requests in a GitHub repository
owner string required: Repository owner (username or organization name)
repo string required: Repository name
state 'open' | 'closed' | 'all': Filter by PR state
sort 'created' | 'updated' | 'popularity' | 'long-running': Sort order for results
direction 'asc' | 'desc': Sort direction
per_page number: Number of results per page (1-100)
page number: Page number for pagination
credentials Record<CredentialType,string>: Object mapping credential types to values (injected at runtime)

operation 'list_pull_requests' required
success boolean required: Whether the operation succeeded
error string required: Error message if operation failed
pull_requests object[]: Array of pull requests

`get_pull_request`

Input Schema
Output Schema

operation 'get_pull_request' required: Get detailed information about a specific pull request
owner string required: Repository owner (username or organization name)
repo string required: Repository name
pull_number number required: Pull request number
credentials Record<CredentialType,string>: Object mapping credential types to values (injected at runtime)

operation 'get_pull_request' required
success boolean required: Whether the operation succeeded
error string required: Error message if operation failed
id number: Pull request ID
node_id string: GraphQL node ID
number number: Pull request number
state 'open' | 'closed': Pull request state
title string: Pull request title
body string: Pull request description
created_at string: ISO datetime when PR was created
updated_at string: ISO datetime when PR was last updated
closed_at string: ISO datetime when PR was closed
merged_at string: ISO datetime when PR was merged
user object: Pull request author
html_url string: Web URL to view the PR
draft boolean: Whether this is a draft PR
head object: Source branch information
base object: Target branch information
merged boolean: Whether the PR has been merged (may not be present in list responses)
mergeable boolean: Whether the PR can be merged (may not be present in list responses)
mergeable_state string: Mergeable state (clean, unstable, dirty, etc.)
comments number: Number of comments
review_comments number: Number of review comments
commits number: Number of commits
additions number: Lines added
deletions number: Lines deleted
changed_files number: Number of files changed

`create_pr_comment`

Input Schema
Output Schema

operation 'create_pr_comment' required: Add a comment to a pull request
owner string required: Repository owner (username or organization name)
repo string required: Repository name
pull_number number required: Pull request number
body string required: Comment text content (supports GitHub Markdown)
credentials Record<CredentialType,string>: Object mapping credential types to values (injected at runtime)

operation 'create_pr_comment' required
success boolean required: Whether the operation succeeded
error string required: Error message if operation failed
id number: Comment ID
node_id string: GraphQL node ID
body string: Comment text content
user object: Comment author information
created_at string: ISO datetime when comment was created
updated_at string: ISO datetime when comment was last updated
html_url string: Web URL to view the comment

`list_repositories`

Input Schema
Output Schema

operation 'list_repositories' required: List repositories for the authenticated user
visibility 'all' | 'public' | 'private': Filter by repository visibility
affiliation 'owner' | 'collaborator' | 'organization_member': Filter by user affiliation
sort 'created' | 'updated' | 'pushed' | 'full_name': Sort order for results
direction 'asc' | 'desc': Sort direction
per_page number: Number of results per page (1-100)
page number: Page number for pagination
credentials Record<CredentialType,string>: Object mapping credential types to values (injected at runtime)

operation 'list_repositories' required
success boolean required: Whether the operation succeeded
error string required: Error message if operation failed
repositories object[]: Array of repositories

`get_repository`

Input Schema
Output Schema

operation 'get_repository' required: Get detailed information about a specific repository
owner string required: Repository owner (username or organization name)
repo string required: Repository name
credentials Record<CredentialType,string>: Object mapping credential types to values (injected at runtime)

operation 'get_repository' required
success boolean required: Whether the operation succeeded
error string required: Error message if operation failed
id number: Repository ID
node_id string: GraphQL node ID
name string: Repository name
full_name string: Full repository name (owner/repo)
private boolean: Whether the repository is private
owner object: Repository owner information
html_url string: Repository web URL
description string: Repository description
fork boolean: Whether this is a fork
created_at string: ISO datetime when repository was created
updated_at string: ISO datetime when repository was last updated
pushed_at string: ISO datetime of last push
size number: Repository size in KB
stargazers_count number: Number of stars
watchers_count number: Number of watchers
language string: Primary programming language
forks_count number: Number of forks
open_issues_count number: Number of open issues
default_branch string: Default branch name
visibility string: Repository visibility (public, private, internal)

`create_issue_comment`

Input Schema
Output Schema

operation 'create_issue_comment' required: Add a comment to an issue
owner string required: Repository owner (username or organization name)
repo string required: Repository name
issue_number number required: Issue number
body string required: Comment text content (supports GitHub Markdown)
credentials Record<CredentialType,string>: Object mapping credential types to values (injected at runtime)

operation 'create_issue_comment' required
success boolean required: Whether the operation succeeded
error string required: Error message if operation failed
id number: Comment ID
node_id string: GraphQL node ID
body string: Comment text content
user object: Comment author information
created_at string: ISO datetime when comment was created
updated_at string: ISO datetime when comment was last updated
html_url string: Web URL to view the comment

`list_issues`

Input Schema
Output Schema

operation 'list_issues' required: List issues in a GitHub repository
owner string required: Repository owner (username or organization name)
repo string required: Repository name
state 'open' | 'closed' | 'all': Filter by issue state
labels string: Filter by labels (comma-separated list)
sort 'created' | 'updated' | 'comments': Sort order for results
direction 'asc' | 'desc': Sort direction
per_page number: Number of results per page (1-100)
page number: Page number for pagination
credentials Record<CredentialType,string>: Object mapping credential types to values (injected at runtime)

operation 'list_issues' required
success boolean required: Whether the operation succeeded
error string required: Error message if operation failed
issues object[]: Array of issues

Quick Start​

Operation Details​

get_file​

get_directory​

list_pull_requests​

get_pull_request​

create_pr_comment​

list_repositories​

get_repository​

create_issue_comment​

list_issues​

Quick Start

Operation Details

`get_file`

`get_directory`

`list_pull_requests`

`get_pull_request`

`create_pr_comment`

`list_repositories`

`get_repository`

`create_issue_comment`

`list_issues`