Add PauseInfo to the pending activity info (#569)

<!-- Describe what has changed in this PR -->
**What changed?**
Add "PauseInfo" message to the PendincgActivityInfo. Message contain
information about who, why and when paused the activity.
Note: if activity is paused by rule id, users will need to call
"DescribeWorkflowRule" to get the details for that rule.

<!-- Tell your future self why have you made these changes -->
**Why?**
Product request, for audit purpose. Note: we don't add this information
to the history.

<!-- Are there any breaking changes on binary or code level? -->
**Breaking changes**
No

Author: ychebotarev

openapi/openapiv2.json

@@ -6756,6 +6756,37 @@
         }
       }
     },
+    "PauseInfoManual": {
+      "type": "object",
+      "properties": {
+        "identity": {
+          "type": "string",
+          "description": "The identity of the actor that paused the activity."
+        },
+        "reason": {
+          "type": "string",
+          "description": "Reason for pausing the activity."
+        }
+      }
+    },
+    "PendingActivityInfoPauseInfo": {
+      "type": "object",
+      "properties": {
+        "pauseTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The time when the activity was paused."
+        },
+        "manual": {
+          "$ref": "#/definitions/PauseInfoManual",
+          "title": "activity was paused by the manual intervention"
+        },
+        "ruleId": {
+          "type": "string",
+          "description": "Id of the rule that paused the activity."
+        }
+      }
+    },
     "StartOperationResponseAsync": {
       "type": "object",
       "properties": {
@@ -7845,6 +7876,10 @@
         "spec": {
           "$ref": "#/definitions/v1WorkflowRuleSpec",
           "description": "Note: Rule ID and expiration date are not used in the trigger request."
+        },
+        "identity": {
+          "type": "string",
+          "title": "The identity of the client who initiated this request"
         }
       }
     },
@@ -11603,6 +11638,9 @@
         "priority": {
           "$ref": "#/definitions/v1Priority",
           "title": "Priority metadata"
+        },
+        "pauseInfo": {
+          "$ref": "#/definitions/PendingActivityInfoPauseInfo"
         }
       }
     },

openapi/openapiv3.yaml

@@ -8692,6 +8692,15 @@ components:
     PauseActivityResponse:
       type: object
       properties: {}
+    PauseInfo_Manual:
+      type: object
+      properties:
+        identity:
+          type: string
+          description: The identity of the actor that paused the activity.
+        reason:
+          type: string
+          description: Reason for pausing the activity.
     Payload:
       description: |-
         Represents some binary (byte array) data (ex: activity input parameters or workflow result) with
@@ -8794,6 +8803,22 @@ components:
           allOf:
             - $ref: '#/components/schemas/Priority'
           description: Priority metadata
+        pauseInfo:
+          $ref: '#/components/schemas/PendingActivityInfo_PauseInfo'
+    PendingActivityInfo_PauseInfo:
+      type: object
+      properties:
+        pauseTime:
+          type: string
+          description: The time when the activity was paused.
+          format: date-time
+        manual:
+          allOf:
+            - $ref: '#/components/schemas/PauseInfo_Manual'
+          description: activity was paused by the manual intervention
+        ruleId:
+          type: string
+          description: Id of the rule that paused the activity.
     PendingChildExecutionInfo:
       type: object
       properties:
@@ -11302,6 +11327,9 @@ components:
           allOf:
             - $ref: '#/components/schemas/WorkflowRuleSpec'
           description: 'Note: Rule ID and expiration date are not used in the trigger request.'
+        identity:
+          type: string
+          description: The identity of the client who initiated this request
     TriggerWorkflowRuleResponse:
       type: object
       properties:

temporal/api/workflow/v1/message.proto

@@ -304,6 +304,27 @@ message PendingActivityInfo {
 
     // Priority metadata
     temporal.api.common.v1.Priority priority = 22;
+
+    message PauseInfo {
+        // The time when the activity was paused.
+        google.protobuf.Timestamp pause_time = 1;
+
+        message Manual {
+            // The identity of the actor that paused the activity.
+            string identity = 1;
+            // Reason for pausing the activity.
+            string reason = 2;
+        }
+        oneof paused_by {
+            // activity was paused by the manual intervention
+            Manual manual = 2;
+
+            // Id of the rule that paused the activity.
+            string rule_id = 3;
+        }
+    }
+
+    PauseInfo pause_info = 23;
 }
 
 message PendingChildExecutionInfo {

temporal/api/workflowservice/v1/request_response.proto

@@ -2271,6 +2271,9 @@ message TriggerWorkflowRuleRequest {
         // Note: Rule ID and expiration date are not used in the trigger request.
         temporal.api.rules.v1.WorkflowRuleSpec spec = 5;
     }
+
+    // The identity of the client who initiated this request
+    string identity = 3;
 }
 
 message TriggerWorkflowRuleResponse {