updates

Author: wrenj

specification/v0_10/docs/a2ui_protocol.md

@@ -277,7 +277,7 @@ This message instructs the client to remove a surface and all its associated com
 
 ### `actionResponse`
 
-This message is sent by the server to respond to a client-initiated action that requested a response via `wantResponse: true`.
+This message is sent by the server to respond to a client-initiated `action` that requested a response via `wantResponse: true`.
 
 **Properties:**
 
@@ -292,10 +292,28 @@ Exactly one of `value` or `error` must be present.
 
 **Example:**
 
+Client sends this to the server:
 ```json
 {
   "version": "v0.10",
-  "actionId": "req_abc123",
+  "action": {
+    "name": "get_typeahead_suggestions",
+    "surfaceId": "mysurface",
+    "sourceComponentId": "myinput",
+    "context": {
+      "prefix": "app"
+    },
+    "wantResponse": true,
+    "actionId": "get_typeahead_suggestions_1"
+  }
+}
+```
+
+Server responds with:
+```json
+{
+  "version": "v0.10",
+  "actionId": "get_typeahead_suggestions_1",
   "actionResponse": {
     "value": ["apple", "application", "approved"]
   }

specification/v0_10/json/client_to_server.json

@@ -36,11 +36,15 @@
           "description": "A JSON object containing the key-value pairs from the component's action.event.context, after resolving all data bindings.",
           "additionalProperties": true
         },
+        "wantResponse": {
+          "type": "boolean",
+          "description": "If true, the client expects an actionResponse from the server.",
+          "default": false
+        },
         "actionId": {
           "type": "string",
           "description": "Unique ID for this action call. Only needed if wantResponse is true."
         }
-
       },
       "required": [
         "name",