webext-schema 5.3.2 → 5.3.4

package/schemas/mail/mailext.json

@@ -112,7 +112,7 @@
             },
             {
               "name": "tab",
-              "$ref": "tags.Tab",
+              "$ref": "tabs.Tab",
               "optional": true,
               "description": "Details of the $(ref:tabs.Tab) where the command was activated."
             }
@@ -357,13 +357,23 @@
             "matchAboutBlank": {
               "type": "boolean",
               "optional": true,
-              "description": "If matchAboutBlank is true, then the code is also injected in about:blank and about:srcdoc frames if your extension has access to its parent document. Code cannot be inserted in top-level about:-frames. By default it is <code>false</code>."
+              "description": "If matchAboutBlank is true, then the code is also injected in about:blank and about:srcdoc frames if your extension has access to its parent document. Ignored if matchOriginAsFallback is specified. By default it is <code>false</code>."
+            },
+            "matchOriginAsFallback": {
+              "type": "boolean",
+              "optional": true,
+              "description": "If matchOriginAsFallback is true, then the code is also injected in about:, data:, blob: when their origin matches the pattern in 'matches', even if the actual document origin is opaque (due to the use of CSP sandbox or iframe sandbox). Match patterns in 'matches' must specify a wildcard path glob. By default it is <code>false</code>."
             },
             "runAt": {
               "$ref": "extensionTypes.RunAt",
               "optional": true,
               "description": "The soonest that the JavaScript or CSS will be injected into the tab. Defaults to \"document_idle\"."
             },
