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 4476 matching lines @@
       {
         "name": "onDisabled",
         "description": "Fired when an app or extension has been disabled",
         "type": "function",
         "parameters": [{"name": "info", "$ref":"ExtensionInfo"}]
       }
     ]
   },
 
   {
+    "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.",
+        "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": "An DOMFileSystem instance for local file system access. null if the caller has no appropriate permissions."

[asargent_no_longer_on_chrome, 2011/04/04 18:21:25]

nit: "An" -> "A"

[zel, 2011/04/06 00:06:33]

Done.

+              }
+            ]
+          }
+        ]
+      },
+      {
+        "name": "getFileTasks",
+        "description": "Requests access to local file system",

[asargent_no_longer_on_chrome, 2011/04/04 18:21:25]

nit: looks like this description was cut-and-pasted from requestLocalFileSystem
above, and isn't quite accurate. 

Also, it would be great if you could add a description of what a task is either
here or in the description for the FileBrowserTask type above. When I first saw
the term "task", I was thinking it meant something like a running process, not
an available action (or intent) as you described in your email). 

[zel, 2011/04/06 00:06:33]

Done.

+        "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."
               }
             ]
           }
         ]
       }
     ]
   },
 
   {
     "namespace":"webstorePrivate",
@@ skipping 389 matching lines @@
           {
             "type": "integer",
             "name": "tabId",
             "description": "The id of the tab that was detached."
           }
         ]
       }
     ]
   }
 ]