@loopstack/github-module 0.2.3 → 0.2.4

package/src/tools/repos/github-create-repo.tool.ts

@@ -1,104 +0,0 @@
-import { Inject, Logger } from '@nestjs/common';
-import { z } from 'zod';
-import { BaseTool, Tool, ToolResult } from '@loopstack/common';
-import { OAuthTokenStore } from '@loopstack/oauth-module';
-
-const inputSchema = z
-  .object({
-    name: z.string(),
-    description: z.string().optional(),
-    private: z.boolean().default(false),
-    autoInit: z.boolean().default(false),
-  })
-  .strict();
-
-export type GitHubCreateRepoArgs = z.input<typeof inputSchema>;
-
-@Tool({
-  uiConfig: {
-    description:
-      'Creates a new GitHub repository for the authenticated user. Returns { error: "unauthorized" } if no valid token is available.',
-  },
-  schema: inputSchema,
-})
-export class GitHubCreateRepoTool extends BaseTool {
-  private readonly logger = new Logger(GitHubCreateRepoTool.name);
-
-  @Inject()
-  private tokenStore: OAuthTokenStore;
-
-  async call(args: GitHubCreateRepoArgs): Promise<ToolResult> {
-    const accessToken = await this.tokenStore.getValidAccessToken(this.ctx.context.userId, 'github');
-
-    if (!accessToken) {
-      return {
-        data: {
-          error: 'unauthorized',
-          message: 'No valid GitHub token found. Please authenticate first.',
-        },
-      };
-    }
-
-    const body: Record<string, unknown> = {
-      name: args.name,
-      private: args.private ?? false,
-      auto_init: args.autoInit ?? false,
-    };
-
-    if (args.description) body.description = args.description;
-
-    const response = await fetch('https://api.github.com/user/repos', {
-      method: 'POST',
-      headers: {
-        Authorization: `Bearer ${accessToken}`,
-        Accept: 'application/vnd.github+json',
-        'X-GitHub-Api-Version': '2022-11-28',
-        'Content-Type': 'application/json',
-      },
-      body: JSON.stringify(body),
-    });
-
-    if (response.status === 401 || response.status === 403) {
-      this.logger.warn(`GitHub API returned ${response.status} for user ${this.ctx.context.userId}`);
-      return {
-        data: {
-          error: '401',
-          message: 'GitHub token was rejected. Please re-authenticate.',
-        },
-      };
-    }
-
-    if (!response.ok) {
-      const errorBody = await response.text();
-      this.logger.error(`GitHub API error: ${response.status} ${errorBody}`);
-      return {
-        data: {
-          error: 'api_error',
-          message: `GitHub API error: ${response.statusText}`,
-        },
-      };
-    }
-
-    const repo = (await response.json()) as {
-      id: number;
-      full_name: string;
-      name: string;
-      html_url: string;
-      private: boolean;
-      default_branch: string;
-    };
-
-    return {
-      data: {
-        repo: {
-          id: repo.id,
-          fullName: repo.full_name,
-          name: repo.name,
-          htmlUrl: repo.html_url,
-          private: repo.private,
-          defaultBranch: repo.default_branch,
-        },
-      },
-    };
-  }
-}

package/src/tools/repos/github-get-repo.tool.ts