+            "world": {
+              "$ref": "extensionTypes.ExecutionWorld",
+              "optional": true,
+              "description": "The JavaScript world for a script to execute within. Defaults to \"ISOLATED\"."
+            },
             "cookieStoreId": {
               "choices": [
                 {
@@ -3155,15 +3165,45 @@
         {
           "name": "list",
           "type": "function",
+          "min_manifest_version": 3,
+          "description": "Returns all mail accounts. They will be returned in the same order as used in Thunderbird's folder pane.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "includeFolders",
+              "optional": true,
+              "default": false,
+              "type": "boolean",
+              "description": "Specifies whether the returned :ref:`accounts.MailAccount` objects should include their account's folders. Defaults to <value>false</value>."
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "type": "array",
+                  "items": {
+                    "$ref": "accounts.MailAccount"
+                  }
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "list",
+          "type": "function",
+          "max_manifest_version": 2,
           "description": "Returns all mail accounts. They will be returned in the same order as used in Thunderbird's folder pane.",
           "async": "callback",
           "parameters": [
             {
               "name": "includeFolders",
-              "description": "Specifies whether the returned :ref:`accounts.MailAccount` objects should included their account's folders. Defaults to <value>true</value>.",
               "optional": true,
               "default": true,
-              "type": "boolean"
+              "type": "boolean",
+              "description": "Specifies whether the returned :ref:`accounts.MailAccount` objects should include their account's folders. Defaults to <value>true</value>."
             },
             {
               "type": "function",
@@ -3183,6 +3223,38 @@
         {
           "name": "get",
           "type": "function",
+          "min_manifest_version": 3,
+          "description": "Returns details of the requested account, or <value>null</value> if it doesn't exist.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "accountId",
+              "$ref": "MailAccountId"
+            },
+            {
+              "name": "includeFolders",
+              "optional": true,
+              "default": false,
+              "type": "boolean",
+              "description": "Specifies whether the returned :ref:`accounts.MailAccount` object should included the account's folders. Defaults to <value>false</value>."
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "$ref": "accounts.MailAccount",
+                  "optional": true
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "get",
+          "type": "function",
+          "max_manifest_version": 2,
           "description": "Returns details of the requested account, or <value>null</value> if it doesn't exist.",
           "async": "callback",
           "parameters": [
@@ -3192,10 +3264,10 @@
             },
             {
               "name": "includeFolders",
-              "description": "Specifies whether the returned :ref:`accounts.MailAccount` object should included the account's folders. Defaults to <value>true</value>.",
               "optional": true,
               "default": true,
-              "type": "boolean"
+              "type": "boolean",
+              "description": "Specifies whether the returned :ref:`accounts.MailAccount` object should included the account's folders. Defaults to <value>true</value>."
             },
             {
               "type": "function",
@@ -3711,25 +3783,25 @@
               "type": "boolean",
               "optional": true,
               "default": true,
-              "description": "Whether to include results from local address books. Defaults to true."
+              "description": "Whether to include results from local address books. Defaults to <value>true</value>."
             },
             "includeRemote": {
               "type": "boolean",
               "optional": true,
               "default": true,
-              "description": "Whether to include results from remote address books. Defaults to true."
+              "description": "Whether to include results from remote address books. Defaults to <value>true</value>."
             },
             "includeReadOnly": {
               "type": "boolean",
               "optional": true,
               "default": true,
-              "description": "Whether to include results from read-only address books. Defaults to true."
+              "description": "Whether to include results from read-only address books. Defaults to <value>true</value>."
             },
             "includeReadWrite": {
               "type": "boolean",
               "optional": true,
               "default": true,
-              "description": "Whether to include results from read-write address books. Defaults to true."
+              "description": "Whether to include results from read-write address books. Defaults to <value>true</value>."
             }
           }
         },
@@ -3762,7 +3834,12 @@
               "description": "Indicates if the object came from a remote address book."
             },
             "properties": {
+              "max_manifest_version": 2,
               "$ref": "ContactProperties"
+            },
+            "vCard": {
+              "min_manifest_version": 3,
+              "type": "string"
             }
           }
         },
@@ -3982,6 +4059,7 @@
         {
           "name": "create",
           "type": "function",
+          "max_manifest_version": 2,
           "async": "callback",
           "parameters": [
             {
@@ -4013,9 +4091,40 @@
           ],
           "description": "Adds a new contact to the address book with the id ``parentId``."
         },
+        {
+          "name": "create",
+          "type": "function",
+          "min_manifest_version": 3,
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "parentId",
+              "type": "string"
+            },
+            {
+              "name": "vCard",
+              "min_manifest_version": 3,
+              "type": "string",
+              "description": "The vCard for the new contact. If it includes an (optional) id and an existing contact has this id already, an exception is thrown."
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "type": "string",
+                  "description": "The ID of the new contact."
+                }
+              ]
+            }
+          ],
+          "description": "Adds a new contact to the address book with the id ``parentId``."
+        },
         {
           "name": "update",
           "type": "function",
+          "max_manifest_version": 2,
           "async": true,
           "parameters": [
             {
@@ -4030,6 +4139,24 @@
           ],
           "description": "Updates a contact."
         },
+        {
+          "name": "update",
+          "type": "function",
+          "min_manifest_version": 3,
+          "async": true,
+          "parameters": [
+            {
+              "name": "id",
+              "type": "string"
+            },
+            {
+              "name": "vCard",
+              "type": "string",
+              "description": "The updated vCard for the contact."
+            }
+          ],
+          "description": "Updates a contact."
+        },
         {
           "name": "delete",
           "type": "function",
@@ -4058,6 +4185,7 @@
         {
           "name": "onUpdated",
           "type": "function",
+          "max_manifest_version": 2,
           "description": "Fired when a contact is changed.",
           "parameters": [
             {
@@ -4070,6 +4198,22 @@
             }
           ]
         },
+        {
+          "name": "onUpdated",
+          "type": "function",
+          "min_manifest_version": 3,
+          "description": "Fired when a contact is changed.",
+          "parameters": [
+            {
+              "name": "node",
+              "$ref": "ContactNode"
+            },
+            {
+              "name": "oldVCard",
+              "type": "string"
+            }
+          ]
+        },
         {
           "name": "onDeleted",
           "type": "function",
@@ -4824,7 +4968,7 @@
                   "type": "integer",
                   "optional": true,
                   "minimum": 0,
-                  "description": "Specifies for which tab the label should be retrieved. If no tab is specified, the global label is retrieved."
+                  "description": "Specifies for which tab the label should be retrieved. If no tab is specified, the global value is retrieved."
                 },
                 "windowId": {
                   "type": "integer",
@@ -5045,7 +5189,86 @@
                   "type": "integer",
                   "optional": true,
                   "minimum": 0,
-                  "description": "Specifies for which tab the badge text should be retrieved. If no tab is specified, the global label is retrieved."
+                  "description": "Specifies for which tab the badge text should be retrieved. If no tab is specified, the global value is retrieved."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
+                }
+              }
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "name": "result",
+                  "type": "string"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "setBadgeTextColor",
+          "type": "function",
+          "description": "Sets the text color for the badge.",
+          "async": true,
+          "parameters": [
+            {
+              "name": "details",
+              "type": "object",
+              "properties": {
+                "color": {
+                  "choices": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "$ref": "ColorArray"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The color to use as text color in the badge. Cleared by setting it to <value>null</value>."
+                },
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Sets the text color for the badge only for the given tab."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
+                }
+              }
+            }
+          ]
+        },
+        {
+          "name": "getBadgeTextColor",
+          "type": "function",
+          "description": "Gets the text color of the badge.",
+          "async": true,
+          "parameters": [
+            {
+              "name": "details",
+              "type": "object",
+              "properties": {
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Specifies for which tab the badge text color should be retrieved. If no tab is specified, the global value is retrieved."
                 },
                 "windowId": {
                   "type": "integer",
@@ -5091,7 +5314,7 @@
                       "type": "null"
                     }
                   ],
-                  "description": "The color to use as background in the badge. Cleared by setting it to <value>null</value> or an empty string."
+                  "description": "The color to use as background in the badge. Cleared by setting it to <value>null</value>."
                 },
                 "tabId": {
                   "type": "integer",
@@ -5130,7 +5353,7 @@
                   "type": "integer",
                   "optional": true,
                   "minimum": 0,
-                  "description": "Specifies for which tab the badge background color should be retrieved. If no tab is specified, the global label is retrieved."
+                  "description": "Specifies for which tab the badge background color should be retrieved. If no tab is specified, the global value is retrieved."
                 },
                 "windowId": {
                   "type": "integer",
@@ -6042,7 +6265,13 @@
               "properties": {
                 "id": {
                   "type": "string",
-                  "description": "The ID of a contact or mailing list from the :doc:`contacts` and :doc:`mailingLists`."
+                  "max_manifest_version": 2,
+                  "description": "The ID of a contact or mailing list from the :doc:`contacts` or :doc:`mailingLists`."
+                },
+                "nodeId": {
+                  "type": "string",
+                  "min_manifest_version": 3,
+                  "description": "The ID of a contact or mailing list node from the :doc:`addressBook.contacts` or :doc:`addressBook.mailingLists`."
                 },
                 "type": {
                   "type": "string",
@@ -6115,6 +6344,11 @@
               "description": "An additional fcc folder which can be selected while composing the message, an empty string if not used.",
               "optional": true
             },
+            "attachPublicPGPKey": {
+              "type": "boolean",
+              "optional": true,
+              "description": "Whether the public OpenPGP key of the sending identity should be attached to the message."
+            },
             "attachVCard": {
               "type": "boolean",
               "optional": true,
@@ -6172,6 +6406,18 @@
               "optional": true,
               "description": "Let the sender know when the recipient's server received the message. Not supported by all servers."
             },
+            "selectedEncryptionTechnology": {
+              "choices": [
+                {
+                  "$ref": "compose.EncryptionPropertiesSMIME"
+                },
+                {
+                  "$ref": "compose.EncryptionPropertiesOpenPGP"
+                }
+              ],
+              "optional": true,
+              "description": "The selected encryption technology (<value>OpenPGP</value> or <value>S/MIME</value>) which is to be used to sign and/or encrypt the message. If the sending identity does not support encryption at all, this will be <value>undefined</value>."
+            },
             "followupTo": {
               "$ref": "ComposeRecipientList",
               "optional": true
@@ -6356,6 +6602,46 @@
             "type": "boolean"
           },
           "description": "A <em>dictionary object</em> with entries for all installed dictionaries, having a language identifier as <em>key</em> (for example <value>en-US</value>) and a boolean expression as <em>value</em>, indicating whether that dictionary is enabled for spellchecking or not."
+        },
+        {
+          "id": "EncryptionPropertiesOpenPGP",
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string",
+              "pattern": "^OpenPGP$"
+            },
+            "encryptBody": {
+              "type": "boolean",
+              "description": "Whether encryption of the message body using the OpenPGP technology is enabled. **Note:** If encryption is enabled, but the `preconditions <https://support.mozilla.org/en-US/kb/thunderbird-help-cannot-encrypt>`__ for sending an encrypted message are not met, the message cannot be sent."
+            },
+            "encryptSubject": {
+              "type": "boolean",
+              "description": "Whether encryption of the message subject using the OpenPGP technology is enabled (only supported if encryption of the body is enabled a well)."
+            },
+            "signMessage": {
+              "type": "boolean",
+              "description": "Whether the message will be signed using the OpenPGP technology."
+            }
+          }
+        },
+        {
+          "id": "EncryptionPropertiesSMIME",
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string",
+              "pattern": "^S/MIME$"
+            },
+            "encryptBody": {
+              "type": "boolean",
+              "description": "Whether encryption of the message body using the S/MIME technology is enabled. **Note:** If encryption is enabled, but the `preconditions <https://support.mozilla.org/en-US/kb/thunderbird-help-cannot-encrypt>`__ for sending an encrypted message are not met, the message cannot be sent."
+            },
+            "signMessage": {
+              "type": "boolean",
+              "description": "Whether the message will be signed using the S/MIME technology"
+            }
+          }
         }
       ],
       "events": [
@@ -6702,7 +6988,7 @@
           "name": "setComposeDetails",
           "type": "function",
           "async": true,
-          "description": "Updates the compose window. The properties of the given :ref:`compose.ComposeDetails` object will be used to overwrite the current values of the specified compose window, so only properties that are to be changed should be included.\n\nWhen updating any of the array properties (``customHeaders`` and most address fields), make sure to first get the current values to not accidentally remove all existing entries when setting the new value.\n\n**Note:** The compose format of an existing compose window cannot be changed. Since Thunderbird 98, setting conflicting values for ``details.body``, ``details.plainTextBody`` or ``details.isPlaintext`` no longer throws an exception, instead the compose window chooses the matching ``details.body`` or ``details.plainTextBody`` value and ignores the other.",
+          "description": "Updates the compose window. The properties of the given :ref:`compose.ComposeDetails` object will be used to overwrite the current values of the specified compose window, so only properties that are to be changed should be included. Modified settings will be treated as user initiated, and turn off further automatic changes on these settings.\n\nWhen updating any of the array properties (``customHeaders`` and most address fields), make sure to first get the current values to not accidentally remove all existing entries when setting the new value.\n\n**Note:** The compose format of an existing compose window cannot be changed. Since Thunderbird 98, setting conflicting values for ``details.body``, ``details.plainTextBody`` or ``details.isPlaintext`` no longer throws an exception, instead the compose window chooses the matching ``details.body`` or ``details.plainTextBody`` value and ignores the other.",
           "permissions": [
             "compose"
           ],
@@ -7339,7 +7625,7 @@
                   "type": "integer",
                   "optional": true,
                   "minimum": 0,
-                  "description": "Specifies for which tab the label should be retrieved. If no tab is specified, the global label is retrieved."
+                  "description": "Specifies for which tab the label should be retrieved. If no tab is specified, the global value is retrieved."
                 },
                 "windowId": {
                   "type": "integer",
@@ -7560,7 +7846,7 @@
                   "type": "integer",
                   "optional": true,
                   "minimum": 0,
-                  "description": "Specifies for which tab the badge text should be retrieved. If no tab is specified, the global label is retrieved."
+                  "description": "Specifies for which tab the badge text should be retrieved. If no tab is specified, the global value is retrieved."
                 },
                 "windowId": {
                   "type": "integer",
@@ -7585,10 +7871,10 @@
           ]
         },
         {
-          "name": "setBadgeBackgroundColor",
+          "name": "setBadgeTextColor",
           "type": "function",
-          "description": "Sets the background color for the badge.",
-          "async": "callback",
+          "description": "Sets the text color for the badge.",
+          "async": true,
           "parameters": [
             {
               "name": "details",
@@ -7606,13 +7892,13 @@
                       "type": "null"
                     }
                   ],
-                  "description": "The color to use as background in the badge. Cleared by setting it to <value>null</value> or an empty string."
+                  "description": "The color to use as text color in the badge. Cleared by setting it to <value>null</value>."
                 },
                 "tabId": {
                   "type": "integer",
                   "optional": true,
                   "minimum": 0,
-                  "description": "Sets the background color for the badge only for the given tab."
+                  "description": "Sets the text color for the badge only for the given tab."
                 },
                 "windowId": {
                   "type": "integer",
@@ -7622,9 +7908,88 @@
                   "description": "Will throw an error if used."
                 }
               }
