API: @loopstack/github
Classes
GitHubCreateIssueCommentTool
Tool that adds a comment to a GitHub issue or pull request.
import { GitHubCreateIssueCommentTool } from '@loopstack/github';Provided by: GitHubModule
export class GitHubCreateIssueCommentTool extends BaseTool< GitHubCreateIssueCommentArgs, object, GitHubCreateIssueCommentResult> { protected handle( args: GitHubCreateIssueCommentArgs, ctx: RunContext, ): Promise<ToolEnvelope<GitHubCreateIssueCommentResult>>;}GitHubCreateIssueTool
Tool that creates a new issue in a GitHub repository.
import { GitHubCreateIssueTool } from '@loopstack/github';Provided by: GitHubModule
export class GitHubCreateIssueTool extends BaseTool<GitHubCreateIssueArgs, object, GitHubCreateIssueResult> { protected handle(args: GitHubCreateIssueArgs, ctx: RunContext): Promise<ToolEnvelope<GitHubCreateIssueResult>>;}GitHubCreateOrUpdateFileTool
Tool that creates or updates a file in a GitHub repository, base64-encoding the
provided text and committing it. Pass the existing file sha to update in place.
import { GitHubCreateOrUpdateFileTool } from '@loopstack/github';Provided by: GitHubModule
export class GitHubCreateOrUpdateFileTool extends BaseTool< GitHubCreateOrUpdateFileArgs, object, GitHubCreateOrUpdateFileResult> { protected handle( args: GitHubCreateOrUpdateFileArgs, ctx: RunContext, ): Promise<ToolEnvelope<GitHubCreateOrUpdateFileResult>>;}GitHubCreatePullRequestTool
Tool that opens a new pull request in a GitHub repository from a head branch into a base branch.
import { GitHubCreatePullRequestTool } from '@loopstack/github';Provided by: GitHubModule
export class GitHubCreatePullRequestTool extends BaseTool< GitHubCreatePullRequestArgs, object, GitHubCreatePullRequestResult> { protected handle( args: GitHubCreatePullRequestArgs, ctx: RunContext, ): Promise<ToolEnvelope<GitHubCreatePullRequestResult>>;}GitHubCreateRepoTool
Tool that creates a new GitHub repository for the authenticated user.
import { GitHubCreateRepoTool } from '@loopstack/github';Provided by: GitHubModule
export class GitHubCreateRepoTool extends BaseTool<GitHubCreateRepoArgs, object, GitHubCreateRepoResult> { protected handle(args: GitHubCreateRepoArgs, ctx: RunContext): Promise<ToolEnvelope<GitHubCreateRepoResult>>;}GitHubGetAuthenticatedUserTool
Tool that fetches the profile of the currently authenticated GitHub user.
import { GitHubGetAuthenticatedUserTool } from '@loopstack/github';Provided by: GitHubModule
export class GitHubGetAuthenticatedUserTool extends BaseTool< GitHubGetAuthenticatedUserArgs, object, GitHubGetAuthenticatedUserResult> { protected handle( _args: GitHubGetAuthenticatedUserArgs, ctx: RunContext, ): Promise<ToolEnvelope<GitHubGetAuthenticatedUserResult>>;}GitHubGetCommitTool
Tool that fetches detailed information about a single commit in a GitHub repository, including diff stats and changed files.
import { GitHubGetCommitTool } from '@loopstack/github';Provided by: GitHubModule
export class GitHubGetCommitTool extends BaseTool<GitHubGetCommitArgs, object, GitHubGetCommitResult> { protected handle(args: GitHubGetCommitArgs, ctx: RunContext): Promise<ToolEnvelope<GitHubGetCommitResult>>;}GitHubGetFileContentTool
Tool that reads the content of a file from a GitHub repository, decoding the base64 payload returned by the API into plain text.
import { GitHubGetFileContentTool } from '@loopstack/github';Provided by: GitHubModule
export class GitHubGetFileContentTool extends BaseTool<GitHubGetFileContentArgs, object, GitHubGetFileContentResult> { protected handle(args: GitHubGetFileContentArgs, ctx: RunContext): Promise<ToolEnvelope<GitHubGetFileContentResult>>;}GitHubGetIssueTool
Tool that fetches detailed information about a single GitHub issue.
import { GitHubGetIssueTool } from '@loopstack/github';Provided by: GitHubModule
export class GitHubGetIssueTool extends BaseTool<GitHubGetIssueArgs, object, GitHubGetIssueResult> { protected handle(args: GitHubGetIssueArgs, ctx: RunContext): Promise<ToolEnvelope<GitHubGetIssueResult>>;}GitHubGetPullRequestTool
Tool that fetches detailed information about a single GitHub pull request.
import { GitHubGetPullRequestTool } from '@loopstack/github';Provided by: GitHubModule
export class GitHubGetPullRequestTool extends BaseTool<GitHubGetPullRequestArgs, object, GitHubGetPullRequestResult> { protected handle(args: GitHubGetPullRequestArgs, ctx: RunContext): Promise<ToolEnvelope<GitHubGetPullRequestResult>>;}GitHubGetRepoTool
Tool that fetches detailed information about a single GitHub repository.
Takes an owner and repo and returns full repository metadata.
import { GitHubGetRepoTool } from '@loopstack/github';Provided by: GitHubModule
export class GitHubGetRepoTool extends BaseTool<GitHubGetRepoArgs, object, GitHubGetRepoResult> { protected handle(args: GitHubGetRepoArgs, ctx: RunContext): Promise<ToolEnvelope<GitHubGetRepoResult>>;}GitHubGetWorkflowRunTool
Tool that fetches detailed information about a single GitHub Actions workflow run.
import { GitHubGetWorkflowRunTool } from '@loopstack/github';Provided by: GitHubModule
export class GitHubGetWorkflowRunTool extends BaseTool<GitHubGetWorkflowRunArgs, object, GitHubGetWorkflowRunResult> { protected handle(args: GitHubGetWorkflowRunArgs, ctx: RunContext): Promise<ToolEnvelope<GitHubGetWorkflowRunResult>>;}GitHubListBranchesTool
Tool that lists branches for a GitHub repository.
import { GitHubListBranchesTool } from '@loopstack/github';Provided by: GitHubModule
export class GitHubListBranchesTool extends BaseTool<GitHubListBranchesArgs, object, GitHubListBranchesResult> { protected handle(args: GitHubListBranchesArgs, ctx: RunContext): Promise<ToolEnvelope<GitHubListBranchesResult>>;}GitHubListDirectoryTool
Tool that lists the contents of a directory in a GitHub repository.
import { GitHubListDirectoryTool } from '@loopstack/github';Provided by: GitHubModule
export class GitHubListDirectoryTool extends BaseTool<GitHubListDirectoryArgs, object, GitHubListDirectoryResult> { protected handle(args: GitHubListDirectoryArgs, ctx: RunContext): Promise<ToolEnvelope<GitHubListDirectoryResult>>;}GitHubListIssuesTool
Tool that lists issues for a GitHub repository, with state, label and assignee filters.
Note that the GitHub API also returns pull requests, marked via isPullRequest.
import { GitHubListIssuesTool } from '@loopstack/github';Provided by: GitHubModule
export class GitHubListIssuesTool extends BaseTool<GitHubListIssuesArgs, object, GitHubListIssuesResult> { protected handle(args: GitHubListIssuesArgs, ctx: RunContext): Promise<ToolEnvelope<GitHubListIssuesResult>>;}GitHubListPrReviewsTool
Tool that lists reviews submitted on a GitHub pull request.
import { GitHubListPrReviewsTool } from '@loopstack/github';Provided by: GitHubModule
export class GitHubListPrReviewsTool extends BaseTool<GitHubListPrReviewsArgs, object, GitHubListPrReviewsResult> { protected handle(args: GitHubListPrReviewsArgs, ctx: RunContext): Promise<ToolEnvelope<GitHubListPrReviewsResult>>;}GitHubListPullRequestsTool
Tool that lists pull requests for a GitHub repository, with state and base-branch filters.
import { GitHubListPullRequestsTool } from '@loopstack/github';Provided by: GitHubModule
export class GitHubListPullRequestsTool extends BaseTool< GitHubListPullRequestsArgs, object, GitHubListPullRequestsResult> { protected handle( args: GitHubListPullRequestsArgs, ctx: RunContext, ): Promise<ToolEnvelope<GitHubListPullRequestsResult>>;}GitHubListReposTool
Tool that lists repositories for the authenticated GitHub user, with visibility, sort and paging options.
import { GitHubListReposTool } from '@loopstack/github';Provided by: GitHubModule
export class GitHubListReposTool extends BaseTool<GitHubListReposArgs, object, GitHubListReposResult> { protected handle(args: GitHubListReposArgs, ctx: RunContext): Promise<ToolEnvelope<GitHubListReposResult>>;}GitHubListUserOrgsTool
Tool that lists the organizations the authenticated GitHub user belongs to.
import { GitHubListUserOrgsTool } from '@loopstack/github';Provided by: GitHubModule
export class GitHubListUserOrgsTool extends BaseTool<GitHubListUserOrgsArgs, object, GitHubListUserOrgsResult> { protected handle(args: GitHubListUserOrgsArgs, ctx: RunContext): Promise<ToolEnvelope<GitHubListUserOrgsResult>>;}GitHubListWorkflowRunsTool
Tool that lists GitHub Actions workflow runs for a repository, with branch and status filters.
import { GitHubListWorkflowRunsTool } from '@loopstack/github';Provided by: GitHubModule
export class GitHubListWorkflowRunsTool extends BaseTool< GitHubListWorkflowRunsArgs, object, GitHubListWorkflowRunsResult> { protected handle( args: GitHubListWorkflowRunsArgs, ctx: RunContext, ): Promise<ToolEnvelope<GitHubListWorkflowRunsResult>>;}GitHubMergePullRequestTool
Tool that merges a GitHub pull request using the chosen merge method.
import { GitHubMergePullRequestTool } from '@loopstack/github';Provided by: GitHubModule
export class GitHubMergePullRequestTool extends BaseTool< GitHubMergePullRequestArgs, object, GitHubMergePullRequestResult> { protected handle( args: GitHubMergePullRequestArgs, ctx: RunContext, ): Promise<ToolEnvelope<GitHubMergePullRequestResult>>;}GitHubModule
NestJS module that provides the GitHub OAuth provider (GitHubOAuthProvider) and 25 GitHub API tools
for repositories, issues, pull requests, file content/git ops, actions/workflow runs, search, and users/orgs.
Registration:
GitHubModule— bare import; it internally importsOAuthModuleand registersGitHubOAuthProviderplus all tools. No static configuration methods exist.
Requires: a configured GitHub OAuth app via the environment variables GITHUB_CLIENT_ID,
GITHUB_CLIENT_SECRET, and GITHUB_OAUTH_REDIRECT_URI; without valid OAuth credentials the tools
return { error: 'unauthorized' }.
import { GitHubModule } from '@loopstack/github';export class GitHubModule {}GitHubSearchCodeTool
Tool that searches for code across GitHub repositories using the GitHub search syntax.
import { GitHubSearchCodeTool } from '@loopstack/github';Provided by: GitHubModule
export class GitHubSearchCodeTool extends BaseTool<GitHubSearchCodeArgs, object, GitHubSearchCodeResult> { protected handle(args: GitHubSearchCodeArgs, ctx: RunContext): Promise<ToolEnvelope<GitHubSearchCodeResult>>;}GitHubSearchIssuesTool
Tool that searches for issues and pull requests across GitHub using the GitHub search syntax.
import { GitHubSearchIssuesTool } from '@loopstack/github';Provided by: GitHubModule
export class GitHubSearchIssuesTool extends BaseTool<GitHubSearchIssuesArgs, object, GitHubSearchIssuesResult> { protected handle(args: GitHubSearchIssuesArgs, ctx: RunContext): Promise<ToolEnvelope<GitHubSearchIssuesResult>>;}GitHubSearchReposTool
Tool that searches for repositories on GitHub using the GitHub search syntax.
import { GitHubSearchReposTool } from '@loopstack/github';Provided by: GitHubModule
export class GitHubSearchReposTool extends BaseTool<GitHubSearchReposArgs, object, GitHubSearchReposResult> { protected handle(args: GitHubSearchReposArgs, ctx: RunContext): Promise<ToolEnvelope<GitHubSearchReposResult>>;}GitHubTriggerWorkflowTool
Tool that triggers a GitHub Actions workflow dispatch event on a given ref.
import { GitHubTriggerWorkflowTool } from '@loopstack/github';Provided by: GitHubModule
export class GitHubTriggerWorkflowTool extends BaseTool< GitHubTriggerWorkflowArgs, object, GitHubTriggerWorkflowResult> { protected handle( args: GitHubTriggerWorkflowArgs, ctx: RunContext, ): Promise<ToolEnvelope<GitHubTriggerWorkflowResult>>;}Type Aliases
GitHubCreateIssueArgs
Args for GitHubCreateIssueTool: the repository owner, repo, issue title and
optional body, labels and assignees.
import { GitHubCreateIssueArgs } from '@loopstack/github';export type GitHubCreateIssueArgs = z.infer<typeof inputSchema>;GitHubCreateIssueCommentArgs
Args for GitHubCreateIssueCommentTool: the repository owner, repo,
issueNumber (issue or pull request) and comment body.
import { GitHubCreateIssueCommentArgs } from '@loopstack/github';export type GitHubCreateIssueCommentArgs = z.infer<typeof inputSchema>;GitHubCreateIssueCommentResult
Result for GitHubCreateIssueCommentTool: the created comment summary, or an error.
import { GitHubCreateIssueCommentResult } from '@loopstack/github';export type GitHubCreateIssueCommentResult = | { comment: { id: number; htmlUrl: string; createdAt: string; user: string; }; } | { error: string; message: string; };GitHubCreateIssueResult
Result for GitHubCreateIssueTool: the created issue summary, or an error.
import { GitHubCreateIssueResult } from '@loopstack/github';export type GitHubCreateIssueResult = | { issue: { id: number; number: number; title: string; htmlUrl: string; state: string; }; } | { error: string; message: string; };GitHubCreateOrUpdateFileArgs
Args for GitHubCreateOrUpdateFileTool: the repository owner, repo, file path,
plain-text content, commit message, optional branch and sha of the file being replaced.
import { GitHubCreateOrUpdateFileArgs } from '@loopstack/github';export type GitHubCreateOrUpdateFileArgs = z.infer<typeof inputSchema>;GitHubCreateOrUpdateFileResult
Result for GitHubCreateOrUpdateFileTool: the written file and resulting commit, or an error.
import { GitHubCreateOrUpdateFileResult } from '@loopstack/github';export type GitHubCreateOrUpdateFileResult = | { file: { name: string; path: string; sha: string; htmlUrl: string; }; commit: { sha: string; message: string; }; } | { error: string; message: string; };GitHubCreatePullRequestArgs
Args for GitHubCreatePullRequestTool: the repository owner, repo, title,
head and base branches, optional body and draft flag.
import { GitHubCreatePullRequestArgs } from '@loopstack/github';export type GitHubCreatePullRequestArgs = z.input<typeof inputSchema>;GitHubCreatePullRequestResult
Result for GitHubCreatePullRequestTool: the created pullRequest summary, or an error.
import { GitHubCreatePullRequestResult } from '@loopstack/github';export type GitHubCreatePullRequestResult = | { pullRequest: { id: number; number: number; title: string; htmlUrl: string; state: string; draft: boolean; }; } | { error: string; message: string; };GitHubCreateRepoArgs
Args for GitHubCreateRepoTool: repository name, optional description,
private visibility and autoInit to seed an initial commit.
import { GitHubCreateRepoArgs } from '@loopstack/github';export type GitHubCreateRepoArgs = z.input<typeof inputSchema>;GitHubCreateRepoResult
Result for GitHubCreateRepoTool: the created repo summary, or an error.
import { GitHubCreateRepoResult } from '@loopstack/github';export type GitHubCreateRepoResult = { repo?: { id: number; fullName: string; name: string; htmlUrl: string; private: boolean; defaultBranch: string; }; error?: string; message?: string;};GitHubGetAuthenticatedUserArgs
Args for GitHubGetAuthenticatedUserTool: an empty object; the user is resolved from the token.
import { GitHubGetAuthenticatedUserArgs } from '@loopstack/github';export type GitHubGetAuthenticatedUserArgs = z.infer<typeof inputSchema>;GitHubGetAuthenticatedUserResult
Result for GitHubGetAuthenticatedUserTool: a user profile with login, name, email,
avatar and counts, or an error.
import { GitHubGetAuthenticatedUserResult } from '@loopstack/github';export type GitHubGetAuthenticatedUserResult = { user?: { id: number; login: string; name: string | null; email: string | null; avatarUrl: string; htmlUrl: string; bio: string | null; publicRepos: number; followers: number; following: number; createdAt: string; }; error?: string; message?: string;};GitHubGetCommitArgs
Args for GitHubGetCommitTool: the repository owner, repo and ref (commit SHA, branch or tag).
import { GitHubGetCommitArgs } from '@loopstack/github';export type GitHubGetCommitArgs = z.infer<typeof inputSchema>;GitHubGetCommitResult
Result for GitHubGetCommitTool: a commit object with author, committer, diff stats
and changed files, or an error.
import { GitHubGetCommitResult } from '@loopstack/github';export type GitHubGetCommitResult = | { commit: { sha: string; message: string; author: { name: string; email: string; date: string; login: string | null; }; committer: { name: string; date: string; }; htmlUrl: string; stats: { additions: number; deletions: number; total: number; }; files: Array<{ filename: string; status: string; additions: number; deletions: number; changes: number; }>; }; } | { error: string; message: string; };GitHubGetFileContentArgs
Args for GitHubGetFileContentTool: the repository owner, repo, file path
and optional ref (branch, tag or commit SHA).
import { GitHubGetFileContentArgs } from '@loopstack/github';export type GitHubGetFileContentArgs = z.infer<typeof inputSchema>;GitHubGetFileContentResult
Result for GitHubGetFileContentTool: a file object with decoded text content
plus path, sha and size, or an error.
import { GitHubGetFileContentResult } from '@loopstack/github';export type GitHubGetFileContentResult = | { file: { name: string; path: string; sha: string; size: number; type: string; content: string | null; htmlUrl: string; }; } | { error: string; message: string; };GitHubGetIssueArgs
Args for GitHubGetIssueTool: the repository owner, repo and issueNumber.
import { GitHubGetIssueArgs } from '@loopstack/github';export type GitHubGetIssueArgs = z.infer<typeof inputSchema>;GitHubGetIssueResult
Result for GitHubGetIssueTool: an issue object with title, body, state, labels,
assignees and timestamps, or an error.
import { GitHubGetIssueResult } from '@loopstack/github';export type GitHubGetIssueResult = | { issue: { id: number; number: number; title: string; body: string | null; state: string; user: string; labels: string[]; assignees: string[]; milestone: string | null; createdAt: string; updatedAt: string; closedAt: string | null; htmlUrl: string; comments: number; }; } | { error: string; message: string; };GitHubGetPullRequestArgs
Args for GitHubGetPullRequestTool: the repository owner, repo and pullNumber.
import { GitHubGetPullRequestArgs } from '@loopstack/github';export type GitHubGetPullRequestArgs = z.infer<typeof inputSchema>;GitHubGetPullRequestResult
Result for GitHubGetPullRequestTool: a pullRequest object with branches, merge state,
diff stats and timestamps, or an error.
import { GitHubGetPullRequestResult } from '@loopstack/github';export type GitHubGetPullRequestResult = | { pullRequest: { id: number; number: number; title: string; body: string | null; state: string; user: string; head: string; headSha: string; base: string; merged: boolean; mergeable: boolean | null; draft: boolean; additions: number; deletions: number; changedFiles: number; createdAt: string; updatedAt: string; mergedAt: string | null; htmlUrl: string; comments: number; reviewComments: number; }; } | { error: string; message: string; };GitHubGetRepoArgs
Args for GitHubGetRepoTool: the repository owner and repo name.
import { GitHubGetRepoArgs } from '@loopstack/github';export type GitHubGetRepoArgs = z.infer<typeof inputSchema>;GitHubGetRepoResult
Result for GitHubGetRepoTool: a repo object with id, full name, visibility,
description, language, default branch, stars, forks, topics and license, or an error.
import { GitHubGetRepoResult } from '@loopstack/github';export type GitHubGetRepoResult = { repo?: { id: number; fullName: string; name: string; owner: string; ownerAvatar: string; private: boolean; htmlUrl: string; description: string | null; language: string | null; defaultBranch: string; stars: number; forks: number; openIssues: number; createdAt: string; updatedAt: string; topics: string[]; license: string | null; }; error?: string; message?: string;};GitHubGetWorkflowRunArgs
Args for GitHubGetWorkflowRunTool: the repository owner, repo and runId.
import { GitHubGetWorkflowRunArgs } from '@loopstack/github';export type GitHubGetWorkflowRunArgs = z.infer<typeof inputSchema>;GitHubGetWorkflowRunResult
Result for GitHubGetWorkflowRunTool: a run object with status, conclusion, branch
and run metadata, or an error.
import { GitHubGetWorkflowRunResult } from '@loopstack/github';export type GitHubGetWorkflowRunResult = | { run: { id: number; name: string; status: string; conclusion: string | null; headBranch: string; headSha: string; event: string; workflowId: number; runNumber: number; runAttempt: number; createdAt: string; updatedAt: string; runStartedAt: string; htmlUrl: string; }; } | { error: string; message: string; };GitHubListBranchesArgs
Args for GitHubListBranchesTool: the repository owner, repo and perPage page size.
import { GitHubListBranchesArgs } from '@loopstack/github';export type GitHubListBranchesArgs = z.input<typeof inputSchema>;GitHubListBranchesResult
Result for GitHubListBranchesTool: a branches array with name, commit SHA and
protection flag, or an error.
import { GitHubListBranchesResult } from '@loopstack/github';export type GitHubListBranchesResult = { branches?: Array<{ name: string; commitSha: string; protected: boolean; }>; error?: string; message?: string;};GitHubListDirectoryArgs
Args for GitHubListDirectoryTool: the repository owner, repo, directory path
(defaults to the repo root) and optional ref.
import { GitHubListDirectoryArgs } from '@loopstack/github';export type GitHubListDirectoryArgs = z.input<typeof inputSchema>;GitHubListDirectoryResult
Result for GitHubListDirectoryTool: an entries array of files and subdirectories, or an error.
import { GitHubListDirectoryResult } from '@loopstack/github';export type GitHubListDirectoryResult = { entries?: Array<{ name: string; path: string; sha: string; size: number; type: string; htmlUrl: string; }>; error?: string; message?: string;};GitHubListIssuesArgs
Args for GitHubListIssuesTool: the repository owner, repo, issue state,
optional labels/assignee filters and perPage/page paging.
import { GitHubListIssuesArgs } from '@loopstack/github';export type GitHubListIssuesArgs = z.input<typeof inputSchema>;GitHubListIssuesResult
Result for GitHubListIssuesTool: an issues array (each flagged with
isPullRequest since the GitHub API mixes in pull requests), or an error.
import { GitHubListIssuesResult } from '@loopstack/github';export type GitHubListIssuesResult = { issues?: Array<{ id: number; number: number; title: string; state: string; user: string; labels: string[]; assignees: string[]; createdAt: string; updatedAt: string; htmlUrl: string; isPullRequest: boolean; }>; error?: string; message?: string;};GitHubListPrReviewsArgs
Args for GitHubListPrReviewsTool: the repository owner, repo and pullNumber.
import { GitHubListPrReviewsArgs } from '@loopstack/github';export type GitHubListPrReviewsArgs = z.infer<typeof inputSchema>;GitHubListPrReviewsResult
Result for GitHubListPrReviewsTool: a reviews array with reviewer, body, state
and submission time (absent for a pending review), or an error.
import { GitHubListPrReviewsResult } from '@loopstack/github';export type GitHubListPrReviewsResult = | { reviews: Array<{ id: number; user: string; body: string; state: string; submittedAt?: string; htmlUrl: string; }>; } | { error: string; message: string; };GitHubListPullRequestsArgs
Args for GitHubListPullRequestsTool: the repository owner, repo, PR state,
optional base branch filter and perPage/page paging.
import { GitHubListPullRequestsArgs } from '@loopstack/github';export type GitHubListPullRequestsArgs = z.input<typeof inputSchema>;GitHubListPullRequestsResult
Result for GitHubListPullRequestsTool: a pullRequests array of PR summaries, or an error.
import { GitHubListPullRequestsResult } from '@loopstack/github';export type GitHubListPullRequestsResult = { pullRequests?: Array<{ id: number; number: number; title: string; state: string; user: string; head: string; headSha: string; base: string; createdAt: string; updatedAt: string; htmlUrl: string; draft: boolean; }>; error?: string; message?: string;};GitHubListReposArgs
Args for GitHubListReposTool: visibility, sort, perPage and page paging controls.
import { GitHubListReposArgs } from '@loopstack/github';export type GitHubListReposArgs = z.input<typeof inputSchema>;GitHubListReposResult
Result for GitHubListReposTool: a repos array of repository summaries, or an error.
import { GitHubListReposResult } from '@loopstack/github';export type GitHubListReposResult = { repos?: Array<{ id: number; fullName: string; name: string; owner: string; private: boolean; htmlUrl: string; description: string | null; language: string | null; defaultBranch: string; updatedAt: string; }>; error?: string; message?: string;};GitHubListUserOrgsArgs
Args for GitHubListUserOrgsTool: the perPage page size.
import { GitHubListUserOrgsArgs } from '@loopstack/github';export type GitHubListUserOrgsArgs = z.input<typeof inputSchema>;GitHubListUserOrgsResult
Result for GitHubListUserOrgsTool: an orgs array with login, description and avatar, or an error.
import { GitHubListUserOrgsResult } from '@loopstack/github';export type GitHubListUserOrgsResult = { orgs?: Array<{ id: number; login: string; description: string | null; avatarUrl: string; }>; error?: string; message?: string;};GitHubListWorkflowRunsArgs
Args for GitHubListWorkflowRunsTool: the repository owner, repo, optional branch
and status filters and perPage/page paging.
import { GitHubListWorkflowRunsArgs } from '@loopstack/github';export type GitHubListWorkflowRunsArgs = z.input<typeof inputSchema>;GitHubListWorkflowRunsResult
Result for GitHubListWorkflowRunsTool: totalCount and a runs array of workflow-run
summaries with status and conclusion, or an error.
import { GitHubListWorkflowRunsResult } from '@loopstack/github';export type GitHubListWorkflowRunsResult = { totalCount?: number; runs?: Array<{ id: number; name: string; status: string; conclusion: string | null; headBranch: string; headSha: string; event: string; createdAt: string; updatedAt: string; htmlUrl: string; }>; error?: string; message?: string;};GitHubMergePullRequestArgs
Args for GitHubMergePullRequestTool: the repository owner, repo, pullNumber,
mergeMethod and optional commitTitle/commitMessage.
import { GitHubMergePullRequestArgs } from '@loopstack/github';export type GitHubMergePullRequestArgs = z.input<typeof inputSchema>;GitHubMergePullRequestResult
Result for GitHubMergePullRequestTool: a merge object with the merge commit sha
and merged flag, or an error.
import { GitHubMergePullRequestResult } from '@loopstack/github';export type GitHubMergePullRequestResult = | { merge: { sha: string; merged: boolean; message: string; }; } | { error: string; message: string; };GitHubSearchCodeArgs
Args for GitHubSearchCodeTool: the GitHub code-search query and perPage/page paging.
import { GitHubSearchCodeArgs } from '@loopstack/github';export type GitHubSearchCodeArgs = z.input<typeof inputSchema>;GitHubSearchCodeResult
Result for GitHubSearchCodeTool: totalCount and a results array of matching files
with their repository, or an error.
import { GitHubSearchCodeResult } from '@loopstack/github';export type GitHubSearchCodeResult = { totalCount?: number; results?: Array<{ name: string; path: string; sha: string; htmlUrl: string; repository: string; }>; error?: string; message?: string;};GitHubSearchIssuesArgs
Args for GitHubSearchIssuesTool: the GitHub search query, optional sort and
perPage/page paging.
import { GitHubSearchIssuesArgs } from '@loopstack/github';export type GitHubSearchIssuesArgs = z.input<typeof inputSchema>;GitHubSearchIssuesResult
Result for GitHubSearchIssuesTool: totalCount and a results array of matching
issues and pull requests (each flagged with isPullRequest), or an error.
import { GitHubSearchIssuesResult } from '@loopstack/github';export type GitHubSearchIssuesResult = | { totalCount: number; results: Array<{ id: number; number: number; title: string; state: string; user: string; htmlUrl: string; createdAt: string; updatedAt: string; isPullRequest: boolean; }>; } | { error: string; message: string; };GitHubSearchReposArgs
Args for GitHubSearchReposTool: the GitHub search query, optional sort and
perPage/page paging.
import { GitHubSearchReposArgs } from '@loopstack/github';export type GitHubSearchReposArgs = z.input<typeof inputSchema>;GitHubSearchReposResult
Result for GitHubSearchReposTool: totalCount and a results array of matching
repositories, or an error.
import { GitHubSearchReposResult } from '@loopstack/github';export type GitHubSearchReposResult = | { totalCount: number; results: Array<{ id: number; fullName: string; description: string | null; htmlUrl: string; language: string | null; stars: number; forks: number; updatedAt: string; }>; } | { error: string; message: string; };GitHubTriggerWorkflowArgs
Args for GitHubTriggerWorkflowTool: the repository owner, repo, workflowId,
ref to run against and optional inputs for the dispatch event.
import { GitHubTriggerWorkflowArgs } from '@loopstack/github';export type GitHubTriggerWorkflowArgs = z.infer<typeof inputSchema>;GitHubTriggerWorkflowResult
Result for GitHubTriggerWorkflowTool: a triggered flag with a message, or an error.
import { GitHubTriggerWorkflowResult } from '@loopstack/github';export type GitHubTriggerWorkflowResult = | { triggered: boolean; message: string; } | { error: string; message: string; };Variables
GitHubCreateIssueCommentResultSchema
Zod schema for the success shape of GitHubCreateIssueCommentResult.
import { GitHubCreateIssueCommentResultSchema } from '@loopstack/github';GitHubCreateIssueCommentResultSchema: z.ZodObject< { comment: z.ZodObject< { id: z.ZodNumber; htmlUrl: z.ZodString; createdAt: z.ZodString; user: z.ZodString; }, z.core.$strict >; }, z.core.$strict>;GitHubCreateIssueResultSchema
Zod schema for the success shape of GitHubCreateIssueResult.
import { GitHubCreateIssueResultSchema } from '@loopstack/github';GitHubCreateIssueResultSchema: z.ZodObject< { issue: z.ZodObject< { id: z.ZodNumber; number: z.ZodNumber; title: z.ZodString; htmlUrl: z.ZodString; state: z.ZodString; }, z.core.$strict >; }, z.core.$strict>;GitHubCreateOrUpdateFileResultSchema
Zod schema for the success shape of GitHubCreateOrUpdateFileResult.
import { GitHubCreateOrUpdateFileResultSchema } from '@loopstack/github';GitHubCreateOrUpdateFileResultSchema: z.ZodObject< { file: z.ZodObject< { name: z.ZodString; path: z.ZodString; sha: z.ZodString; htmlUrl: z.ZodString; }, z.core.$strict >; commit: z.ZodObject< { sha: z.ZodString; message: z.ZodString; }, z.core.$strict >; }, z.core.$strict>;GitHubCreatePullRequestResultSchema
Zod schema for the success shape of GitHubCreatePullRequestResult.
import { GitHubCreatePullRequestResultSchema } from '@loopstack/github';GitHubCreatePullRequestResultSchema: z.ZodObject< { pullRequest: z.ZodObject< { id: z.ZodNumber; number: z.ZodNumber; title: z.ZodString; htmlUrl: z.ZodString; state: z.ZodString; draft: z.ZodBoolean; }, z.core.$strict >; }, z.core.$strict>;GitHubCreateRepoResultSchema
Zod schema for the success shape of GitHubCreateRepoResult.
import { GitHubCreateRepoResultSchema } from '@loopstack/github';GitHubCreateRepoResultSchema: z.ZodObject< { repo: z.ZodObject< { id: z.ZodNumber; fullName: z.ZodString; name: z.ZodString; htmlUrl: z.ZodString; private: z.ZodBoolean; defaultBranch: z.ZodString; }, z.core.$strict >; }, z.core.$strict>;GitHubGetAuthenticatedUserResultSchema
Zod schema for the success shape of GitHubGetAuthenticatedUserResult.
import { GitHubGetAuthenticatedUserResultSchema } from '@loopstack/github';GitHubGetAuthenticatedUserResultSchema: z.ZodObject< { user: z.ZodObject< { id: z.ZodNumber; login: z.ZodString; name: z.ZodNullable<z.ZodString>; email: z.ZodNullable<z.ZodString>; avatarUrl: z.ZodString; htmlUrl: z.ZodString; bio: z.ZodNullable<z.ZodString>; publicRepos: z.ZodNumber; followers: z.ZodNumber; following: z.ZodNumber; createdAt: z.ZodString; }, z.core.$strict >; }, z.core.$strict>;GitHubGetCommitResultSchema
Zod schema for the success shape of GitHubGetCommitResult.
import { GitHubGetCommitResultSchema } from '@loopstack/github';GitHubGetCommitResultSchema: z.ZodObject< { commit: z.ZodObject< { sha: z.ZodString; message: z.ZodString; author: z.ZodObject< { name: z.ZodString; email: z.ZodString; date: z.ZodString; login: z.ZodNullable<z.ZodString>; }, z.core.$strict >; committer: z.ZodObject< { name: z.ZodString; date: z.ZodString; }, z.core.$strict >; htmlUrl: z.ZodString; stats: z.ZodObject< { additions: z.ZodNumber; deletions: z.ZodNumber; total: z.ZodNumber; }, z.core.$strict >; files: z.ZodArray< z.ZodObject< { filename: z.ZodString; status: z.ZodString; additions: z.ZodNumber; deletions: z.ZodNumber; changes: z.ZodNumber; }, z.core.$strict > >; }, z.core.$strict >; }, z.core.$strict>;GitHubGetFileContentResultSchema
Zod schema for the success shape of GitHubGetFileContentResult.
import { GitHubGetFileContentResultSchema } from '@loopstack/github';GitHubGetFileContentResultSchema: z.ZodObject< { file: z.ZodObject< { name: z.ZodString; path: z.ZodString; sha: z.ZodString; size: z.ZodNumber; type: z.ZodString; content: z.ZodNullable<z.ZodString>; htmlUrl: z.ZodString; }, z.core.$strict >; }, z.core.$strict>;GitHubGetIssueResultSchema
Zod schema for the success shape of GitHubGetIssueResult.
import { GitHubGetIssueResultSchema } from '@loopstack/github';GitHubGetIssueResultSchema: z.ZodObject< { issue: z.ZodObject< { id: z.ZodNumber; number: z.ZodNumber; title: z.ZodString; body: z.ZodNullable<z.ZodString>; state: z.ZodString; user: z.ZodString; labels: z.ZodArray<z.ZodString>; assignees: z.ZodArray<z.ZodString>; milestone: z.ZodNullable<z.ZodString>; createdAt: z.ZodString; updatedAt: z.ZodString; closedAt: z.ZodNullable<z.ZodString>; htmlUrl: z.ZodString; comments: z.ZodNumber; }, z.core.$strict >; }, z.core.$strict>;GitHubGetPullRequestResultSchema
Zod schema for the success shape of GitHubGetPullRequestResult.
import { GitHubGetPullRequestResultSchema } from '@loopstack/github';GitHubGetPullRequestResultSchema: z.ZodObject< { pullRequest: z.ZodObject< { id: z.ZodNumber; number: z.ZodNumber; title: z.ZodString; body: z.ZodNullable<z.ZodString>; state: z.ZodString; user: z.ZodString; head: z.ZodString; headSha: z.ZodString; base: z.ZodString; merged: z.ZodBoolean; mergeable: z.ZodNullable<z.ZodBoolean>; draft: z.ZodBoolean; additions: z.ZodNumber; deletions: z.ZodNumber; changedFiles: z.ZodNumber; createdAt: z.ZodString; updatedAt: z.ZodString; mergedAt: z.ZodNullable<z.ZodString>; htmlUrl: z.ZodString; comments: z.ZodNumber; reviewComments: z.ZodNumber; }, z.core.$strict >; }, z.core.$strict>;GitHubGetRepoResultSchema
Zod schema for the success shape of GitHubGetRepoResult.
import { GitHubGetRepoResultSchema } from '@loopstack/github';GitHubGetRepoResultSchema: z.ZodObject< { repo: z.ZodObject< { id: z.ZodNumber; fullName: z.ZodString; name: z.ZodString; owner: z.ZodString; ownerAvatar: z.ZodString; private: z.ZodBoolean; htmlUrl: z.ZodString; description: z.ZodNullable<z.ZodString>; language: z.ZodNullable<z.ZodString>; defaultBranch: z.ZodString; stars: z.ZodNumber; forks: z.ZodNumber; openIssues: z.ZodNumber; createdAt: z.ZodString; updatedAt: z.ZodString; topics: z.ZodArray<z.ZodString>; license: z.ZodNullable<z.ZodString>; }, z.core.$strict >; }, z.core.$strict>;GitHubGetWorkflowRunResultSchema
Zod schema for the success shape of GitHubGetWorkflowRunResult.
import { GitHubGetWorkflowRunResultSchema } from '@loopstack/github';GitHubGetWorkflowRunResultSchema: z.ZodObject< { run: z.ZodObject< { id: z.ZodNumber; name: z.ZodString; status: z.ZodString; conclusion: z.ZodNullable<z.ZodString>; headBranch: z.ZodString; headSha: z.ZodString; event: z.ZodString; workflowId: z.ZodNumber; runNumber: z.ZodNumber; runAttempt: z.ZodNumber; createdAt: z.ZodString; updatedAt: z.ZodString; runStartedAt: z.ZodString; htmlUrl: z.ZodString; }, z.core.$strict >; }, z.core.$strict>;GitHubListBranchesResultSchema
Zod schema for the success shape of GitHubListBranchesResult.
import { GitHubListBranchesResultSchema } from '@loopstack/github';GitHubListBranchesResultSchema: z.ZodObject< { branches: z.ZodArray< z.ZodObject< { name: z.ZodString; commitSha: z.ZodString; protected: z.ZodBoolean; }, z.core.$strict > >; }, z.core.$strict>;GitHubListDirectoryResultSchema
Zod schema for the success shape of GitHubListDirectoryResult.
import { GitHubListDirectoryResultSchema } from '@loopstack/github';GitHubListDirectoryResultSchema: z.ZodObject< { entries: z.ZodArray< z.ZodObject< { name: z.ZodString; path: z.ZodString; sha: z.ZodString; size: z.ZodNumber; type: z.ZodString; htmlUrl: z.ZodString; }, z.core.$strict > >; }, z.core.$strict>;GitHubListIssuesResultSchema
Zod schema for the success shape of GitHubListIssuesResult.
import { GitHubListIssuesResultSchema } from '@loopstack/github';GitHubListIssuesResultSchema: z.ZodObject< { issues: z.ZodArray< z.ZodObject< { id: z.ZodNumber; number: z.ZodNumber; title: z.ZodString; state: z.ZodString; user: z.ZodString; labels: z.ZodArray<z.ZodString>; assignees: z.ZodArray<z.ZodString>; createdAt: z.ZodString; updatedAt: z.ZodString; htmlUrl: z.ZodString; isPullRequest: z.ZodBoolean; }, z.core.$strict > >; }, z.core.$strict>;GitHubListPrReviewsResultSchema
Zod schema for the success shape of GitHubListPrReviewsResult.
import { GitHubListPrReviewsResultSchema } from '@loopstack/github';GitHubListPrReviewsResultSchema: z.ZodObject< { reviews: z.ZodArray< z.ZodObject< { id: z.ZodNumber; user: z.ZodString; body: z.ZodString; state: z.ZodString; submittedAt: z.ZodOptional<z.ZodString>; htmlUrl: z.ZodString; }, z.core.$strict > >; }, z.core.$strict>;GitHubListPullRequestsResultSchema
Zod schema for the success shape of GitHubListPullRequestsResult.
import { GitHubListPullRequestsResultSchema } from '@loopstack/github';GitHubListPullRequestsResultSchema: z.ZodObject< { pullRequests: z.ZodArray< z.ZodObject< { id: z.ZodNumber; number: z.ZodNumber; title: z.ZodString; state: z.ZodString; user: z.ZodString; head: z.ZodString; headSha: z.ZodString; base: z.ZodString; createdAt: z.ZodString; updatedAt: z.ZodString; htmlUrl: z.ZodString; draft: z.ZodBoolean; }, z.core.$strict > >; }, z.core.$strict>;GitHubListReposResultSchema
Zod schema for the success shape of GitHubListReposResult.
import { GitHubListReposResultSchema } from '@loopstack/github';GitHubListReposResultSchema: z.ZodObject< { repos: z.ZodArray< z.ZodObject< { id: z.ZodNumber; fullName: z.ZodString; name: z.ZodString; owner: z.ZodString; private: z.ZodBoolean; htmlUrl: z.ZodString; description: z.ZodNullable<z.ZodString>; language: z.ZodNullable<z.ZodString>; defaultBranch: z.ZodString; updatedAt: z.ZodString; }, z.core.$strict > >; }, z.core.$strict>;GitHubListUserOrgsResultSchema
Zod schema for the success shape of GitHubListUserOrgsResult.
import { GitHubListUserOrgsResultSchema } from '@loopstack/github';GitHubListUserOrgsResultSchema: z.ZodObject< { orgs: z.ZodArray< z.ZodObject< { id: z.ZodNumber; login: z.ZodString; description: z.ZodNullable<z.ZodString>; avatarUrl: z.ZodString; }, z.core.$strict > >; }, z.core.$strict>;GitHubListWorkflowRunsResultSchema
Zod schema for the success shape of GitHubListWorkflowRunsResult.
import { GitHubListWorkflowRunsResultSchema } from '@loopstack/github';GitHubListWorkflowRunsResultSchema: z.ZodObject< { totalCount: z.ZodNumber; runs: z.ZodArray< z.ZodObject< { id: z.ZodNumber; name: z.ZodString; status: z.ZodString; conclusion: z.ZodNullable<z.ZodString>; headBranch: z.ZodString; headSha: z.ZodString; event: z.ZodString; createdAt: z.ZodString; updatedAt: z.ZodString; htmlUrl: z.ZodString; }, z.core.$strict > >; }, z.core.$strict>;GitHubMergePullRequestResultSchema
Zod schema for the success shape of GitHubMergePullRequestResult.
import { GitHubMergePullRequestResultSchema } from '@loopstack/github';GitHubMergePullRequestResultSchema: z.ZodObject< { merge: z.ZodObject< { sha: z.ZodString; merged: z.ZodBoolean; message: z.ZodString; }, z.core.$strict >; }, z.core.$strict>;GitHubSearchCodeResultSchema
Zod schema for the success shape of GitHubSearchCodeResult.
import { GitHubSearchCodeResultSchema } from '@loopstack/github';GitHubSearchCodeResultSchema: z.ZodObject< { totalCount: z.ZodNumber; results: z.ZodArray< z.ZodObject< { name: z.ZodString; path: z.ZodString; sha: z.ZodString; htmlUrl: z.ZodString; repository: z.ZodString; }, z.core.$strict > >; }, z.core.$strict>;GitHubSearchIssuesResultSchema
Zod schema for the success shape of GitHubSearchIssuesResult.
import { GitHubSearchIssuesResultSchema } from '@loopstack/github';GitHubSearchIssuesResultSchema: z.ZodObject< { totalCount: z.ZodNumber; results: z.ZodArray< z.ZodObject< { id: z.ZodNumber; number: z.ZodNumber; title: z.ZodString; state: z.ZodString; user: z.ZodString; htmlUrl: z.ZodString; createdAt: z.ZodString; updatedAt: z.ZodString; isPullRequest: z.ZodBoolean; }, z.core.$strict > >; }, z.core.$strict>;GitHubSearchReposResultSchema
Zod schema for the success shape of GitHubSearchReposResult.
import { GitHubSearchReposResultSchema } from '@loopstack/github';GitHubSearchReposResultSchema: z.ZodObject< { totalCount: z.ZodNumber; results: z.ZodArray< z.ZodObject< { id: z.ZodNumber; fullName: z.ZodString; description: z.ZodNullable<z.ZodString>; htmlUrl: z.ZodString; language: z.ZodNullable<z.ZodString>; stars: z.ZodNumber; forks: z.ZodNumber; updatedAt: z.ZodString; }, z.core.$strict > >; }, z.core.$strict>;GitHubTriggerWorkflowResultSchema
Zod schema for the success shape of GitHubTriggerWorkflowResult.
import { GitHubTriggerWorkflowResultSchema } from '@loopstack/github';GitHubTriggerWorkflowResultSchema: z.ZodObject< { triggered: z.ZodBoolean; message: z.ZodString; }, z.core.$strict>;