@@ -1,115 +0,0 @@
-import { Inject, Logger } from '@nestjs/common';
-import { z } from 'zod';
-import { BaseTool, Tool, ToolResult } from '@loopstack/common';
-import { OAuthTokenStore } from '@loopstack/oauth-module';
-
-const inputSchema = z
-  .object({
-    owner: z.string(),
-    repo: z.string(),
-  })
-  .strict();
-
-export type GitHubGetRepoArgs = z.infer<typeof inputSchema>;
-
-@Tool({
-  uiConfig: {
-    description:
-      'Gets detailed information about a specific GitHub repository. Returns { error: "unauthorized" } if no valid token is available.',
-  },
-  schema: inputSchema,
-})
-export class GitHubGetRepoTool extends BaseTool {
-  private readonly logger = new Logger(GitHubGetRepoTool.name);
-
-  @Inject()
-  private tokenStore: OAuthTokenStore;
-
-  async call(args: GitHubGetRepoArgs): Promise<ToolResult> {
-    const accessToken = await this.tokenStore.getValidAccessToken(this.ctx.context.userId, 'github');
-
-    if (!accessToken) {
-      return {
-        data: {
-          error: 'unauthorized',
-          message: 'No valid GitHub token found. Please authenticate first.',
-        },
-      };
-    }
-
-    const response = await fetch(
-      `https://api.github.com/repos/${encodeURIComponent(args.owner)}/${encodeURIComponent(args.repo)}`,
-      {
-        headers: {
-          Authorization: `Bearer ${accessToken}`,
-          Accept: 'application/vnd.github+json',
-          'X-GitHub-Api-Version': '2022-11-28',
-        },
-      },
-    );
-
-    if (response.status === 401 || response.status === 403) {
-      this.logger.warn(`GitHub API returned ${response.status} for user ${this.ctx.context.userId}`);
-      return {
-        data: {
-          error: '401',
-          message: 'GitHub token was rejected. Please re-authenticate.',
-        },
-      };
-    }
-
-    if (!response.ok) {
-      const body = await response.text();
-      this.logger.error(`GitHub API error: ${response.status} ${body}`);
-      return {
-        data: {
-          error: 'api_error',
-          message: `GitHub API error: ${response.statusText}`,
-        },
-      };
-    }
-
-    const repo = (await response.json()) as {
-      id: number;
-      full_name: string;
-      name: string;
-      owner: { login: string; avatar_url: string };
-      private: boolean;
-      html_url: string;
-      description: string | null;
-      language: string | null;
-      default_branch: string;
-      stargazers_count: number;
-      forks_count: number;
-      open_issues_count: number;
-      created_at: string;
-      updated_at: string;
-      topics: string[];
-      license: { spdx_id: string } | null;
-    };
-
-    return {
-      data: {
-        repo: {
-          id: repo.id,
-          fullName: repo.full_name,
-          name: repo.name,
-          owner: repo.owner.login,
-          ownerAvatar: repo.owner.avatar_url,
-          private: repo.private,
-          htmlUrl: repo.html_url,
-          description: repo.description,
-          language: repo.language,
-          defaultBranch: repo.default_branch,
-          stars: repo.stargazers_count,
-          forks: repo.forks_count,
-          openIssues: repo.open_issues_count,
-          createdAt: repo.created_at,
-          updatedAt: repo.updated_at,
-          topics: repo.topics,
-          license: repo.license?.spdx_id ?? null,
-        },
-      },
-    };
-  }
-}

package/src/tools/repos/github-list-branches.tool.ts