-            },
-            {
-              "type": "function",
+            }
+          ]
+        },
+        {
+          "name": "getBadgeTextColor",
+          "type": "function",
+          "description": "Gets the text color of the badge.",
+          "async": true,
+          "parameters": [
+            {
+              "name": "details",
+              "type": "object",
+              "properties": {
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Specifies for which tab the badge text color should be retrieved. If no tab is specified, the global value is retrieved."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
+                }
+              }
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "name": "result",
+                  "type": "string"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "setBadgeBackgroundColor",
+          "type": "function",
+          "description": "Sets the background color for the badge.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "details",
+              "type": "object",
+              "properties": {
+                "color": {
+                  "choices": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "$ref": "ColorArray"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The color to use as background in the badge. Cleared by setting it to <value>null</value>."
+                },
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Sets the background color for the badge only for the given tab."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
+                }
+              }
+            },
+            {
+              "type": "function",
               "name": "callback",
               "optional": true,
               "parameters": []
@@ -7645,7 +8010,7 @@
                   "type": "integer",
                   "optional": true,
                   "minimum": 0,
-                  "description": "Specifies for which tab the badge background color should be retrieved. If no tab is specified, the global label is retrieved."
+                  "description": "Specifies for which tab the badge background color should be retrieved. If no tab is specified, the global value is retrieved."
                 },
                 "windowId": {
                   "type": "integer",
@@ -8079,7 +8444,7 @@
             "quota": {
               "type": "array",
               "items": {
-                "$ref": "MailFolderQuota"
+                "$ref": "folders.MailFolderQuota"
               },
               "optional": true,
               "description": "Quota information, if available."
@@ -8405,19 +8770,80 @@
         {
           "name": "get",
           "type": "function",
+          "min_manifest_version": 3,
           "description": "Returns the specified folder.",
           "async": "callback",
           "parameters": [
             {
-              "name": "folder",
+              "name": "folderId",
+              "$ref": "folders.MailFolderId"
+            },
+            {
+              "name": "includeSubFolders",
+              "optional": true,
+              "type": "boolean",
+              "default": false,
+              "description": "Specifies whether the returned :ref:`folders.MailFolder` object should include all its nested subfolders. Defaults to <value>false</value>."
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "$ref": "folders.MailFolder"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "get",
+          "type": "function",
+          "max_manifest_version": 2,
+          "description": "Returns the specified folder.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "folderId",
               "$ref": "folders.MailFolderId"
             },
             {
               "name": "includeSubFolders",
-              "description": "Specifies whether the returned :ref:`folders.MailFolder` object should include all its nested subfolders . Defaults to <value>true</value>.",
               "optional": true,
+              "type": "boolean",
               "default": true,
-              "type": "boolean"
+              "description": "Specifies whether the returned :ref:`folders.MailFolder` object should include all its nested subfolders. Defaults to <value>true</value>."
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "$ref": "folders.MailFolder"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "create",
+          "type": "function",
+          "min_manifest_version": 3,
+          "permissions": [
+            "accountsFolders"
+          ],
+          "description": "Creates a new subfolder in the specified folder.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "folderId",
+              "$ref": "folders.MailFolderId"
+            },
+            {
+              "name": "childName",
+              "type": "string"
             },
             {
               "type": "function",
@@ -8434,10 +8860,11 @@
         {
           "name": "create",
           "type": "function",
+          "max_manifest_version": 2,
           "permissions": [
             "accountsFolders"
           ],
-          "description": "Creates a new subfolder in the specified folder or at the root of the specified account.",
+          "description": "Creates a new subfolder in the specified folder, or at the root of the specified account.",
           "async": "callback",
           "parameters": [
             {
@@ -8447,12 +8874,10 @@
                   "$ref": "folders.MailFolderId"
                 },
                 {
-                  "max_manifest_version": 2,
                   "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.create() requires to specify a MailFolderId instead of a full MailFolder object.",
                   "$ref": "folders.MailFolder"
                 },
                 {
-                  "max_manifest_version": 2,
                   "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.create() requires to specify the MailFolderId of the account's rootFolder, instead of a full MailAccount object.",
                   "$ref": "accounts.MailAccount"
                 }
@@ -8477,6 +8902,7 @@
         {
           "name": "rename",
           "type": "function",
+          "max_manifest_version": 2,
           "permissions": [
             "accountsFolders"
           ],
@@ -8490,7 +8916,6 @@
                   "$ref": "folders.MailFolderId"
                 },
                 {
-                  "max_manifest_version": 2,
                   "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.rename() requires to specify a MailFolderId instead of a full MailFolder object.",
                   "$ref": "folders.MailFolder"
                 }
@@ -8512,9 +8937,40 @@
             }
           ]
         },
+        {
+          "name": "rename",
+          "type": "function",
+          "min_manifest_version": 3,
+          "permissions": [
+            "accountsFolders"
+          ],
+          "description": "Renames a folder.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "folderId",
+              "$ref": "folders.MailFolderId"
+            },
+            {
+              "name": "newName",
+              "type": "string"
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "$ref": "folders.MailFolder"
+                }
+              ]
+            }
+          ]
+        },
         {
           "name": "move",
           "type": "function",
+          "max_manifest_version": 2,
           "permissions": [
             "accountsFolders"
           ],
@@ -8528,7 +8984,6 @@
                   "$ref": "folders.MailFolderId"
                 },
                 {
-                  "max_manifest_version": 2,
                   "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.move() requires to specify a MailFolderId for its source parameter, instead of a full MailFolder object.",
                   "$ref": "folders.MailFolder"
                 }
@@ -8541,12 +8996,10 @@
                   "$ref": "folders.MailFolderId"
                 },
                 {
-                  "max_manifest_version": 2,
                   "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.move() requires to specify a MailFolderId for its destination parameter, instead of a full MailFolder object.",
                   "$ref": "folders.MailFolder"
                 },
                 {
-                  "max_manifest_version": 2,
                   "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.move() requires to specify the MailFolderId of the account's rootFolder for its destination parameter, instead of a full MailAccount object.",
                   "$ref": "accounts.MailAccount"
                 }
@@ -8564,9 +9017,40 @@
             }
           ]
         },
+        {
+          "name": "move",
+          "type": "function",
+          "min_manifest_version": 3,
+          "permissions": [
+            "accountsFolders"
+          ],
+          "description": "Moves the given source folder into the given destination folder. Throws if the destination already contains a folder with the name of the source folder.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "sourceFolderId",
+              "$ref": "folders.MailFolderId"
+            },
+            {
+              "name": "destinationFolderId",
+              "$ref": "folders.MailFolderId"
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "$ref": "folders.MailFolder"
+                }
+              ]
+            }
+          ]
+        },
         {
           "name": "copy",
           "type": "function",
+          "max_manifest_version": 2,
           "permissions": [
             "accountsFolders"
           ],
@@ -8580,7 +9064,6 @@
                   "$ref": "folders.MailFolderId"
                 },
                 {
-                  "max_manifest_version": 2,
                   "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.copy() requires to specify a MailFolderId for its source parameter, instead of a full MailFolder object.",
                   "$ref": "folders.MailFolder"
                 }
@@ -8593,12 +9076,10 @@
                   "$ref": "folders.MailFolderId"
                 },
                 {
-                  "max_manifest_version": 2,
                   "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.copy() requires to specify a MailFolderId for its destination parameter, instead of a full MailFolder object.",
                   "$ref": "folders.MailFolder"
                 },
                 {
-                  "max_manifest_version": 2,
                   "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.copy() requires to specify the MailFolderId of the account's rootFolder for its destination parameter, instead of a full MailAccount object.",
                   "$ref": "accounts.MailAccount"
                 }
