diff -r 000000000000 -r 6474c204b198 toolkit/components/passwordmgr/nsILoginManagerPrompter.idl
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/toolkit/components/passwordmgr/nsILoginManagerPrompter.idl	Wed Dec 31 06:09:35 2014 +0100
@@ -0,0 +1,72 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+
+#include "nsISupports.idl"
+
+interface nsILoginInfo;
+interface nsIDOMWindow;
+
+[scriptable, uuid(68b3cb59-51b8-4c57-bd7f-b2ce955a593d)]
+
+interface nsILoginManagerPrompter : nsISupports {
+    /**
+     * Initialize the prompter. Must be called before using other interfaces.
+     *
+     * @param aWindow
+     *        The in which the user is doing some login-related action that's
+     *        resulting in a need to prompt them for something. The prompt
+     *        will be associated with this window (or, if a notification bar
+     *        is being used, topmost opener in some cases).
+     */
+    void init(in nsIDOMWindow aWindow);
+
+    /**
+     * Ask the user if they want to save a login (Yes, Never, Not Now)
+     *
+     * @param aLogin
+     *        The login to be saved.
+     */
+    void promptToSavePassword(in nsILoginInfo aLogin);
+
+    /**
+     * Ask the user if they want to change a login's password. If the
+     * user consents, modifyLogin() will be called.
+     *
+     * @param aOldLogin
+     *        The existing login (with the old password).
+     * @param aNewLogin
+     *        The new login.
+     */
+    void promptToChangePassword(in nsILoginInfo aOldLogin,
+                                in nsILoginInfo aNewLogin);
+
+    /**
+     * Ask the user if they want to change the password for one of
+     * multiple logins, when the caller can't determine exactly which
+     * login should be changed. If the user consents, modifyLogin() will
+     * be called.
+     *
+     * @param logins
+     *        An array of existing logins.
+     * @param count
+     *        (length of the array)
+     * @param aNewLogin
+     *        The new login.
+     *
+     * Note: Because the caller does not know the username of the login
+     *       to be changed, aNewLogin.username and aNewLogin.usernameField
+     *       will be set (using the user's selection) before modifyLogin()
+     *       is called.
+     */
+    void promptToChangePasswordWithUsernames(
+            [array, size_is(count)] in nsILoginInfo logins,
+            in uint32_t count,
+            in nsILoginInfo aNewLogin);
+};
+%{C++
+
+#define NS_LOGINMANAGERPROMPTER_CONTRACTID "@mozilla.org/login-manager/prompter/;1"
+
+%}