workspace-create: expose workspace group capabilities

Author: outfoxxed

protocols/shell-workspace-creation-v1.xml

@@ -62,12 +62,16 @@
 
     <request name="destroy" type="destructor">
       <description summary="destroy the descriptor">
-        Destroys the object.
+        Destroy the object.
       </description>
     </request>
   </interface>
 
   <interface name="shell_workspace_target_creation_manager_v1" version="1">
+    <description summary="creates workspace targets">
+      Allows the creation of workspace targets.
+    </description>
+    
     <request name="destroy" type="destructor">
       <description summary="destroy the manager">
         Destroy the manager. Destroying the manager does not destroy objects
@@ -76,7 +80,7 @@
     </request>
 
     <request name="get_target">
-      <description>
+      <description summary="create a new workspace target">
         This request creates a new workspace target from a given workspace
         target descriptor.
 
@@ -89,6 +93,47 @@
       <arg name="target" type="new_id" interface="shell_workspace_creation_target_v1"/>
       <arg name="descriptor" type="new_id" interface="shell_workspace_creation_target_descriptor_v1"/>
     </request>
+
+    <request name="get_info">
+      <description summary="get information about available capabilities">
+        This request creates an info object, which exposes information
+        about expected capabilities of workspace targets created in a group
+        for a given workspace manager.
+      </description>
+
+      <arg name="info" type="new_id" interface="shell_workspace_target_creation_info_v1"/>
+      <arg name="workspace_manager" type="object" interface="ext_workspace_manager_v1"/>
+    </request>
+  </interface>
+
+  <interface name="shell_workspace_target_creation_info_v1" version="1">
+    <description summary="workspace target creation info">
+      This object exposes information about the expected capabilities of
+      workspace targets created on each workspace group.
+    </description>
+
+    <request name="destroy" type="destructor">
+      <description summary="destroy the manager">
+        Destroy the object.
+      </description>
+    </request>
+
+    <event name="group_capabilities">
+      <description summary="update the capabilities of a workspace group">
+        This event updates the expected capabilities for workspaces on a given
+        workspace group.
+
+        Capabilities exposed by this event can be used by clients to determine
+        available actions presented to a user. As such, the presented capabilities
+        should usually be a superset of actions available to any target that might
+        be created in the group.
+
+        'ext_workspace_manager_v1.done' will be sent following this event.
+      </description>
+
+      <arg name="group" type="object" interface="ext_workspace_group_handle_v1"/>
+      <arg name="capabilities" type="uint" enum="shell_workspace_creation_target_v1.capabilities"/>
+    </event>
   </interface>
 
   <interface name="shell_workspace_arbitrary_creation_manager_v1" version="1">