@@ -8616,6 +9097,36 @@
             }
           ]
         },
+        {
+          "name": "copy",
+          "type": "function",
+          "min_manifest_version": 3,
+          "permissions": [
+            "accountsFolders"
+          ],
+          "description": "Copies the given source folder into the given destination folder. Throws if the destination already contains a folder with the name of the source folder.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "sourceFolderId",
+              "$ref": "folders.MailFolderId"
+            },
+            {
+              "name": "destinationFolderId",
+              "$ref": "folders.MailFolderId"
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "$ref": "folders.MailFolder"
+                }
+              ]
+            }
+          ]
+        },
         {
           "name": "delete",
           "permissions": [
@@ -8623,6 +9134,7 @@
             "messagesDelete"
           ],
           "type": "function",
+          "max_manifest_version": 2,
           "description": "Deletes a folder.",
           "async": true,
           "parameters": [
@@ -8633,7 +9145,6 @@
                   "$ref": "folders.MailFolderId"
                 },
                 {
-                  "max_manifest_version": 2,
                   "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.delete() requires to specify a MailFolderId instead of a full MailFolder object.",
                   "$ref": "folders.MailFolder"
                 }
@@ -8641,12 +9152,30 @@
             }
           ]
         },
+        {
+          "name": "delete",
+          "permissions": [
+            "accountsFolders",
+            "messagesDelete"
+          ],
+          "type": "function",
+          "min_manifest_version": 3,
+          "description": "Deletes a folder.",
+          "async": true,
+          "parameters": [
+            {
+              "name": "folderId",
+              "$ref": "folders.MailFolderId"
+            }
+          ]
+        },
         {
           "name": "update",
           "permissions": [
             "accountsFolders"
           ],
           "type": "function",
+          "max_manifest_version": 2,
           "description": "Updates properties of a folder.",
           "async": true,
           "parameters": [
@@ -8657,7 +9186,6 @@
                   "$ref": "folders.MailFolderId"
                 },
                 {
-                  "max_manifest_version": 2,
                   "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.update() requires to specify a MailFolderId instead of a full MailFolder object.",
                   "$ref": "folders.MailFolder"
                 }
@@ -8677,9 +9205,38 @@
             }
           ]
         },
+        {
+          "name": "update",
+          "permissions": [
+            "accountsFolders"
+          ],
+          "type": "function",
+          "min_manifest_version": 3,
+          "description": "Updates properties of a folder.",
+          "async": true,
+          "parameters": [
+            {
+              "name": "folderId",
+              "$ref": "folders.MailFolderId"
+            },
+            {
+              "name": "updateProperties",
+              "type": "object",
+              "description": "The properties to update.",
+              "properties": {
+                "isFavorite": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Sets or clears the favorite status."
+                }
+              }
+            }
+          ]
+        },
         {
           "name": "getFolderInfo",
           "type": "function",
+          "max_manifest_version": 2,
           "description": "Get additional information about a folder.",
           "async": "callback",
           "parameters": [
@@ -8690,7 +9247,6 @@
                   "$ref": "folders.MailFolderId"
                 },
                 {
-                  "max_manifest_version": 2,
                   "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.getFolderInfo() requires to specify a MailFolderId instead of a full MailFolder object.",
                   "$ref": "folders.MailFolder"
                 }
@@ -8702,16 +9258,94 @@
               "optional": true,
               "parameters": [
                 {
-                  "$ref": "folders.MailFolderInfo"
+                  "$ref": "folders.MailFolderInfo"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "getFolderInfo",
+          "type": "function",
+          "min_manifest_version": 3,
+          "description": "Get additional information about a folder.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "folderId",
+              "$ref": "folders.MailFolderId"
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "$ref": "folders.MailFolderInfo"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "getFolderCapabilities",
+          "type": "function",
+          "max_manifest_version": 2,
+          "description": "Get capability information about a folder.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "folder",
+              "choices": [
+                {
+                  "$ref": "folders.MailFolderId"
+                },
+                {
+                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.getFolderCapabilities() requires to specify a MailFolderId instead of a full MailFolder object.",
+                  "$ref": "folders.MailFolder"
+                }
+              ]
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "$ref": "folders.MailFolderCapabilities"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "getFolderCapabilities",
+          "type": "function",
+          "min_manifest_version": 3,
+          "description": "Get capability information about a folder.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "folderId",
+              "$ref": "folders.MailFolderId"
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "$ref": "folders.MailFolderCapabilities"
                 }
               ]
             }
           ]
         },
         {
-          "name": "getFolderCapabilities",
+          "name": "getParentFolders",
           "type": "function",
-          "description": "Get capability information about a folder.",
+          "max_manifest_version": 2,
+          "description": "Get all parent folders as a flat ordered array. The first array entry is the direct parent.",
           "async": "callback",
           "parameters": [
             {
@@ -8721,19 +9355,28 @@
                   "$ref": "folders.MailFolderId"
                 },
                 {
-                  "max_manifest_version": 2,
-                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.getFolderCapabilities() requires to specify a MailFolderId instead of a full MailFolder object.",
+                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.getParentFolders() requires to specify a MailFolderId instead of a full MailFolder object.",
                   "$ref": "folders.MailFolder"
                 }
               ]
             },
+            {
+              "name": "includeSubFolders",
+              "description": "Specifies whether the returned :ref:`folders.MailFolder` object for each parent folder should include its nested subfolders. Defaults to <value>false</value>.",
+              "optional": true,
+              "default": false,
+              "type": "boolean"
+            },
             {
               "type": "function",
               "name": "callback",
               "optional": true,
               "parameters": [
                 {
-                  "$ref": "folders.MailFolderCapabilities"
+                  "type": "array",
+                  "items": {
+                    "$ref": "folders.MailFolder"
+                  }
                 }
               ]
             }
@@ -8742,28 +9385,53 @@
         {
           "name": "getParentFolders",
           "type": "function",
+          "min_manifest_version": 3,
           "description": "Get all parent folders as a flat ordered array. The first array entry is the direct parent.",
           "async": "callback",
           "parameters": [
             {
-              "name": "folder",
-              "choices": [
-                {
-                  "$ref": "folders.MailFolderId"
-                },
+              "name": "folderId",
+              "$ref": "folders.MailFolderId"
+            },
+            {
+              "name": "includeSubFolders",
+              "description": "Specifies whether the returned :ref:`folders.MailFolder` object for each parent folder should include its nested subfolders. Defaults to <value>false</value>.",
+              "optional": true,
+              "default": false,
+              "type": "boolean"
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
                 {
-                  "max_manifest_version": 2,
-                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.getParentFolders() requires to specify a MailFolderId instead of a full MailFolder object.",
-                  "$ref": "folders.MailFolder"
+                  "type": "array",
+                  "items": {
+                    "$ref": "folders.MailFolder"
+                  }
                 }
               ]
+            }
+          ]
+        },
+        {
+          "name": "getSubFolders",
+          "type": "function",
+          "min_manifest_version": 3,
+          "description": "Get the subfolders of the specified folder.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "folderId",
+              "$ref": "folders.MailFolderId"
             },
             {
               "name": "includeSubFolders",
-              "description": "Specifies whether the returned :ref:`folders.MailFolder` object for each parent folder should include its nested subfolders . Defaults to <value>false</value>.",
               "optional": true,
+              "type": "boolean",
               "default": false,
-              "type": "boolean"
+              "description": "Specifies whether the returned :ref:`folders.MailFolder` object for each direct subfolder should also include all its nested subfolders. Defaults to <value>false</value>."
             },
             {
               "type": "function",
@@ -8783,6 +9451,7 @@
         {
           "name": "getSubFolders",
           "type": "function",
+          "max_manifest_version": 2,
           "description": "Get the subfolders of the specified folder or account.",
           "async": "callback",
           "parameters": [
@@ -8793,12 +9462,10 @@
                   "$ref": "folders.MailFolderId"
                 },
                 {
-                  "max_manifest_version": 2,
                   "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.getSubFolders() requires to specify a MailFolderId instead of a full MailFolder object.",
                   "$ref": "folders.MailFolder"
                 },
                 {
-                  "max_manifest_version": 2,
                   "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.getSubFolders() requires to specify the MailFolderId of the account's rootFolder, instead of a full MailAccount object.",
                   "$ref": "accounts.MailAccount"
                 }
@@ -8806,10 +9473,10 @@
             },
             {
               "name": "includeSubFolders",
-              "description": "Specifies whether the returned :ref:`folders.MailFolder` object for each direct subfolder should also include all its nested subfolders . Defaults to <value>true</value>.",
               "optional": true,
+              "type": "boolean",
               "default": true,
-              "type": "boolean"
+              "description": "Specifies whether the returned :ref:`folders.MailFolder` object for each direct subfolder should also include all its nested subfolders. Defaults to <value>true</value>."
             },
             {
               "type": "function",
@@ -8892,6 +9559,7 @@
             "accountsFolders"
           ],
           "type": "function",
+          "max_manifest_version": 2,
           "description": "Marks all messages in a folder as read.",
           "async": false,
           "parameters": [
@@ -8902,13 +9570,28 @@
                   "$ref": "folders.MailFolderId"
                 },
                 {
-                  "max_manifest_version": 2,
                   "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.markAsRead() requires to specify a MailFolderId instead of a full MailFolder object.",
                   "$ref": "folders.MailFolder"
                 }
               ]
             }
           ]
