@aashari/mcp-server-atlassian-bitbucket/dist/tools/atlassian.pullrequests.tool.js

Node.js/TypeScript MCP server for Atlassian Bitbucket. Enables AI systems (LLMs) to interact with workspaces, repositories, and pull requests via tools (list, get, comment, search). Connects AI directly to version control workflows through the standard MC

"use strict";
var __importDefault = (this && this.__importDefault) || function (mod) {
    return (mod && mod.__esModule) ? mod : { "default": mod };
};
Object.defineProperty(exports, "__esModule", { value: true });
const logger_util_js_1 = require("../utils/logger.util.js");
const error_util_js_1 = require("../utils/error.util.js");
const atlassian_pullrequests_types_js_1 = require("./atlassian.pullrequests.types.js");
const atlassian_pullrequests_controller_js_1 = __importDefault(require("../controllers/atlassian.pullrequests.controller.js"));
// Create a contextualized logger for this file
const toolLogger = logger_util_js_1.Logger.forContext('tools/atlassian.pullrequests.tool.ts');
// Log tool initialization
toolLogger.debug('Bitbucket pull requests tool initialized');
/**
 * MCP Tool: List Bitbucket Pull Requests
 *
 * Lists pull requests for a specific repository with optional filtering.
 * Returns a formatted markdown response with pull request details.
 *
 * @param args - Tool arguments for filtering pull requests
 * @returns MCP response with formatted pull requests list
 * @throws Will return error message if pull request listing fails
 */
async function listPullRequests(args) {
    const methodLogger = logger_util_js_1.Logger.forContext('tools/atlassian.pullrequests.tool.ts', 'listPullRequests');
    methodLogger.debug('Listing Bitbucket pull requests with filters:', args);
    try {
        // Pass args directly to controller without any logic
        const result = await atlassian_pullrequests_controller_js_1.default.list(args);
        methodLogger.debug('Successfully retrieved pull requests from controller');
        return {
            content: [
                {
                    type: 'text',
                    text: result.content,
                },
            ],
        };
    }
    catch (error) {
        methodLogger.error('Failed to list pull requests', error);
        return (0, error_util_js_1.formatErrorForMcpTool)(error);
    }
}
/**
 * MCP Tool: Get Bitbucket Pull Request Details
 *
 * Retrieves detailed information about a specific pull request.
 * Returns a formatted markdown response with pull request details.
 *
 * @param args - Tool arguments containing the workspace, repository, and pull request identifiers
 * @returns MCP response with formatted pull request details
 * @throws Will return error message if pull request retrieval fails
 */
async function getPullRequest(args) {
    const methodLogger = logger_util_js_1.Logger.forContext('tools/atlassian.pullrequests.tool.ts', 'getPullRequest');
    methodLogger.debug('Getting Bitbucket pull request details:', args);
    try {
        // Pass args directly to controller
        const result = await atlassian_pullrequests_controller_js_1.default.get(args);
        methodLogger.debug('Successfully retrieved pull request details from controller');
        return {
            content: [
                {
                    type: 'text',
                    text: result.content,
                },
            ],
        };
    }
    catch (error) {
        methodLogger.error('Failed to get pull request details', error);
        return (0, error_util_js_1.formatErrorForMcpTool)(error);
    }
}
/**
 * MCP Tool: List Bitbucket Pull Request Comments
 *
 * Lists comments for a specific pull request, including general comments and inline code comments.
 * Returns a formatted markdown response with comment details.
 *
 * @param args - Tool arguments containing workspace, repository, and PR identifiers
 * @returns MCP response with formatted pull request comments
 * @throws Will return error message if comment retrieval fails
 */
