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 4497 matching lines @@
       },
       {
         "name": "onDisabled",
         "description": "Fired when an app or extension has been disabled",
         "type": "function",
         "parameters": [{"name": "info", "$ref":"ExtensionInfo"}]
       }
     ]
   },
   {
+    "namespace":"fileBrowserHandler",
+    "nodoc": "true",
+    "events": [
+      {
+        "name": "onExecuteAction",

[Aaron Boodman, 2011/04/14 22:04:34]

How about 'onExecute' since there is no 'action' in this API anymore.

[zel, 2011/04/14 23:51:12]

Yes, I've been thinking about the same rename now when 'handler' is part of the
event name. Done.

+        "type": "function",
+        "description": "Fired when file system action is executed from ChromeOS file browser.",
+        "parameters": [
+          {
+            "name": "id",
+            "type": "string",
+            "description": "File browser action id as specified in the listener component's manifest."
+          },
+          {
+            "name": "entries",
+            "type": "any",
+            "optional": true,
+            "description": "Array of Entry instances representing files that are targets of this action (selected in ChromeOS file browser)."
+          }
+        ]
+      }
+    ]
+  },
+  {
     "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 503 matching lines @@
           {
             "type": "integer",
             "name": "tabId",
             "description": "The id of the tab that was detached."
           }
         ]
       }
     ]
   }
 ]