+        },
+        {
+          "name": "markAsRead",
+          "permissions": [
+            "accountsFolders"
+          ],
+          "type": "function",
+          "min_manifest_version": 3,
+          "description": "Marks all messages in a folder as read.",
+          "async": false,
+          "parameters": [
+            {
+              "name": "folderId",
+              "$ref": "folders.MailFolderId"
+            }
+          ]
         }
       ],
       "events": [
@@ -9035,6 +9718,20 @@
         "accountsRead"
       ],
       "types": [
+        {
+          "id": "EncryptionCapabilities",
+          "type": "object",
+          "properties": {
+            "canEncrypt": {
+              "type": "boolean",
+              "description": "Whether the encryption technology is configured to support message encryption."
+            },
+            "canSign": {
+              "type": "boolean",
+              "description": "Whether the encryption technology is configured to support message signing."
+            }
+          }
+        },
         {
           "id": "MailIdentity",
           "type": "object",
@@ -9088,6 +9785,21 @@
               "type": "boolean",
               "optional": true,
               "description": "If the signature should be interpreted as plain text or as HTML."
+            },
+            "encryptionCapabilities": {
+              "type": "object",
+              "optional": true,
+              "description": "The encryption capabilities of this identity. Read only.",
+              "properties": {
+                "OpenPGP": {
+                  "$ref": "identities.EncryptionCapabilities",
+                  "description": "The capabilities of this identity for the OpenPGP encryption technology."
+                },
+                "S/MIME": {
+                  "$ref": "identities.EncryptionCapabilities",
+                  "description": "The capabilities of this identity for the S/MIME encryption technology."
+                }
+              }
             }
           }
         }
