Added new fileBrowserPrivate and fileHandler extension APIs

chrome/common/extensions/api/extension_api.json

 [
   {
     "namespace": "extension",
     "unprivileged": true,
     "types": [
       {
         "id": "MessageSender",
         "type": "object",
         "description": "An object containing information about the script context that sent a message or request.",
         "properties": {
@@ skipping 2816 matching lines @@
               },
               "checked": {
                 "type": "boolean",
                 "optional": true,
                 "description": "The initial state of a checkbox or radio item: true for selected and false for unselected. Only one radio item can be selected at a time in a given group of radio items."
               },
               "contexts": {
                 "type": "array",
                 "items": {
                   "type": "string",
-                  "enum": ["all", "page", "frame", "selection", "link", "editable", "image", "video", "audio"]
+                  "enum": ["all", "page", "frame", "selection", "link", "editable", "image", "video", "audio", "file"]
                 },
                 "minItems": 1,
                 "optional": true,
                 "description": "List of contexts this menu item will appear in. Defaults to ['page'] if not specified."
               },
               "onclick": {
                 "type": "function",
                 "optional": true,
                 "description": "A function that will be called back when the menu item is clicked.",
                 "parameters": [
@@ skipping 1660 matching lines @@
       },
       {
         "name": "onDisabled",
         "description": "Fired when an app or extension has been disabled",
         "type": "function",
         "parameters": [{"name": "info", "$ref":"ExtensionInfo"}]
       }
     ]
   },
   {
-    "namespace":"fileBrowserPrivate",
+    "namespace":"fileSystem",
     "nodoc": "true",
     "functions": [
       {
+        "name": "resolveLocalFileSystemURL",
+        "description": "Allows the user to look up the Entry for a file or directory referred to by a local URL. ",
+        "parameters": [
+          {
+            "name": "url",
+            "type": "string",
+            "description": "A URL referring to a local file in a filesystem."
+          },
+          {
+            "name": "callback",
+            "type": "function",
+            "optional": "false",
+            "parameters": [
+              {
+                "name" : "entry",
+                "type": "object",
+                "optional": "true",
+                "description": "An Entry as a response to a file resolution request. It will have value of null if the request failed."
+              }
+            ]
+          }
+        ]
+      }
+    ]
+  },
+
+  {
+    "namespace":"fileBrowserPrivate",
+    "nodoc": "true",
+    "types": [
+      {
+        "id": "FileBrowserTask",
+        "type": "object",
+        "description": "Represents information about available browser tasks. A task is an abstraction of an operation that the file browser can perform over a selected file set.",
+        "properties": {
+          "taskId": {"type": "string", "description": "The unique identifier of the task."},
+          "title": {"type": "string", "description": "Task title."},
+          "iconUrl": {"type": "string", "description": "Task icon url (from chrome://extension-icon/...)"}
+        }
+      }
+    ],
+    "functions": [
+      {
         "name": "requestLocalFileSystem",
         "description": "Requests access to local file system",
         "parameters": [
           {
             "name": "callback",
             "type": "function",
             "optional": "false",
             "parameters": [
               {
+                "name" : "fileSystem",
                 "type": "object",
-                "isInstanceOf": "DOMFileSystem"
+                "optional": "true",
+                "description": "A DOMFileSystem instance for local file system access. null if the caller has no appropriate permissions."
+              }
+            ]
+          }
+        ]
+      },
+      {
+        "name": "getFileTasks",
+        "description": "Gets the of tasks that can be performed over selected files.",
+        "parameters": [
+          {
+            "name": "fileURLs",
+            "type": "array",
+            "description": "Array of selected file URLs",
+            "items": { "type": "string" }
+          },
+          {
+            "name": "callback",
+            "type": "function",
+            "optional": "false",
+            "parameters": [
+              {
+                "name": "tasks",
+                "type": "array",
+                "items": {"$ref": "FileBrowserTask"},
+                "description": "The list of available tasks that can be performed on all of the passed file paths."
+              }
+            ]
+          }
+        ]
+      },
+      {
+        "name": "executeTask",
+        "description": "Executes file browser task over selected files",
+        "parameters": [
+          {
+            "name": "taskId",
+            "type": "string",
+            "description": "The unique identifier of task to execute."
+          },
+          {
+            "name": "fileURLs",
+            "type": "array",
+            "description": "Array of file URLs",
+            "items": { "type": "string" }
+          },
+          {
+            "name": "callback",
+            "type": "function",
+            "optional": "false",
+            "parameters": [
+              {
+                "name": "success",
+                "type": "boolean",
+                "optional": "true",
+                "description": "True of task execution was successfully initiated."
               }
             ]
           }
         ]
       },
       {
         "name": "selectFiles",
         "type": "function",
         "description": "Select multiple files.",
         "parameters": [
@@ skipping 479 matching lines @@
           {
             "type": "integer",
             "name": "tabId",
             "description": "The id of the tab that was detached."
           }
         ]
       }
     ]
   }
 ]