@aashari/mcp-server-atlassian-bitbucket/dist/tools/atlassian.workspaces.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_workspaces_types_js_1 = require("./atlassian.workspaces.types.js");
const atlassian_workspaces_controller_js_1 = __importDefault(require("../controllers/atlassian.workspaces.controller.js"));
// Create a contextualized logger for this file
const toolLogger = logger_util_js_1.Logger.forContext('tools/atlassian.workspaces.tool.ts');
// Log tool initialization
toolLogger.debug('Bitbucket workspaces tool initialized');
/**
 * MCP Tool: List Bitbucket Workspaces
 *
 * Lists Bitbucket workspaces available to the authenticated user with optional filtering.
 * Returns a formatted markdown response with workspace details.
 *
 * @param args - Tool arguments for filtering workspaces
 * @param _extra - Extra request handler information (unused)
 * @returns MCP response with formatted workspaces list
 * @throws Will return error message if workspace listing fails
 */
async function listWorkspaces(args, _extra) {
    const methodLogger = logger_util_js_1.Logger.forContext('tools/atlassian.workspaces.tool.ts', 'listWorkspaces');
    methodLogger.debug('Listing Bitbucket workspaces with filters:', args);
    try {
        // Pass the filter options to the controller
        const message = await atlassian_workspaces_controller_js_1.default.list({
            limit: args.limit,
            cursor: args.cursor,
        });
        methodLogger.debug('Successfully retrieved workspaces from controller', message);
        return {
            content: [
                {
                    type: 'text',
                    text: message.content,
                },
            ],
        };
    }
    catch (error) {
        methodLogger.error('Failed to list workspaces', error);
        return (0, error_util_js_1.formatErrorForMcpTool)(error);
    }
}
/**
 * MCP Tool: Get Bitbucket Workspace Details
 *
 * Retrieves detailed information about a specific Bitbucket workspace.
 * Returns a formatted markdown response with workspace metadata.
 *
 * @param args - Tool arguments containing the workspace slug
 * @param _extra - Extra request handler information (unused)
 * @returns MCP response with formatted workspace details
 * @throws Will return error message if workspace retrieval fails
 */
async function getWorkspace(args, _extra) {
    const methodLogger = logger_util_js_1.Logger.forContext('tools/atlassian.workspaces.tool.ts', 'getWorkspace');
    methodLogger.debug(`Retrieving workspace details for ${args.workspaceSlug}`, args);
    try {
        const message = await atlassian_workspaces_controller_js_1.default.get({
            workspaceSlug: args.workspaceSlug,
        });
        methodLogger.debug('Successfully retrieved workspace details from controller', message);
        return {
            content: [
                {
                    type: 'text',
                    text: message.content,
                },
            ],
        };
    }
    catch (error) {
        methodLogger.error('Failed to get workspace details', error);
        return (0, error_util_js_1.formatErrorForMcpTool)(error);
    }
}
/**
 * Register Atlassian Workspaces MCP Tools
 *
 * Registers the list-workspaces and get-workspace 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.workspaces.tool.ts', 'registerTools');
    methodLogger.debug('Registering Atlassian Workspaces tools...');
    // Register the list workspaces tool
    server.tool('list_workspaces', `List Bitbucket workspaces accessible to the authenticated user, with optional pagination.

        PURPOSE: Discover available workspaces and retrieve their slugs, names, and basic metadata. Essential for finding the correct 'workspaceSlug' needed as input for repository-related tools (list_repositories, get_repository, list_pull_requests, get_pull_request).

        WHEN TO USE:
        - To find the 'workspaceSlug' for a known workspace name.
        - To explore all workspaces you have access to.
        - To get a high-level overview before diving into specific repositories.
        - When you don't know the exact slug required by other tools.

        WHEN NOT TO USE:
        - When you already have the 'workspaceSlug'.
        - When you need detailed information about a *single* workspace (use 'get_workspace').
        - When you need repository or pull request information (use repository/pull_request tools with a known 'workspaceSlug').

        RETURNS: Formatted list of workspace memberships, including workspace name, slug, UUID, your permission level, and access dates. Includes pagination details if applicable.

        EXAMPLES:
        - List all accessible workspaces: {}
        - Paginate results: { limit: 10, cursor: "some-cursor-value" }

        ERRORS:
        - Authentication failures: Check Bitbucket credentials.
        - No workspaces found: You may not have access to any workspaces.`, atlassian_workspaces_types_js_1.ListWorkspacesToolArgs.shape, listWorkspaces);
    // Register the get workspace details tool
    server.tool('get_workspace', `Get detailed information about a specific Bitbucket workspace using its slug.

        PURPOSE: Retrieves comprehensive metadata for a *known* workspace, including UUID, name, type, creation date, and links to related resources like repositories and projects.

        WHEN TO USE:
        - When you need full details about a *specific* workspace and you already know its 'workspaceSlug'.
        - After using 'list_workspaces' to identify the target workspace slug.
        - To get quick links to a workspace's repositories, projects, or members page.

        WHEN NOT TO USE:
        - When you don't know the workspace slug (use 'list_workspaces' first).
        - When you only need a list of workspaces (use 'list_workspaces').
        - When you need information about repositories *within* the workspace (use repository tools).

        RETURNS: Detailed workspace information including slug, name, UUID, type, creation date, and links. Fetches all available details by default.

        EXAMPLES:
        - Get details for a workspace: { workspaceSlug: "my-dev-team" }

        ERRORS:
        - Workspace not found: Verify the 'workspaceSlug' is correct and exists.
        - Permission errors: Ensure you have access to view the specified workspace.`, atlassian_workspaces_types_js_1.GetWorkspaceToolArgs.shape, getWorkspace);
    methodLogger.debug('Successfully registered Atlassian Workspaces tools');
}
exports.default = { registerTools };