@@ -9334,6 +10046,11 @@
           "type": "object",
           "properties": {
             "id": {
+              "max_manifest_version": 2,
+              "type": "integer"
+            },
+            "tabId": {
+              "min_manifest_version": 3,
               "type": "integer"
             },
             "windowId": {
@@ -9342,6 +10059,17 @@
             "active": {
               "type": "boolean"
             },
+            "groupType": {
+              "type": "string",
+              "min_manifest_version": 3,
+              "description": "Grouping type of the message list.",
+              "optional": true,
+              "enum": [
+                "ungrouped",
+                "groupedByThread",
+                "groupedBySortType"
+              ]
+            },
             "sortType": {
               "type": "string",
               "description": "The primary sort column of the message list.",
@@ -9381,7 +10109,8 @@
             },
             "viewType": {
               "type": "string",
-              "description": "Group mode of the message list.",
+              "max_manifest_version": 2,
+              "description": "Grouping type of the message list.",
               "optional": true,
               "enum": [
                 "ungrouped",
@@ -9433,6 +10162,17 @@
           "id": "MailTabProperties",
           "type": "object",
           "properties": {
+            "groupType": {
+              "type": "string",
+              "min_manifest_version": 3,
+              "description": "Grouping type of the message list.",
+              "optional": true,
+              "enum": [
+                "ungrouped",
+                "groupedByThread",
+                "groupedBySortType"
+              ]
+            },
             "sortType": {
               "type": "string",
               "description": "Sorts the list of messages. ``sortOrder`` must also be given.",
@@ -9472,7 +10212,8 @@
             },
             "viewType": {
               "type": "string",
-              "description": "Sets the group mode of displayed messages.",
+              "max_manifest_version": 2,
+              "description": "Sets the grouping type of displayed messages.",
               "optional": true,
               "enum": [
                 "ungrouped",
@@ -9611,7 +10352,7 @@
                 {
                   "type": "array",
                   "items": {
-                    "$ref": "MailTab"
+                    "$ref": "mailTabs.MailTab"
                   }
                 }
               ]
@@ -9621,13 +10362,13 @@
         {
           "name": "get",
           "type": "function",
-          "description": "Get the properties of a mail tab.",
+          "description": "Get the :ref:`mailTabs.MailTab` properties of a mail tab.",
           "async": "callback",
           "parameters": [
             {
               "name": "tabId",
               "type": "integer",
-              "description": "ID of the requested mail tab. Throws if the requested tab is not a mail tab."
+              "description": "ID of the requested mail tab. Throws if the requested <value>tabId</value> does not belong to a mail tab."
             },
             {
               "type": "function",
@@ -9635,7 +10376,7 @@
               "optional": true,
               "parameters": [
                 {
-                  "$ref": "MailTab"
+                  "$ref": "mailTabs.MailTab"
                 }
               ]
             }
@@ -9644,7 +10385,8 @@
         {
           "name": "getCurrent",
           "type": "function",
-          "description": "Get the properties of the active mail tab, if the active tab is a mail tab. Returns <value>undefined</value> otherwise.",
+          "max_manifest_version": 2,
+          "description": "Get the :ref:`mailTabs.MailTab` properties of the active mail tab. Returns <value>undefined</value>, if the active tab is not a mail tab.",
           "async": "callback",
           "parameters": [
             {
@@ -9653,7 +10395,7 @@
               "optional": true,
               "parameters": [
                 {
-                  "$ref": "MailTab",
+                  "$ref": "mailTabs.MailTab",
                   "optional": true,
                   "description": "This may return undefined"
                 }
@@ -9669,7 +10411,7 @@
           "parameters": [
             {
               "name": "createProperties",
-              "$ref": "MailTabProperties",
+              "$ref": "mailTabs.MailTabProperties",
               "optional": true,
               "default": {}
             },
@@ -9680,7 +10422,7 @@
               "parameters": [
                 {
                   "name": "mailTab",
-                  "$ref": "MailTab",
+                  "$ref": "mailTabs.MailTab",
                   "description": "Details about the created mail tab. Will contain the ID of the new tab."
                 }
               ]
@@ -9702,7 +10444,7 @@
             },
             {
               "name": "updateProperties",
-              "$ref": "MailTabProperties"
+              "$ref": "mailTabs.MailTabProperties"
             },
             {
               "type": "function",
@@ -9711,7 +10453,7 @@
               "parameters": [
                 {
                   "name": "mailTab",
-                  "$ref": "MailTab",
+                  "$ref": "mailTabs.MailTab",
                   "description": "Details about the updated mail tab."
                 }
               ]
@@ -9746,6 +10488,37 @@
             }
           ]
         },
+        {
+          "name": "getSelectedFolders",
+          "type": "function",
+          "description": "Lists the selected folders in the folder pane.",
+          "permissions": [
+            "accountsRead"
+          ],
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "tabId",
+              "type": "integer",
+              "description": "Defaults to the active tab of the current window.",
+              "optional": true,
+              "minimum": 1
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "type": "array",
+                  "items": {
+                    "$ref": "folders.MailFolder"
+                  }
+                }
+              ]
+            }
+          ]
+        },
         {
           "name": "getSelectedMessages",
           "type": "function",
@@ -9856,7 +10629,7 @@
                   "optional": true
                 },
                 "text": {
-                  "$ref": "QuickFilterTextDetail",
+                  "$ref": "mailTabs.QuickFilterTextDetail",
                   "description": "Shows only messages matching the supplied text.",
                   "optional": true
                 }
@@ -10097,22 +10870,34 @@
             "selectedMessages": {
               "$ref": "messages.MessageList",
               "optional": true,
-              "description": "The selected messages, if the context menu was opened in the message list. The <permission>messagesRead</permission> permission is required."
+              "description": "The selected message(s) in the message list (a.k.a. the thread pane). Only available for the `message_list` context. The <permission>messagesRead</permission> permission is required. The returned selection includes the messages which would be affected by a context action through Thunderbirds UI, which may not be the actuall selected messages. For example, if the user has multiple messages selected and opens the context menu for a message outside that selection, only the message for which the context menu was opened, is returned."
             },
             "displayedFolder": {
               "$ref": "folders.MailFolder",
               "optional": true,
-              "description": "The displayed folder, if the context menu was opened in the message list. The <permission>accountsRead</permission> permission is required."
+              "description": "The displayed folder. Only available for the `message_list` context. The <permission>accountsRead</permission> permission is required."
             },
             "selectedFolder": {
               "$ref": "folders.MailFolder",
+              "max_manifest_version": 2,
+              "optional": true,
+              "deprecated": "Deprecated since Thunderbird 128 and removed in Manifest V3: The selectedFolder property has been replaced by the selectedFolders property.",
+              "description": "The selected folder in the folder pane (where the context menu was opened). Only available for the `folder_pane` context. The <permission>accountsRead</permission> permission is required."
+            },
+            "selectedFolders": {
+              "type": "array",
+              "items": {
+                "$ref": "folders.MailFolder"
+              },
               "optional": true,
-              "description": "The selected folder, if the context menu was opened in the folder pane. The <permission>accountsRead</permission> permission is required."
+              "description": "The selected folders in the folder pane. Only available for the `folder_pane` context. The <permission>accountsRead</permission> permission is required. The returned selection includes the folders which would be affected by a context action through Thunderbirds UI, which may not be the actuall selected folders. For example, if the user has multiple folders selected and opens the context menu for a folder outside that selection, only the folder for which the context menu was opened, is returned."
             },
             "selectedAccount": {
               "$ref": "accounts.MailAccount",
+              "max_manifest_version": 2,
               "optional": true,
-              "description": "The selected account, if the context menu was opened on an account entry in the folder pane. The <permission>accountsRead</permission> permission is required."
+              "deprecated": "Deprecated since Thunderbird 128 and removed in Manifest V3: The selectedAccount property has been replaced by the selectedFolders property, returning the root folder of the account.",
+              "description": "The selected account in the folder pane, if the context menu was opened on an account entry. Only available for the `folder_pane` context. The <permission>accountsRead</permission> permission is required."
             },
             "attachments": {
               "type": "array",
@@ -10259,22 +11044,34 @@
             "selectedMessages": {
               "$ref": "messages.MessageList",
               "optional": true,
-              "description": "The selected messages, if the context menu was opened in the message list. The <permission>messagesRead</permission> permission is required."
+              "description": "The selected message(s) in the message list (a.k.a. the thread pane). Only available for the `message_list` context. The <permission>messagesRead</permission> permission is required. The returned selection includes the messages which would be affected by a context action through Thunderbirds UI, which may not be the actuall selected messages. For example, if the user has multiple messages selected and opens the context menu for a message outside that selection, only the message for which the context menu was opened, is returned."
             },
             "displayedFolder": {
               "$ref": "folders.MailFolder",
               "optional": true,
-              "description": "The displayed folder, if the context menu was opened in the message list. The <permission>accountsRead</permission> permission is required."
+              "description": "The displayed folder. Only available for the `message_list` context. The <permission>accountsRead</permission> permission is required."
             },
             "selectedFolder": {
               "$ref": "folders.MailFolder",
+              "max_manifest_version": 2,
+              "optional": true,
+              "deprecated": "Deprecated since Thunderbird 128 and removed in Manifest V3: The selectedFolder property has been replaced by the selectedFolders property.",
+              "description": "The selected folder in the folder pane (where the context menu was opened). Only available for the `folder_pane` context. The <permission>accountsRead</permission> permission is required."
+            },
+            "selectedFolders": {
+              "type": "array",
+              "items": {
+                "$ref": "folders.MailFolder"
+              },
               "optional": true,
-              "description": "The selected folder, if the context menu was opened in the folder pane. The <permission>accountsRead</permission> permission is required."
+              "description": "The selected folders in the folder pane. Only available for the `folder_pane` context. The <permission>accountsRead</permission> permission is required. The returned selection includes the folders which would be affected by a context action through Thunderbirds UI, which may not be the actuall selected folders. For example, if the user has multiple folders selected and opens the context menu for a folder outside that selection, only the folder for which the context menu was opened, is returned."
             },
             "selectedAccount": {
               "$ref": "accounts.MailAccount",
+              "max_manifest_version": 2,
               "optional": true,
-              "description": "The selected account, if the context menu was opened on an account entry in the folder pane. The <permission>accountsRead</permission> permission is required."
+              "deprecated": "Deprecated since Thunderbird 128 and removed in Manifest V3: The selectedAccount property has been replaced by the selectedFolders property, returning the root folder of the account.",
+              "description": "The selected account in the folder pane, if the context menu was opened on an account entry. Only available for the `folder_pane` context. The <permission>accountsRead</permission> permission is required."
             },
             "attachments": {
               "type": "array",
@@ -10773,6 +11570,7 @@
         {
           "name": "onMessageDisplayed",
           "type": "function",
+          "max_manifest_version": 2,
           "description": "Fired when a message is displayed, whether in a 3-pane tab, a message tab, or a message window.",
           "parameters": [
             {
@@ -10795,11 +11593,17 @@
               "$ref": "tabs.Tab"
             },
             {
+              "max_manifest_version": 2,
               "name": "messages",
               "type": "array",
               "items": {
                 "$ref": "messages.MessageHeader"
               }
+            },
+            {
+              "min_manifest_version": 3,
+              "name": "displayedMessages",
+              "$ref": "messages.MessageList"
             }
           ]
         }
@@ -10807,6 +11611,7 @@
       "functions": [
         {
           "name": "getDisplayedMessage",
+          "max_manifest_version": 2,
           "type": "function",
           "description": "Gets the currently displayed message in the specified tab (even if the tab itself is currently not visible), or the currently active tab. It returns <value>null</value> if no messages are displayed, or if multiple messages are displayed.",
           "async": "callback",
@@ -10854,10 +11659,19 @@
               "optional": true,
               "parameters": [
                 {
-                  "type": "array",
-                  "items": {
-                    "$ref": "messages.MessageHeader"
-                  }
+                  "choices": [
+                    {
+                      "max_manifest_version": 2,
+                      "type": "array",
+                      "items": {
+                        "$ref": "messages.MessageHeader"
+                      }
+                    },
+                    {
+                      "min_manifest_version": 3,
+                      "$ref": "messages.MessageList"
+                    }
+                  ]
                 }
               ]
             }
@@ -11210,7 +12024,7 @@
                   "type": "integer",
                   "optional": true,
                   "minimum": 0,
-                  "description": "Specifies for which tab the label should be retrieved. If no tab is specified, the global label is retrieved."
+                  "description": "Specifies for which tab the label should be retrieved. If no tab is specified, the global value is retrieved."
                 },
                 "windowId": {
                   "type": "integer",
@@ -11272,7 +12086,84 @@
                   "type": "integer",
                   "optional": true,
                   "minimum": 0,
-                  "description": "Sets the icon only for the given tab."
+                  "description": "Sets the icon only for the given tab."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
+                }
+              }
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": []
+            }
+          ]
+        },
+        {
+          "name": "setPopup",
+          "type": "function",
+          "description": "Sets the html document to be opened as a popup when the user clicks on the messageDisplayAction button.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "details",
+              "type": "object",
+              "properties": {
+                "popup": {
+                  "choices": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The html file to show in a popup. Can be set to an empty string to not open a popup. Cleared by setting it to <value>null</value> (action will use the popup value defined in the manifest)."
+                },
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Sets the popup only for the given tab."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
+                }
+              }
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": []
+            }
+          ]
+        },
+        {
+          "name": "getPopup",
+          "type": "function",
+          "description": "Gets the html document set as the popup for this messageDisplayAction button.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "details",
+              "type": "object",
+              "properties": {
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Specifies for which tab the popup document should be retrieved. If no tab is specified, the global value is retrieved."
                 },
                 "windowId": {
                   "type": "integer",
@@ -11287,21 +12178,26 @@
               "type": "function",
               "name": "callback",
               "optional": true,
-              "parameters": []
+              "parameters": [
+                {
+                  "name": "result",
+                  "type": "string"
+                }
+              ]
             }
           ]
         },
         {
-          "name": "setPopup",
+          "name": "setBadgeText",
           "type": "function",
-          "description": "Sets the html document to be opened as a popup when the user clicks on the messageDisplayAction button.",
+          "description": "Sets the badge text for the messageDisplayAction button. The badge is displayed on top of the icon.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
               "type": "object",
               "properties": {
-                "popup": {
+                "text": {
                   "choices": [
                     {
                       "type": "string"
@@ -11310,13 +12206,13 @@
                       "type": "null"
                     }
                   ],
-                  "description": "The html file to show in a popup. Can be set to an empty string to not open a popup. Cleared by setting it to <value>null</value> (action will use the popup value defined in the manifest)."
+                  "description": "Any number of characters can be passed, but only about four can fit in the space. Cleared by setting it to <value>null</value> or an empty string."
                 },
                 "tabId": {
                   "type": "integer",
                   "optional": true,
                   "minimum": 0,
-                  "description": "Sets the popup only for the given tab."
+                  "description": "Sets the badge text only for the given tab."
                 },
                 "windowId": {
                   "type": "integer",
@@ -11336,9 +12232,9 @@
           ]
         },
         {
-          "name": "getPopup",
+          "name": "getBadgeText",
           "type": "function",
-          "description": "Gets the html document set as the popup for this messageDisplayAction button.",
+          "description": "Gets the badge text of the messageDisplayAction button.",
           "async": "callback",
           "parameters": [
             {
@@ -11349,7 +12245,7 @@
                   "type": "integer",
                   "optional": true,
                   "minimum": 0,
-                  "description": "Specifies for which tab the popup document should be retrieved. If no tab is specified, the global value is retrieved."
+                  "description": "Specifies for which tab the badge text should be retrieved. If no tab is specified, the global value is retrieved."
                 },
                 "windowId": {
                   "type": "integer",
@@ -11374,31 +12270,34 @@
           ]
         },
         {
-          "name": "setBadgeText",
+          "name": "setBadgeTextColor",
           "type": "function",
-          "description": "Sets the badge text for the messageDisplayAction button. The badge is displayed on top of the icon.",
-          "async": "callback",
+          "description": "Sets the text color for the badge.",
+          "async": true,
           "parameters": [
             {
               "name": "details",
               "type": "object",
               "properties": {
-                "text": {
+                "color": {
                   "choices": [
                     {
                       "type": "string"
                     },
+                    {
+                      "$ref": "ColorArray"
+                    },
                     {
                       "type": "null"
                     }
                   ],
-                  "description": "Any number of characters can be passed, but only about four can fit in the space. Cleared by setting it to <value>null</value> or an empty string."
+                  "description": "The color to use as text color in the badge. Cleared by setting it to <value>null</value>."
                 },
                 "tabId": {
                   "type": "integer",
                   "optional": true,
                   "minimum": 0,
-                  "description": "Sets the badge text only for the given tab."
+                  "description": "Sets the text color for the badge only for the given tab."
                 },
                 "windowId": {
                   "type": "integer",
@@ -11408,20 +12307,14 @@
                   "description": "Will throw an error if used."
                 }
               }
-            },
-            {
-              "type": "function",
-              "name": "callback",
-              "optional": true,
-              "parameters": []
             }
           ]
         },
         {
-          "name": "getBadgeText",
+          "name": "getBadgeTextColor",
           "type": "function",
-          "description": "Gets the badge text of the messageDisplayAction button.",
-          "async": "callback",
+          "description": "Gets the text color of the badge.",
+          "async": true,
           "parameters": [
             {
               "name": "details",
@@ -11431,7 +12324,7 @@
                   "type": "integer",
                   "optional": true,
                   "minimum": 0,
-                  "description": "Specifies for which tab the badge text should be retrieved. If no tab is specified, the global label is retrieved."
+                  "description": "Specifies for which tab the badge text color should be retrieved. If no tab is specified, the global value is retrieved."
                 },
                 "windowId": {
                   "type": "integer",
@@ -11477,7 +12370,7 @@
                       "type": "null"
                     }
                   ],
-                  "description": "The color to use as background in the badge. Cleared by setting it to <value>null</value> or an empty string."
+                  "description": "The color to use as background in the badge. Cleared by setting it to <value>null</value>."
                 },
                 "tabId": {
                   "type": "integer",
@@ -11516,7 +12409,7 @@
                   "type": "integer",
                   "optional": true,
                   "minimum": 0,
-                  "description": "Specifies for which tab the badge background color should be retrieved. If no tab is specified, the global label is retrieved."
+                  "description": "Specifies for which tab the badge background color should be retrieved. If no tab is specified, the global value is retrieved."
                 },
                 "windowId": {
                   "type": "integer",
@@ -11709,6 +12602,21 @@
           "minimum": 1,
           "description": "A unique id representing a :ref:`messages.MessageHeader` and the associated message. This id doesn’t refer to the Message-ID email header. It is an internal tracking number that does not remain after a restart. Nor does it follow an email that has been moved to a different folder."
         },
+        {
+          "id": "InlineTextPart",
+          "type": "object",
+          "description": "An inline part with content type <value>text/*</value>. These parts are not returned by :ref:`listAttachments` and usually make up the readable content of the message, mostly with content type <value>text/plain</value> or <value>text/html</value>",
+          "properties": {
+            "contentType": {
+              "type": "string",
+              "description": "The content type of the part. Most common types for inline text parts are <value>text/plain</value> and <value>text/html</value>. Possible other (deprecated) types are <value>text/richtext</value> and <value>text/enriched</value>. Some calendaring services include an inline text part with type <value>text/calendar</value>."
+            },
+            "content": {
+              "type": "string",
+              "description": "The content of this inline text part."
+            }
+          }
+        },
         {
           "id": "MessageHeader",
           "type": "object",
@@ -11820,7 +12728,7 @@
             "messages": {
               "type": "array",
               "items": {
-                "$ref": "MessageHeader"
+                "$ref": "messages.MessageHeader"
               }
             }
           }
@@ -11874,7 +12782,7 @@
             "parts": {
               "type": "array",
               "items": {
-                "$ref": "MessagePart"
+                "$ref": "messages.MessagePart"
               },
               "description": "Any sub-parts of this part.",
               "optional": true
@@ -11882,7 +12790,7 @@
             "size": {
               "type": "integer",
               "optional": true,
-              "description": "The size of this part. The size of <em>message/*</em> parts is not the actual message size (on disc), but the total size of its decoded body parts, excluding headers."
+              "description": "The size of this part. The size of parts with content type <em>message/rfc822</em> is not the actual message size (on disc), but the total size of its decoded body parts, excluding headers."
             }
           }
         },
@@ -11924,7 +12832,7 @@
         {
           "id": "MessageAttachment",
           "type": "object",
-          "description": "Represents an attachment in a message.",
+          "description": "Represents an attachment in a message. This includes all MIME parts with a <value>content-disposition</value> header set to <value>attachment</value>, but also related parts like inline images.",
           "properties": {
             "contentType": {
               "type": "string",
@@ -11942,6 +12850,11 @@
               "type": "integer",
               "description": "The size in bytes of this attachment."
             },
+            "contentId": {
+              "type": "string",
+              "optional": true,
+              "description": "The content-id of this part. Available for related parts, which are referenced from other places inside the same message (e.g. inline images)."
+            },
             "message": {
               "$ref": "messages.MessageHeader",
               "optional": true,
@@ -12064,6 +12977,33 @@
         {
           "name": "list",
           "type": "function",
+          "min_manifest_version": 3,
+          "description": "Gets all messages in a folder.",
+          "async": "callback",
+          "permissions": [
+            "accountsRead"
+          ],
+          "parameters": [
+            {
+              "name": "folderId",
+              "$ref": "folders.MailFolderId"
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "$ref": "messages.MessageList"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "list",
+          "type": "function",
+          "max_manifest_version": 2,
           "description": "Gets all messages in a folder.",
           "async": "callback",
           "permissions": [
@@ -12077,7 +13017,6 @@
                   "$ref": "folders.MailFolderId"
                 },
                 {
-                  "max_manifest_version": 2,
                   "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: messages.list() requires to specify a MailFolderId instead of a full MailFolder object.",
                   "$ref": "folders.MailFolder"
                 }
@@ -12145,7 +13084,7 @@
               "optional": true,
               "parameters": [
                 {
-                  "$ref": "MessageHeader"
+                  "$ref": "messages.MessageHeader"
                 }
               ]
             }
@@ -12179,7 +13118,7 @@
               "optional": true,
               "parameters": [
                 {
-                  "$ref": "MessagePart"
+                  "$ref": "messages.MessagePart"
                 }
               ]
             }
@@ -12269,7 +13208,32 @@
                 {
                   "type": "array",
                   "items": {
-                    "$ref": "MessageAttachment"
+                    "$ref": "messages.MessageAttachment"
+                  }
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "listInlineTextParts",
+          "type": "function",
+          "description": "Lists all inline text parts of a message. These parts are not returned by :ref:`listAttachments` and usually make up the readable content of the message, mostly with content type <value>text/plain</value> or <value>text/html</value>. If a message only includes a <value>text/html</value> part, the method :ref:`messengerUtilities.convertToPlainText` can be used to retreive a plain text version. \n\n**Note:** A message usually contains only one inline text part per subtype, but technically messages can contain multiple inline text parts per subtype.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "messageId",
+              "$ref": "messages.MessageId"
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "type": "array",
+                  "items": {
+                    "$ref": "messages.InlineTextPart"
                   }
                 }
               ]
@@ -12541,13 +13505,14 @@
             },
             {
               "name": "newProperties",
-              "$ref": "MessageProperties"
+              "$ref": "messages.MessageProperties"
             }
           ]
         },
         {
           "name": "move",
           "type": "function",
+          "max_manifest_version": 2,
           "description": "Moves messages to a specified folder. If the messages cannot be removed from the source folder, they will be copied instead of moved. Moving external messages will throw an <em>ExtensionError</em>.",
           "async": true,
           "permissions": [
@@ -12570,7 +13535,6 @@
                   "$ref": "folders.MailFolderId"
                 },
                 {
-                  "max_manifest_version": 2,
                   "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: messages.move() requires to specify a MailFolderId instead of a full MailFolder object.",
                   "$ref": "folders.MailFolder"
                 }
@@ -12579,9 +13543,36 @@
             }
           ]
         },
+        {
+          "name": "move",
+          "type": "function",
+          "min_manifest_version": 3,
+          "description": "Moves messages to a specified folder. If the messages cannot be removed from the source folder, they will be copied instead of moved. Moving external messages will throw an <em>ExtensionError</em>.",
+          "async": true,
+          "permissions": [
+            "accountsRead",
+            "messagesMove"
+          ],
+          "parameters": [
+            {
+              "name": "messageIds",
+              "type": "array",
+              "description": "The IDs of the messages to move.",
+              "items": {
+                "$ref": "messages.MessageId"
+              }
+            },
+            {
+              "name": "folderId",
+              "$ref": "folders.MailFolderId",
+              "description": "The folder to move the messages to."
+            }
+          ]
+        },
         {
           "name": "copy",
           "type": "function",
+          "max_manifest_version": 2,
           "description": "Copies messages to a specified folder.",
           "async": true,
           "permissions": [
@@ -12604,7 +13595,6 @@
                   "$ref": "folders.MailFolderId"
                 },
                 {
-                  "max_manifest_version": 2,
                   "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: messages.copy() requires to specify a MailFolderId instead of a full MailFolder object.",
                   "$ref": "folders.MailFolder"
                 }
@@ -12613,6 +13603,32 @@
             }
           ]
         },
