jira_get_current_user

Instructions

Implementation Reference

• src/features/jira/users/handlers/get-current-user.handler.ts:17-78 (handler)

  GetCurrentUserHandler class that implements the core execution logic for the jira_get_current_user tool. Calls the use case to fetch user data and formats the response using UserProfileFormatter.

  export class GetCurrentUserHandler extends BaseToolHandler<
    Record<string, never>,
    string
  > {
    private formatter: UserProfileFormatter;
  
    /**
     * Create a new GetCurrentUserHandler with use case
     *
     * @param getCurrentUserUseCase - Use case for retrieving current user profile
     */
    constructor(private readonly getCurrentUserUseCase: GetCurrentUserUseCase) {
      super("JIRA", "Get Current User");
      this.formatter = new UserProfileFormatter();
    }
  
    /**
     * Execute the handler logic
     * Retrieves current user profile and formats it
     */
    protected async execute(): Promise<string> {
      try {
        this.logger.info("Getting current user profile");
  
        // Get current user using use case
        const response = await this.getCurrentUserUseCase.execute();
  
        // Format user profile using the formatter
        return this.formatter.format(response.user);
      } catch (error) {
        this.logger.error(`Failed to get current user: ${error}`);
        throw this.enhanceError(error);
      }
    }
  
    /**
     * Enhance error messages for better user guidance
     */
    private enhanceError(error: unknown): Error {
      if (error instanceof JiraPermissionError) {
        return new Error(
          "❌ **Permission Denied**\n\nYou don't have permission to access user profile information.\n\n**Solutions:**\n- Check your JIRA authentication\n- Verify your API token is valid\n- Contact your JIRA administrator\n\n**Required Permissions:** Valid JIRA authentication",
        );
      }
  
      if (error instanceof JiraApiError) {
        return new Error(
          `❌ **JIRA API Error**\n\n${error.message}\n\n**Solutions:**\n- Check your JIRA connection\n- Verify your authentication credentials\n- Try again in a few moments\n\n**Example:** \`jira_get_current_user\``,
        );
      }
  
      if (error instanceof Error) {
        return new Error(
          `❌ **User Profile Retrieval Failed**\n\n${error.message}\n\n**Solutions:**\n- Check your JIRA connection\n- Verify your authentication\n- Try again in a few moments\n\n**Example:** \`jira_get_current_user\``,
        );
      }
  
      return new Error(
        "❌ **Unknown Error**\n\nAn unknown error occurred during user profile retrieval.\n\nPlease check your connection and try again.",
      );
    }
  }

• src/features/jira/tools/factories/tool.factory.ts:212-216 (handler)

  Factory function creates the jira_get_current_user tool handler object by wrapping the GetCurrentUserHandler's handle method.

  return {
    jira_get_current_user: {
      handle: async (args: unknown) => getCurrentUserHandler.handle(args),
    },
  };

• src/features/jira/tools/configs/user-tools.config.ts:18-23 (registration)

  ToolConfig object defining the name, description, input schema (empty params), and handler binding for registration.

  {
    name: "jira_get_current_user",
    description: "Get current user profile information and permissions",
    params: {},
    handler: tools.jira_get_current_user.handle.bind(tools.jira_get_current_user),
  },

• src/features/jira/tools/registry/tool.registry.ts:104-106 (registration)

  Configuration group for user tools passed to registry, which calls server.tool() to register with MCP server.

  configs: createUserToolsConfig({
    jira_get_current_user: tools.jira_get_current_user,
  }),

• src/features/jira/tools/types/jira-tools.interface.ts:39-40 (schema)

  TypeScript interface definition for the jira_get_current_user tool handler in JiraTools interface.

    jira_get_current_user: ToolHandler;
  }