Add protobuf support for list messages and rpcs (#512)

* Add protobuf support for list messages and rpcs

* Update protobuf to reflect core changes

Author: rainkwan

tfprotov5/internal/tfplugin5/tfplugin5.pb.go

@@ -1,9 +1,9 @@
 // Copyright (c) HashiCorp, Inc.
 // SPDX-License-Identifier: MPL-2.0
 
-// Terraform Plugin RPC protocol version 5.9
+// Terraform Plugin RPC protocol version 5.10
 //
-// This file defines version 5.9 of the RPC protocol. To implement a plugin
+// This file defines version 5.10 of the RPC protocol. To implement a plugin
 // against this protocol, copy this definition into your own codebase and
 // use protoc to generate stubs for your target language.
 //
@@ -349,6 +349,10 @@ service Provider {
     rpc RenewEphemeralResource(RenewEphemeralResource.Request) returns (RenewEphemeralResource.Response);
     rpc CloseEphemeralResource(CloseEphemeralResource.Request) returns (CloseEphemeralResource.Response);
 
+    /////// List
+    rpc ListResource(ListResource.Request) returns (stream ListResource.Event);
+    rpc ValidateListResourceConfig(ValidateListResourceConfig.Request) returns (ValidateListResourceConfig.Response);
+
     // Functions
 
     // GetFunctions returns the definitions of all functions.
@@ -375,6 +379,7 @@ message GetMetadata {
         // functions returns metadata for any functions.
         repeated FunctionMetadata functions = 5;
         repeated EphemeralResourceMetadata ephemeral_resources = 6;
+        repeated ListResourceMetadata list_resources = 7;
     }
 
     message FunctionMetadata {
@@ -393,6 +398,10 @@ message GetMetadata {
     message EphemeralResourceMetadata {
         string type_name = 1;
     }
+
+    message ListResourceMetadata {
+        string type_name = 1;
+    }
 }
 
 message GetProviderSchema {
@@ -409,6 +418,7 @@ message GetProviderSchema {
         // functions is a mapping of function names to definitions.
         map<string, Function> functions = 7;
         map<string, Schema> ephemeral_resource_schemas = 8;
+        map<string, Schema> list_resource_schemas = 9;
     }
 }
 
@@ -824,3 +834,41 @@ message UpgradeResourceIdentity {
         repeated Diagnostic diagnostics = 2;
     }
 }
+
+message ListResource {
+    message Request {
+        // type_name is the list resource type name.
+        string type_name = 1;
+
+        // configuration is the list ConfigSchema-based configuration data.
+        DynamicValue config = 2;
+
+        // when include_resource_object is set to true, the provider should
+        // include the full resource object for each result
+        bool include_resource_object = 3;
+    }
+
+    message Event {
+        // identity is the resource identity data of the resource instance.
+        ResourceIdentityData identity = 1;
+
+        // display_name can be displayed in a UI to make it easier for humans to identify a resource
+        string display_name = 2;
+
+        // optional resource object which can be useful when combining list blocks in configuration
+        optional DynamicValue resource_object = 3;
+
+        // A warning or error diagnostics for this event
+        repeated Diagnostic diagnostic = 4;
+    }
+}
+
+message ValidateListResourceConfig {
+    message Request {
+        string type_name = 1;
+        DynamicValue config = 2;
+    }
+    message Response {
+        repeated Diagnostic diagnostics = 1;
+    }
+}

tfprotov5/internal/tfplugin5/tfplugin5.proto

@@ -49,7 +49,7 @@ const (
 	//
 	// In the future, it may be possible to include this information directly
 	// in the protocol buffers rather than recreating a constant here.
-	protocolVersionMinor uint = 9
+	protocolVersionMinor uint = 10
 )
 
 // protocolVersion represents the combined major and minor version numbers of