Extend Payload to include references to externally stored objects (#671)

_**READ BEFORE MERGING:** All PRs require approval by both Server AND
SDK teams before merging! This is why the number of required approvals
is "2" and not "1"--two reviewers from the same team is NOT sufficient.
If your PR is not approved by someone in BOTH teams, it may be summarily
reverted._

<!-- Describe what has changed in this PR -->
Extend Payload to include references to externally stored data.
Currently the only information we would store is the size of the
externally stored object, but it will be extended in the future once
more features are added.

<!-- Tell your future self why have you made these changes -->
Payloads are limited in size, and as such require external references to
pass large amounts of data. This PR extends Payload protobuf to include
information (currently only size) about externally stored objects
associated with the Payload. One Payload will be able to reference
multiple externally stored objects in the future.

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

<!-- If this breaks the Server, please provide the Server PR to merge
right after this PR was merged. -->
This change is additive, and so won't break the server

Author: simvlad

openapi/openapiv2.json

@@ -7648,6 +7648,17 @@
         }
       }
     },
+    "PayloadExternalPayloadDetails": {
+      "type": "object",
+      "properties": {
+        "sizeBytes": {
+          "type": "string",
+          "format": "int64",
+          "title": "Size in bytes of the externally stored payload"
+        }
+      },
+      "description": "Describes an externally stored object referenced by this payload."
+    },
     "PendingActivityInfoPauseInfo": {
       "type": "object",
       "properties": {

openapi/openapiv3.yaml

@@ -9823,6 +9823,13 @@ components:
         Represents some binary (byte array) data (ex: activity input parameters or workflow result) with
          metadata which describes this binary data (format, encoding, encryption, etc). Serialization
          of the data may be user-defined.
+    Payload_ExternalPayloadDetails:
+      type: object
+      properties:
+        sizeBytes:
+          type: string
+          description: Size in bytes of the externally stored payload
+      description: Describes an externally stored object referenced by this payload.
     Payloads:
       type: object
       properties:

temporal/api/common/v1/message.proto

@@ -32,6 +32,14 @@ message Payloads {
 message Payload {
     map<string,bytes> metadata = 1;
     bytes data = 2;
+    // Details about externally stored payloads associated with this payload.
+    repeated ExternalPayloadDetails external_payloads = 3;
+
+    // Describes an externally stored object referenced by this payload.
+    message ExternalPayloadDetails {
+        // Size in bytes of the externally stored payload
+        int64 size_bytes = 1;
+    }
 }
 
 // A user-defined set of *indexed* fields that are used/exposed when listing/searching workflows.