Merge branch 'main' into feat/open-range

Author: kalragauri

CHANGELOG.md

@@ -9,6 +9,13 @@ for details on updating existing applications using v1.x.y or v2.x.y.
 
 ## v3.9.0 - TBD
 
+### New Libraries
+
+We are happy to announce the following GA libraries. Unless specifically noted,
+the APIs in these libraries are stable, and are ready for production use.
+
+- [Workload Identity API](/google/cloud/workloadidentity/README.md)
+
 ## v3.8.0 - 2026-08
 
 ### Removed Libraries

README.md

@@ -575,6 +575,9 @@ See each library's `README.md` file for more information about:
 - [Workflow Executions API](google/cloud/workflows/README.md)
   [[quickstart]](google/cloud/workflows/quickstart/README.md)
   [[reference]](https://cloud.google.com/cpp/docs/reference/workflows/latest)
+- [Workload Identity API](google/cloud/workloadidentity/README.md)
+  [[quickstart]](google/cloud/workloadidentity/quickstart/README.md)
+  [[reference]](https://cloud.google.com/cpp/docs/reference/workloadidentity/latest)
 - [Workload Manager API](google/cloud/workloadmanager/README.md)
   [[quickstart]](google/cloud/workloadmanager/quickstart/README.md)
   [[reference]](https://cloud.google.com/cpp/docs/reference/workloadmanager/latest)

ci/abi-dumps/google_cloud_cpp_workloadidentity.expected.abi.dump.gz

@@ -1232,6 +1232,10 @@
 ./include/google/cloud/workflows/v1
 ./include/google/cloud/workflows/v1/internal
 ./include/google/cloud/workflows/v1/mocks
+./include/google/cloud/workloadidentity
+./include/google/cloud/workloadidentity/v1
+./include/google/cloud/workloadidentity/v1/internal
+./include/google/cloud/workloadidentity/v1/mocks
 ./include/google/cloud/workloadmanager
 ./include/google/cloud/workloadmanager/v1
 ./include/google/cloud/workloadmanager/v1/internal
@@ -1612,6 +1616,8 @@
 ./lib64/cmake/google_cloud_cpp_websecurityscanner_mocks
 ./lib64/cmake/google_cloud_cpp_workflows
 ./lib64/cmake/google_cloud_cpp_workflows_mocks
+./lib64/cmake/google_cloud_cpp_workloadidentity
+./lib64/cmake/google_cloud_cpp_workloadidentity_mocks
 ./lib64/cmake/google_cloud_cpp_workloadmanager
 ./lib64/cmake/google_cloud_cpp_workloadmanager_mocks
 ./lib64/cmake/google_cloud_cpp_workstations

ci/etc/expected_install_directories

@@ -198,6 +198,7 @@ set(GOOGLE_CLOUD_CPP_GA_LIBRARIES
     "webrisk"
     "websecurityscanner"
     "workflows"
+    "workloadidentity"
     "workloadmanager"
     "workstations")
 

cmake/GoogleCloudCppFeatures.cmake

@@ -0,0 +1,8 @@
+@googleapis//google/api:annotations_proto
+@googleapis//google/api:client_proto
+@googleapis//google/api:field_behavior_proto
+@googleapis//google/api:http_proto
+@googleapis//google/api:launch_stage_proto
+@googleapis//google/api:resource_proto
+@googleapis//google/longrunning:operations_proto
+@googleapis//google/rpc:status_proto

external/googleapis/protodeps/workloadidentity.deps

@@ -0,0 +1 @@
+@googleapis//google/cloud/workloadidentity/v1:service.proto

external/googleapis/protolists/workloadidentity.list

@@ -355,6 +355,7 @@ declare -A -r LIBRARIES=(
       "@googleapis//google/cloud/workflows/type:type_cc_grpc" \
       "@googleapis//google/cloud/workflows/executions/v1:executions_cc_grpc"
   )"
+  ["workloadidentity"]="@googleapis//google/cloud/workloadidentity/v1:workloadidentity_cc_grpc"
   ["workloadmanager"]="@googleapis//google/cloud/workloadmanager/v1:workloadmanager_cc_grpc"
   ["workstations"]="$(
     printf ",%s" \

external/googleapis/update_libraries.sh

@@ -4294,6 +4294,14 @@ service {
   retryable_status_codes: ["kUnavailable"]
 }
 
+# Workload Identity
+service {
+  service_proto_path: "google/cloud/workloadidentity/v1/service.proto"
+  product_path: "google/cloud/workloadidentity/v1"
+  initial_copyright_year: "2026"
+  retryable_status_codes: ["kUnavailable"]
+}
+
 # Workload Manager
 service {
   service_proto_path: "google/cloud/workloadmanager/v1/service.proto"

generator/generator_config.textproto

@@ -331,26 +331,55 @@ std::string FormatCommentBlock(std::string const& comment,
   if (offset >= line_length) GCP_LOG(FATAL) << "line_length is too small";
   auto comment_width = line_length - offset;
 
-  std::vector<std::string> lines;
-  std::size_t start_pos = 0;
-  while (start_pos != std::string::npos) {
-    std::size_t boundary = start_pos + comment_width;
-    std::size_t end_pos = boundary;
-    if (boundary < comment.length()) {
-      // Look backward from the boundary for the last word
-      end_pos = comment.rfind(' ', boundary);
-      // If there is only one word, find and use its boundary
-      if (end_pos == std::string::npos || end_pos < start_pos) {
-        end_pos = comment.find(' ', boundary);
+  bool const has_trailing_newline = comment.back() == '\n';
+  std::string_view comment_sv = comment;
+  if (has_trailing_newline) {
+    comment_sv.remove_suffix(1);
+  }
+
+  std::vector<std::string_view> lines;
+  std::vector<std::string_view> paragraphs = absl::StrSplit(comment_sv, '\n');
+  for (auto const& paragraph : paragraphs) {
+    if (paragraph.empty()) {
+      lines.emplace_back();
+      continue;
+    }
+    std::size_t start_pos = 0;
+    while (start_pos != std::string_view::npos) {
+      std::size_t boundary = start_pos + comment_width;
+      std::size_t end_pos = boundary;
+      if (boundary < paragraph.length()) {
+        // Look backward from the boundary for the last word
+        end_pos = paragraph.rfind(' ', boundary);
+        // If there is only one word, find and use its boundary
+        if (end_pos == std::string_view::npos || end_pos < start_pos) {
+          end_pos = paragraph.find(' ', boundary);
+        }
       }
+      lines.push_back(paragraph.substr(start_pos, end_pos - start_pos));
+      start_pos = paragraph.find_first_not_of(' ', end_pos);
     }
-    lines.push_back(comment.substr(start_pos, end_pos - start_pos));
-    start_pos = comment.find_first_not_of(' ', end_pos);
   }
 
   std::string indent(indent_level * indent_width, ' ');
-  std::string joiner = absl::StrCat("\n", indent, comment_introducer);
-  return absl::StrCat(indent, comment_introducer, absl::StrJoin(lines, joiner));
+  std::string trimmed_introducer = comment_introducer;
+  while (!trimmed_introducer.empty() && trimmed_introducer.back() == ' ') {
+    trimmed_introducer.pop_back();
+  }
+
+  std::string result;
+  for (std::size_t i = 0; i < lines.size(); ++i) {
+    if (i > 0) result += "\n";
+    if (lines[i].empty()) {
+      result += absl::StrCat(indent, trimmed_introducer);
+      continue;
+    }
+    result += absl::StrCat(indent, comment_introducer, lines[i]);
+  }
+  if (has_trailing_newline) {
+    result += "\n";
+  }
+  return result;
 }
 
 std::string FormatCommentKeyValueList(