feat(assets): add ListMicrogrids, GetGridpool RPC and associated request/response messages (#55)

This pull request introduces two new RPCs, `ListMicrogrids` and
`GetGridpool`, to `PlatformAssetsService` API
, enhancing the ability to retrieve microgrid and gridpool metadata. It
also updates the release notes and synchronizes the common API
submodule.

Author: sandovalrr

RELEASE_NOTES.md

@@ -2,15 +2,19 @@
 
 ## Summary
 
-Documentation improvement
-Rename service
+This release adds `ListMicrogrids` and `GetGridpool` to
+`frequenz.api.platformassets.v1alpha1`.
 
 ## Upgrading
 
-- Improved ListMicrogridElectricalComponentConnectionsRequest header doc
-- Rename service
-- Introduced new version
+- `frequenz.api.platformassets.v1alpha1.PlatformAssetsService` now includes
+  `ListMicrogrids`.
+- `frequenz.api.platformassets.v1alpha1` includes the `GetGridpool`
+  request/response messages and RPC.
+- `frequenz.api.platformassets.v1alpha1` remains a separate versioned package
+  with the renamed `PlatformAssetsService`.
 
 ## New Features
 
-n/a
+- Add the `ListMicrogrids` RPC to the `PlatformAssetsService` service.
+- Add the `GetGridpool` RPC to the `PlatformAssetsService` service.

proto/frequenz/api/platformassets/v1alpha1/platformassets.proto

@@ -12,6 +12,8 @@ syntax = "proto3";
 
 package frequenz.api.platformassets.v1alpha1;
 
+// protolint:disable:next MAX_LINE_LENGTH
+import "frequenz/api/common/v1alpha8/gridpool/gridpool.proto";
 // protolint:disable:next MAX_LINE_LENGTH
 import "frequenz/api/common/v1alpha8/microgrid/electrical_components/electrical_components.proto";
 import "frequenz/api/common/v1alpha8/microgrid/microgrid.proto";
@@ -36,6 +38,12 @@ import "frequenz/api/common/v1alpha8/microgrid/microgrid.proto";
 //     over TLS (HTTPS).
 //
 service PlatformAssetsService {
+  // Returns metadata for all microgrids visible to the caller.
+  rpc ListMicrogrids(ListMicrogridsRequest) returns (ListMicrogridsResponse);
+
+  // Returns metadata for a specific gridpool.
+  rpc GetGridpool(GetGridpoolRequest) returns (GetGridpoolResponse);
+
   // Returns metadata for a specific microgrid.
   rpc GetMicrogrid(GetMicrogridRequest) returns (GetMicrogridResponse);
 
@@ -51,6 +59,30 @@ service PlatformAssetsService {
       returns (ListMicrogridElectricalComponentConnectionsResponse);
 }
 
+// Request message for listing all visible microgrids.
+message ListMicrogridsRequest {
+}
+
+// Response message containing all visible microgrids.
+message ListMicrogridsResponse {
+  // Microgrids visible to the caller.
+  repeated frequenz.api.common.v1alpha8.microgrid.Microgrid microgrids = 1;
+}
+
+// Request message for retrieving metadata for a specific gridpool.
+message GetGridpoolRequest {
+  // The unique identifier of the gridpool for which to fetch details.
+  uint64 gridpool_id = 1;
+}
+
+// Response message containing metadata for a specific gridpool.
+message GetGridpoolResponse {
+  // Details of the requested gridpool.
+  frequenz.api.common.v1alpha8.gridpool.Gridpool gridpool = 1;
+  // Microgrids belonging to the requested gridpool.
+  repeated frequenz.api.common.v1alpha8.microgrid.Microgrid microgrids = 2;
+}
+
 // Filters for selecting electrical component connections in a microgrid.
 //
 // A connection must match all specified filter fields to be included in the