+        {
+          "name": "copy",
+          "type": "function",
+          "min_manifest_version": 3,
+          "description": "Copies messages to a specified folder.",
+          "async": true,
+          "permissions": [
+            "accountsRead",
+            "messagesMove"
+          ],
+          "parameters": [
+            {
+              "name": "messageIds",
+              "type": "array",
+              "description": "The IDs of the messages to copy.",
+              "items": {
+                "$ref": "messages.MessageId"
+              }
+            },
+            {
+              "name": "folderId",
+              "$ref": "folders.MailFolderId",
+              "description": "The folder to copy the messages to."
+            }
+          ]
+        },
         {
           "name": "delete",
           "type": "function",
@@ -12641,6 +13657,7 @@
         {
           "name": "import",
           "type": "function",
+          "max_manifest_version": 2,
           "description": "Imports a message into a local Thunderbird folder. To import a message into an IMAP folder, add it to a local folder first and then move it to the IMAP folder.",
           "async": "callback",
           "permissions": [
@@ -12661,7 +13678,6 @@
                   "$ref": "folders.MailFolderId"
                 },
                 {
-                  "max_manifest_version": 2,
                   "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: messages.import() requires to specify a MailFolderId instead of a full MailFolder object.",
                   "$ref": "folders.MailFolder"
                 }
@@ -12685,6 +13701,45 @@
             }
           ]
         },