async function listPullRequestComments(args) {
    const methodLogger = logger_util_js_1.Logger.forContext('tools/atlassian.pullrequests.tool.ts', 'listPullRequestComments');
    methodLogger.debug('Listing pull request comments:', args);
    try {
        // Pass args directly to controller
        const result = await atlassian_pullrequests_controller_js_1.default.listComments(args);
        methodLogger.debug('Successfully retrieved pull request comments from controller');
        return {
            content: [
                {
                    type: 'text',
                    text: result.content,
                },
            ],
        };
    }
    catch (error) {
        methodLogger.error('Failed to get pull request comments', error);
        return (0, error_util_js_1.formatErrorForMcpTool)(error);
    }
}
/**
 * MCP Tool: Add Bitbucket Pull Request Comment
 *
 * Adds a comment to a specific pull request, with support for general and inline comments.
 * Returns a success message as markdown.
 *
 * @param args - Tool arguments containing workspace, repository, PR ID, and comment content
 * @returns MCP response with formatted success message
 * @throws Will return error message if comment creation fails
 */
async function addPullRequestComment(args) {
    const methodLogger = logger_util_js_1.Logger.forContext('tools/atlassian.pullrequests.tool.ts', 'addPullRequestComment');
    methodLogger.debug('Adding pull request comment:', {
        ...args,
        content: `(length: ${args.content.length})`,
    });
    try {
        // Pass args directly to controller
        const result = await atlassian_pullrequests_controller_js_1.default.addComment(args);
        methodLogger.debug('Successfully added pull request comment via controller');
        return {
            content: [
                {
                    type: 'text',
                    text: result.content,
                },
            ],
        };
    }
    catch (error) {
        methodLogger.error('Failed to add pull request comment', error);
        return (0, error_util_js_1.formatErrorForMcpTool)(error);
    }
}
/**
 * MCP Tool: Create Bitbucket Pull Request
 *
 * Creates a new pull request between two branches in a Bitbucket repository.
 * Returns a formatted markdown response with the newly created pull request details.
 *
 * @param args - Tool arguments containing workspace, repository, source branch, destination branch, and title
 * @returns MCP response with formatted pull request details
 * @throws Will return error message if pull request creation fails
 */
async function addPullRequest(args) {
    const methodLogger = logger_util_js_1.Logger.forContext('tools/atlassian.pullrequests.tool.ts', 'addPullRequest');
    methodLogger.debug('Creating new pull request:', {
        ...args,
        description: args.description
            ? `(length: ${args.description.length})`
            : '(none)',
    });
    try {
        // Pass args directly to controller
        const result = await atlassian_pullrequests_controller_js_1.default.add(args);
        methodLogger.debug('Successfully created pull request via controller');
        return {
            content: [
                {
                    type: 'text',
                    text: result.content,
                },
            ],
        };
    }
    catch (error) {
        methodLogger.error('Failed to create pull request', error);
        return (0, error_util_js_1.formatErrorForMcpTool)(error);
    }
}
/**
 * MCP Tool: Update Bitbucket Pull Request
 *
 * Updates an existing pull request's title and/or description.
 * Returns a formatted markdown response with updated pull request details.
 *
 * @param args - Tool arguments for updating pull request
 * @returns MCP response with formatted updated pull request details
 * @throws Will return error message if pull request update fails
 */
async function updatePullRequest(args) {
    const methodLogger = logger_util_js_1.Logger.forContext('tools/atlassian.pullrequests.tool.ts', 'updatePullRequest');
    methodLogger.debug('Updating pull request:', {
        ...args,
        description: args.description
            ? `(length: ${args.description.length})`
            : '(unchanged)',
    });
    try {
        // Pass args directly to controller
        const result = await atlassian_pullrequests_controller_js_1.default.update(args);
        methodLogger.debug('Successfully updated pull request via controller');
        return {
            content: [
                {
                    type: 'text',
                    text: result.content,
                },
            ],
        };
    }
    catch (error) {
        methodLogger.error('Failed to update pull request', error);
        return (0, error_util_js_1.formatErrorForMcpTool)(error);
    }
}
/**
 * MCP Tool: Approve Bitbucket Pull Request
 *
 * Approves a pull request, marking it as approved by the current user.
 * Returns a formatted markdown response with approval confirmation.
 *
 * @param args - Tool arguments for approving pull request
 * @returns MCP response with formatted approval confirmation
 * @throws Will return error message if pull request approval fails
 */
