Add the boilerplate for actions to File System Provider API.

chrome/common/extensions/api/file_system_provider.idl

 // Copyright 2013 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 // Use the <code>chrome.fileSystemProvider</code> API to create file systems,
 // that can be accessible from the file manager on Chrome OS.
 [implemented_in="chrome/browser/chromeos/extensions/file_system_provider/file_system_provider_api.h"]
 namespace fileSystemProvider {
   // Error codes used by providing extensions in response to requests as well
   // as in case of errors when calling methods of the API. For success,
-  // <code>OK</code> must be used.
+  // <code>"OK"</code> must be used.
   enum ProviderError {
     OK,
     FAILED,
     IN_USE,
     EXISTS,
     NOT_FOUND,
     ACCESS_DENIED,
     TOO_MANY_OPENED,
     NO_MEMORY,
     NO_SPACE,
@@ skipping 12 matching lines @@
     READ,
     WRITE
   };
 
   // Type of a change detected on the observed directory.
   enum ChangeType {
     CHANGED,
     DELETED
   };
 
+  // List of common actions. <code>"SHARE"</code> is for sharing files with
+  // others. <code>"SAVE_FOR_OFFLINE"</code> for pinning (saving for offline
+  // access). <code>"OFFLINE_NOT_NECESSARY"</code> for notifying that the file
+  // doesn't need to be stored for offline access anymore.
+  // Used by $(ref:onGetActionsRequested) and $(ref:onExecuteActionRequested).
+  enum CommonActionId {
+    SAVE_FOR_OFFLINE,
+    OFFLINE_NOT_NECESSARY,
+    SHARE
+  };
+
   // Represents metadata of a file or a directory.
   dictionary EntryMetadata {
     // True if it is a directory.
     boolean isDirectory;
 
     // Name of this entry (not full path name). Must not contain '/'. For root
     // it must be empty.
     DOMString name;
 
     // File size in bytes.
@@ skipping 108 matching lines @@
     // The unique identifier of this request.
     long requestId;
 
     // The path of the entry to fetch metadata about.
     DOMString entryPath;
 
     // Set to <code>true</code> if the thumbnail is requested.
     boolean thumbnail;
   };
 
+  // Options for the $(ref:onGetActionsRequested) event.
+  dictionary GetActionsRequestedOptions {
+    // The identifier of the file system related to this operation.
+    DOMString fileSystemId;
+
+    // The unique identifier of this request.
+    long requestId;

[benwells, 2015/06/23 06:29:38]

Why is there a requestId?

[mtomasz, 2015/06/23 06:34:25]

All FSP requests (file system related events wired to File API and/or Files app)
are abortable with the onAbortRequested event. The requestId field is used to
identify which operation to abort.

[benwells, 2015/06/23 06:51:06]

ok makes sense.

+
+    // The path of the entry to return the list of actions for.
+    DOMString entryPath;
+  };
+
   // Options for the $(ref:onReadDirectoryRequested) event.
   dictionary ReadDirectoryRequestedOptions {
     // The identifier of the file system related to this operation.
     DOMString fileSystemId;
 
     // The unique identifier of this request.
     long requestId;
 
     // The path of the directory which contents are requested. 
     DOMString directoryPath;
@@ skipping 186 matching lines @@
     // The unique identifier of this request.
     long requestId;
 
     // The path of the watched entry.
     DOMString entryPath;
 
     // Mode of the watcher.
     boolean recursive;
   };
 
+  // Information about an action for an entry.
+  dictionary Action {
+    // The identifier of the action. Any string or $(ref:CommonActionId) for
+    // common actions.
+    DOMString id;
+
+    // The title of the action. It may be ignored for common actions.
+    DOMString? title;
+  };
+
+  // Options for the $(ref:onExecuteActionRequested) event.
+  dictionary ExecuteActionRequestedOptions {
+    // The identifier of the file system related to this operation.
+    DOMString fileSystemId;
+
+    // The unique identifier of this request.
+    long requestId;
+
+    // The path of the entry to be used for the action.
+    DOMString entryPath;
+
+    // The identifier of the action to be executed.
+    DOMString actionId;
+  };
+
   // Information about a change happened to an entry within the observed
   // directory (including the entry itself).
   dictionary Change {
     // The path of the changed entry.
     DOMString entryPath;
 
     // The type of the change which happened to the entry.
     ChangeType changeType;
   };
 
@@ skipping 39 matching lines @@
   // Callback to receive the result of $(ref:get) function.
   callback GetCallback = void(FileSystemInfo fileSystem);
 
   // Callback to be called by the providing extension in case of a success.
   [nocompile] callback ProviderSuccessCallback = void();
 
   // Callback to be called by the providing extension in case of an error.
   [nocompile] callback ProviderErrorCallback = void(ProviderError error);
 
   // Success callback for the $(ref:onGetMetadataRequested) event.
-  [nocompile] callback MetadataCallback = void(
-      EntryMetadata metadata);
+  [nocompile] callback MetadataCallback = void(EntryMetadata metadata);
+
+  // Success callback for the $(ref:onGetActionsRequested) event.
+  [nocompile, nodoc] callback ActionsCallback = void(Action[] actions);
 
   // Success callback for the $(ref:onReadDirectoryRequested) event. If more
   // entries will be returned, then <code>hasMore</code> must be true, and it
   // has to be called again with additional entries. If no more entries are
   // available, then <code>hasMore</code> must be set to false.
   [nocompile] callback EntriesCallback = void(
       EntryMetadata[] entries, boolean hasMore);
 
   // Success callback for the $(ref:onReadFileRequested) event. If more
   // data will be returned, then <code>hasMore</code> must be true, and it
@@ skipping 81 matching lines @@
 
     // Raised when metadata of a file or a directory at <code>entryPath</code>
     // is requested. The metadata must be returned with the
     // <code>successCallback</code> call. In case of an error,
     // <code>errorCallback</code> must be called.
     [maxListeners=1] static void onGetMetadataRequested(
         GetMetadataRequestedOptions options,
         MetadataCallback successCallback,
         ProviderErrorCallback errorCallback);
 
+    // Raised when list of actions for of a file or a directory at
+    // <code>entryPath</code>s requested. The actions must be returned with the
+    // <code>successCallback</code> call. In case of an error,
+    // <code>errorCallback</code> must be called.
+    [maxListeners=1, nodoc] static void onGetActionsRequested(
+        GetActionsRequestedOptions options,
+        ActionsCallback successCallback,
+        ProviderErrorCallback errorCallback);
+
     // Raised when contents of a directory at <code>directoryPath</code> are
     // requested. The results must be returned in chunks by calling the
     // <code>successCallback</code> several times. In case of an error,
     // <code>errorCallback</code> must be called.
     [maxListeners=1] static void onReadDirectoryRequested(
         ReadDirectoryRequestedOptions options,
         EntriesCallback successCallback,
         ProviderErrorCallback errorCallback);
 
     // Raised when opening a file at <code>filePath</code> is requested. If the
@@ skipping 110 matching lines @@
       AddWatcherRequestedOptions options,
       ProviderSuccessCallback successCallback,
       ProviderErrorCallback errorCallback);
 
     // Raised when the watcher should be removed. If an error occurs, then
     // <code>errorCallback</code> must be called.
     [maxListeners=1] static void onRemoveWatcherRequested(
       RemoveWatcherRequestedOptions options,
       ProviderSuccessCallback successCallback,
       ProviderErrorCallback errorCallback);
+
+    // Raised when executing an action for a file or a directory is requested.
+    // After the action is completed, <code>successCallback</code> must be
+    // called. On error, <code>errorCallback</code> must be called.
+    [maxListeners=1, nodoc] static void onExecuteActionRequested(
+      ExecuteActionRequestedOptions options,
+      ProviderSuccessCallback successCallback,
+      ProviderErrorCallback errorCallback);
   };
 };