+        {
+          "name": "import",
+          "type": "function",
+          "min_manifest_version": 3,
+          "description": "Imports a message into a local Thunderbird folder. To import a message into an IMAP folder, add it to a local folder first and then move it to the IMAP folder.",
+          "async": "callback",
+          "permissions": [
+            "accountsRead",
+            "messagesImport"
+          ],
+          "parameters": [
+            {
+              "name": "file",
+              "type": "object",
+              "isInstanceOf": "File",
+              "additionalProperties": true
+            },
+            {
+              "name": "folderId",
+              "$ref": "folders.MailFolderId",
+              "description": "The folder to import the messages into."
+            },
+            {
+              "name": "properties",
+              "$ref": "messages.MessageProperties",
+              "optional": true
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "$ref": "messages.MessageHeader"
+                }
+              ]
+            }
+          ]
+        },
         {
           "name": "archive",
           "type": "function",
@@ -13062,7 +14117,7 @@
                   "type": "string"
                 },
                 {
-                  "$ref": "ColorArray"
+                  "$ref": "spaces.ColorArray"
                 }
               ],
               "optional": true,
@@ -13110,7 +14165,7 @@
                   "type": "string"
                 },
                 {
-                  "$ref": "ColorArray"
+                  "$ref": "spaces.ColorArray"
                 }
               ],
               "optional": "omit-key-if-missing",
@@ -13269,6 +14324,14 @@
               "properties": {
                 "id": {
                   "type": "integer",
+                  "max_manifest_version": 2,
+                  "description": "The id of the space.",
+                  "optional": true,
+                  "minimum": 1
+                },
+                "spaceId": {
+                  "type": "integer",
+                  "min_manifest_version": 3,
                   "description": "The id of the space.",
                   "optional": true,
                   "minimum": 1
@@ -14625,6 +15688,41 @@
         }
       ],
       "functions": [
+        {
+          "name": "convertToPlainText",
+          "type": "function",
+          "description": "Converts the provided body to readable plain text, without tags and leading/trailing whitespace.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "body",
+              "type": "string",
+              "description": "The to-be-converted body."
+            },
+            {
+              "name": "options",
+              "type": "object",
+              "optional": true,
+              "properties": {
+                "flowed": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "The converted plain text will be wrapped to lines not longer than 72 characters and use format flowed, as defined by RFC 2646."
+                }
+              }
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          ]
+        },
         {
           "name": "formatFileSize",
           "type": "function",