@@ -1,91 +0,0 @@
-import { Inject, Logger } from '@nestjs/common';
-import { z } from 'zod';
-import { BaseTool, Tool, ToolResult } from '@loopstack/common';
-import { OAuthTokenStore } from '@loopstack/oauth-module';
-
-const inputSchema = z
-  .object({
-    owner: z.string(),
-    repo: z.string(),
-    perPage: z.number().default(30),
-  })
-  .strict();
-
-export type GitHubListBranchesArgs = z.input<typeof inputSchema>;
-
-@Tool({
-  uiConfig: {
-    description:
-      'Lists branches for a GitHub repository. Returns { error: "unauthorized" } if no valid token is available.',
-  },
-  schema: inputSchema,
-})
-export class GitHubListBranchesTool extends BaseTool {
-  private readonly logger = new Logger(GitHubListBranchesTool.name);
-
-  @Inject()
-  private tokenStore: OAuthTokenStore;
-
-  async call(args: GitHubListBranchesArgs): Promise<ToolResult> {
-    const accessToken = await this.tokenStore.getValidAccessToken(this.ctx.context.userId, 'github');
-
-    if (!accessToken) {
-      return {
-        data: {
-          error: 'unauthorized',
-          message: 'No valid GitHub token found. Please authenticate first.',
-        },
-      };
-    }
-
-    const params = new URLSearchParams({
-      per_page: String(args.perPage ?? 30),
-    });
-
-    const url = `https://api.github.com/repos/${encodeURIComponent(args.owner)}/${encodeURIComponent(args.repo)}/branches?${params.toString()}`;
-    const response = await fetch(url, {
-      headers: {
-        Authorization: `Bearer ${accessToken}`,
-        Accept: 'application/vnd.github+json',
-        'X-GitHub-Api-Version': '2022-11-28',
-      },
-    });
-
-    if (response.status === 401 || response.status === 403) {
-      this.logger.warn(`GitHub API returned ${response.status} for user ${this.ctx.context.userId}`);
-      return {
-        data: {
-          error: '401',
-          message: 'GitHub token was rejected. Please re-authenticate.',
-        },
-      };
-    }
-
-    if (!response.ok) {
-      const body = await response.text();
-      this.logger.error(`GitHub API error: ${response.status} ${body}`);
-      return {
-        data: {
-          error: 'api_error',
-          message: `GitHub API error: ${response.statusText}`,
-        },
-      };
-    }
-
-    const data = (await response.json()) as Array<{
-      name: string;
-      commit: { sha: string };
-      protected: boolean;
-    }>;
-
-    const branches = data.map((branch) => ({
-      name: branch.name,
-      commitSha: branch.commit.sha,
-      protected: branch['protected'],
-    }));
-
-    return {
-      data: { branches },
-    };
-  }
-}

package/src/tools/repos/github-list-repos.tool.ts

@@ -1,108 +0,0 @@
-import { Inject, Logger } from '@nestjs/common';
-import { z } from 'zod';
-import { BaseTool, Tool, ToolResult } from '@loopstack/common';
-import { OAuthTokenStore } from '@loopstack/oauth-module';
-
-const inputSchema = z
-  .object({
-    visibility: z.enum(['all', 'public', 'private']).default('all'),
-    sort: z.enum(['created', 'updated', 'pushed', 'full_name']).default('updated'),
-    perPage: z.number().default(30),
-    page: z.number().default(1),
-  })
-  .strict();
-
-export type GitHubListReposArgs = z.input<typeof inputSchema>;
-
-@Tool({
-  uiConfig: {
-    description:
-      'Lists repositories for the authenticated GitHub user. Returns { error: "unauthorized" } if no valid token is available.',
-  },
-  schema: inputSchema,
-})
-export class GitHubListReposTool extends BaseTool {
-  private readonly logger = new Logger(GitHubListReposTool.name);
-
-  @Inject()
-  private tokenStore: OAuthTokenStore;
-
-  async call(args: GitHubListReposArgs): Promise<ToolResult> {
-    const accessToken = await this.tokenStore.getValidAccessToken(this.ctx.context.userId, 'github');
-
-    if (!accessToken) {
-      return {
-        data: {
-          error: 'unauthorized',
-          message: 'No valid GitHub token found. Please authenticate first.',
-        },
-      };
-    }
-
-    const params = new URLSearchParams({
-      visibility: args.visibility ?? 'all',
-      sort: args.sort ?? 'updated',
-      per_page: String(args.perPage ?? 30),
-      page: String(args.page ?? 1),
-    });
-
-    const response = await fetch(`https://api.github.com/user/repos?${params.toString()}`, {
-      headers: {
-        Authorization: `Bearer ${accessToken}`,
-        Accept: 'application/vnd.github+json',
-        'X-GitHub-Api-Version': '2022-11-28',
-      },
-    });
-
-    if (response.status === 401 || response.status === 403) {
-      this.logger.warn(`GitHub API returned ${response.status} for user ${this.ctx.context.userId}`);
-      return {
-        data: {
-          error: '401',
-          message: 'GitHub token was rejected. Please re-authenticate.',
-        },
-      };
-    }
-
-    if (!response.ok) {
-      const body = await response.text();
-      this.logger.error(`GitHub API error: ${response.status} ${body}`);
-      return {
-        data: {
-          error: 'api_error',
-          message: `GitHub API error: ${response.statusText}`,
-        },
-      };
-    }
-
-    const data = (await response.json()) as Array<{
-      id: number;
-      full_name: string;
-      name: string;
-      owner: { login: string };
-      private: boolean;
-      html_url: string;
-      description: string | null;
-      language: string | null;
-      default_branch: string;
-      updated_at: string;
-    }>;
-
-    const repos = data.map((repo) => ({
-      id: repo.id,
-      fullName: repo.full_name,
-      name: repo.name,
-      owner: repo.owner.login,
-      private: repo.private,
-      htmlUrl: repo.html_url,
-      description: repo.description,
-      language: repo.language,
-      defaultBranch: repo.default_branch,
-      updatedAt: repo.updated_at,
-    }));
-
-    return {
-      data: { repos },
-    };
-  }
-}