async function approvePullRequest(args) {
    const methodLogger = logger_util_js_1.Logger.forContext('tools/atlassian.pullrequests.tool.ts', 'approvePullRequest');
    methodLogger.debug('Approving pull request:', args);
    try {
        // Pass args directly to controller
        const result = await atlassian_pullrequests_controller_js_1.default.approve(args);
        methodLogger.debug('Successfully approved pull request via controller');
        return {
            content: [
                {
                    type: 'text',
                    text: result.content,
                },
            ],
        };
    }
    catch (error) {
        methodLogger.error('Failed to approve pull request', error);
        return (0, error_util_js_1.formatErrorForMcpTool)(error);
    }
}
/**
 * MCP Tool: Request Changes on Bitbucket Pull Request
 *
 * Requests changes on a pull request, marking it as requiring changes by the current user.
 * Returns a formatted markdown response with rejection confirmation.
 *
 * @param args - Tool arguments for requesting changes on pull request
 * @returns MCP response with formatted rejection confirmation
 * @throws Will return error message if pull request rejection fails
 */
async function rejectPullRequest(args) {
    const methodLogger = logger_util_js_1.Logger.forContext('tools/atlassian.pullrequests.tool.ts', 'rejectPullRequest');
    methodLogger.debug('Requesting changes on pull request:', args);
    try {
        // Pass args directly to controller
        const result = await atlassian_pullrequests_controller_js_1.default.reject(args);
        methodLogger.debug('Successfully requested changes on pull request via controller');
        return {
            content: [
                {
                    type: 'text',
                    text: result.content,
                },
            ],
        };
    }
    catch (error) {
        methodLogger.error('Failed to request changes on pull request', error);
        return (0, error_util_js_1.formatErrorForMcpTool)(error);
    }
}
/**
 * Register Atlassian Pull Requests MCP Tools
 *
 * Registers the pull requests-related tools with the MCP server.
 * Each tool is registered with its schema, description, and handler function.
 *
 * @param server - The MCP server instance to register tools with
 */
function registerTools(server) {
    const methodLogger = logger_util_js_1.Logger.forContext('tools/atlassian.pullrequests.tool.ts', 'registerTools');
    methodLogger.debug('Registering Atlassian Pull Requests tools...');
    // Register the list pull requests tool
    server.tool('bb_ls_prs', `Lists pull requests within a repository (\`repoSlug\`). If \`workspaceSlug\` is not provided, the system will use your default workspace. Filters by \`state\` (OPEN, MERGED, DECLINED, SUPERSEDED) and supports text search via \`query\`. Supports pagination via \`limit\` and \`cursor\`. Pagination details are included at the end of the text content. Returns a formatted Markdown list with each PR's title, status, author, reviewers, and creation date. Requires Bitbucket credentials to be configured.`, atlassian_pullrequests_types_js_1.ListPullRequestsToolArgs.shape, listPullRequests);
    // Register the get pull request tool
    server.tool('bb_get_pr', `Retrieves detailed information about a specific pull request identified by \`prId\` within a repository (\`repoSlug\`). If \`workspaceSlug\` is not provided, the system will use your default workspace. Includes PR details, status, reviewers, and diff statistics. Set \`includeFullDiff\` to true (default) for the complete code changes. Set \`includeComments\` to true to also retrieve comments (default: false; Note: Enabling this may increase response time for pull requests with many comments). Returns rich information as formatted Markdown, including PR summary, code changes, and optionally comments. Requires Bitbucket credentials to be configured.`, atlassian_pullrequests_types_js_1.GetPullRequestToolArgs.shape, getPullRequest);
    // Register the list pull request comments tool
    server.tool('bb_ls_pr_comments', `Lists comments on a specific pull request identified by \`prId\` within a repository (\`repoSlug\`). If \`workspaceSlug\` is not provided, the system will use your default workspace. Retrieves both general PR comments and inline code comments, indicating their location if applicable. Supports pagination via \`limit\` and \`cursor\`. Pagination details are included at the end of the text content. Returns a formatted Markdown list with each comment's author, timestamp, content, and location for inline comments. Requires Bitbucket credentials to be configured.`, atlassian_pullrequests_types_js_1.ListPullRequestCommentsToolArgs.shape, listPullRequestComments);
    // Register the add pull request comment tool
    server.tool('bb_add_pr_comment', `Adds a comment to a specific pull request identified by \`prId\` within a repository (\`repoSlug\`). If \`workspaceSlug\` is not provided, the system will use your default workspace. The \`content\` parameter accepts Markdown-formatted text for the comment body. To reply to an existing comment, provide its ID in the \`parentId\` parameter. For inline code comments, provide both \`inline.path\` (file path) and \`inline.line\` (line number). Returns a success message as formatted Markdown. Requires Bitbucket credentials with write permissions to be configured.`, atlassian_pullrequests_types_js_1.CreatePullRequestCommentToolArgs.shape, addPullRequestComment);
    // Register the create pull request tool
    server.tool('bb_add_pr', `Creates a new pull request in a repository (\`repoSlug\`). If \`workspaceSlug\` is not provided, the system will use your default workspace. Required parameters include \`title\`, \`sourceBranch\` (branch with changes), and optionally \`destinationBranch\` (target branch, defaults to main/master). The \`description\` parameter accepts Markdown-formatted text for the PR description. Set \`closeSourceBranch\` to true to automatically delete the source branch after merging. Returns the newly created pull request details as formatted Markdown. Requires Bitbucket credentials with write permissions to be configured.`, atlassian_pullrequests_types_js_1.CreatePullRequestToolArgs.shape, addPullRequest);
    // Register the update pull request tool
    server.tool('bb_update_pr', `Updates an existing pull request in a repository (\`repoSlug\`) identified by \`pullRequestId\`. If \`workspaceSlug\` is not provided, the system will use your default workspace. You can update the \`title\` and/or \`description\` fields. At least one field must be provided. The \`description\` parameter accepts Markdown-formatted text. Returns the updated pull request details as formatted Markdown. Requires Bitbucket credentials with write permissions to be configured.`, atlassian_pullrequests_types_js_1.UpdatePullRequestToolArgs.shape, updatePullRequest);
    // Register the approve pull request tool
    server.tool('bb_approve_pr', `Approves a pull request in a repository (\`repoSlug\`) identified by \`pullRequestId\`. If \`workspaceSlug\` is not provided, the system will use your default workspace. This marks the pull request as approved by the current user, indicating that the changes are ready for merge (pending any other required approvals or checks). Returns an approval confirmation as formatted Markdown. Requires Bitbucket credentials with appropriate permissions to be configured.`, atlassian_pullrequests_types_js_1.ApprovePullRequestToolArgs.shape, approvePullRequest);
    // Register the reject pull request tool
    server.tool('bb_reject_pr', `Requests changes on a pull request in a repository (\`repoSlug\`) identified by \`pullRequestId\`. If \`workspaceSlug\` is not provided, the system will use your default workspace. This marks the pull request as requiring changes by the current user, indicating that the author should address feedback before the pull request can be merged. Returns a rejection confirmation as formatted Markdown. Requires Bitbucket credentials with appropriate permissions to be configured.`, atlassian_pullrequests_types_js_1.RejectPullRequestToolArgs.shape, rejectPullRequest);
    methodLogger.debug('Successfully registered Pull Requests tools');
}
exports.default = { registerTools };