package/src/tools/search/github-search-code.tool.ts

@@ -1,99 +0,0 @@
-import { Inject, Logger } from '@nestjs/common';
-import { z } from 'zod';
-import { BaseTool, Tool, ToolResult } from '@loopstack/common';
-import { OAuthTokenStore } from '@loopstack/oauth-module';
-
-const inputSchema = z
-  .object({
-    query: z.string(),
-    perPage: z.number().default(30),
-    page: z.number().default(1),
-  })
-  .strict();
-
-export type GitHubSearchCodeArgs = z.input<typeof inputSchema>;
-
-@Tool({
-  uiConfig: {
-    description:
-      'Searches for code across GitHub repositories using the GitHub search syntax. Returns { error: "unauthorized" } if no valid token is available.',
-  },
-  schema: inputSchema,
-})
-export class GitHubSearchCodeTool extends BaseTool {
-  private readonly logger = new Logger(GitHubSearchCodeTool.name);
-
-  @Inject()
-  private tokenStore: OAuthTokenStore;
-
-  async call(args: GitHubSearchCodeArgs): Promise<ToolResult> {
-    const accessToken = await this.tokenStore.getValidAccessToken(this.ctx.context.userId, 'github');
-
-    if (!accessToken) {
-      return {
-        data: {
-          error: 'unauthorized',
-          message: 'No valid GitHub token found. Please authenticate first.',
-        },
-      };
-    }
-
-    const params = new URLSearchParams({
-      q: args.query,
-      per_page: String(args.perPage ?? 30),
-      page: String(args.page ?? 1),
-    });
-
-    const response = await fetch(`https://api.github.com/search/code?${params.toString()}`, {
-      headers: {
-        Authorization: `Bearer ${accessToken}`,
-        Accept: 'application/vnd.github+json',
-        'X-GitHub-Api-Version': '2022-11-28',
-      },
-    });
-
-    if (response.status === 401 || response.status === 403) {
-      this.logger.warn(`GitHub API returned ${response.status} for user ${this.ctx.context.userId}`);
-      return {
-        data: {
-          error: '401',
-          message: 'GitHub token was rejected. Please re-authenticate.',
-        },
-      };
-    }
-
-    if (!response.ok) {
-      const body = await response.text();
-      this.logger.error(`GitHub API error: ${response.status} ${body}`);
-      return {
-        data: {
-          error: 'api_error',
-          message: `GitHub API error: ${response.statusText}`,
-        },
-      };
-    }
-
-    const data = (await response.json()) as {
-      total_count: number;
-      items: Array<{
-        name: string;
-        path: string;
-        sha: string;
-        html_url: string;
-        repository: { full_name: string };
-      }>;
-    };
-
-    const results = data.items.map((item) => ({
-      name: item.name,
-      path: item.path,
-      sha: item.sha,
-      htmlUrl: item.html_url,
-      repository: item.repository.full_name,
-    }));
-
-    return {
-      data: { totalCount: data.total_count, results },
-    };
-  }
-}

package/src/tools/search/github-search-issues.tool.ts

@@ -1,113 +0,0 @@
-import { Inject, Logger } from '@nestjs/common';
-import { z } from 'zod';
-import { BaseTool, Tool, ToolResult } from '@loopstack/common';
-import { OAuthTokenStore } from '@loopstack/oauth-module';
-
-const inputSchema = z
-  .object({
-    query: z.string(),
-    sort: z
-      .enum(['comments', 'reactions', 'reactions-+1', 'reactions--1', 'interactions', 'created', 'updated'])
-      .optional(),
-    perPage: z.number().default(30),
-    page: z.number().default(1),
-  })
-  .strict();
-
-export type GitHubSearchIssuesArgs = z.input<typeof inputSchema>;
-
-@Tool({
-  uiConfig: {
-    description:
-      'Searches for issues and pull requests across GitHub using the GitHub search syntax. Returns { error: "unauthorized" } if no valid token is available.',
-  },
-  schema: inputSchema,
-})
-export class GitHubSearchIssuesTool extends BaseTool {
-  private readonly logger = new Logger(GitHubSearchIssuesTool.name);
-
-  @Inject()
-  private tokenStore: OAuthTokenStore;
-
-  async call(args: GitHubSearchIssuesArgs): Promise<ToolResult> {
-    const accessToken = await this.tokenStore.getValidAccessToken(this.ctx.context.userId, 'github');
-
-    if (!accessToken) {
-      return {
-        data: {
-          error: 'unauthorized',
-          message: 'No valid GitHub token found. Please authenticate first.',
-        },
-      };
-    }
-
-    const params = new URLSearchParams({
-      q: args.query,
-      per_page: String(args.perPage ?? 30),
-      page: String(args.page ?? 1),
-    });
-
-    if (args.sort) params.set('sort', args.sort);
-
-    const response = await fetch(`https://api.github.com/search/issues?${params.toString()}`, {
-      headers: {
-        Authorization: `Bearer ${accessToken}`,
-        Accept: 'application/vnd.github+json',
-        'X-GitHub-Api-Version': '2022-11-28',
-      },
-    });
-
-    if (response.status === 401 || response.status === 403) {
-      this.logger.warn(`GitHub API returned ${response.status} for user ${this.ctx.context.userId}`);
-      return {
-        data: {
-          error: '401',
-          message: 'GitHub token was rejected. Please re-authenticate.',
-        },
-      };
-    }
-
-    if (!response.ok) {
-      const body = await response.text();
-      this.logger.error(`GitHub API error: ${response.status} ${body}`);
-      return {
-        data: {
-          error: 'api_error',
-          message: `GitHub API error: ${response.statusText}`,
-        },
-      };
-    }
-
-    const data = (await response.json()) as {
-      total_count: number;
-      items: Array<{
-        id: number;
-        number: number;
-        title: string;
-        state: string;
-        user: { login: string };
-        html_url: string;
-        repository_url: string;
-        created_at: string;
-        updated_at: string;
-        pull_request?: unknown;
-      }>;
-    };
-
-    const results = data.items.map((item) => ({
-      id: item.id,
-      number: item.number,
-      title: item.title,
-      state: item.state,
-      user: item.user.login,
-      htmlUrl: item.html_url,
-      createdAt: item.created_at,
-      updatedAt: item.updated_at,
-      isPullRequest: !!item.pull_request,
-    }));
-
-    return {
-      data: { totalCount: data.total_count, results },
-    };
-  }
-}