Skip to content

feat(ces): generate library#16010

Merged
scotthart merged 5 commits intogoogleapis:mainfrom
scotthart:feat-ces-generate-library
Feb 27, 2026
Merged

feat(ces): generate library#16010
scotthart merged 5 commits intogoogleapis:mainfrom
scotthart:feat-ces-generate-library

Conversation

@scotthart
Copy link
Member

No description provided.

@gemini-code-assist
Copy link

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request integrates the new Gemini Enterprise for Customer Experience API (CES) client library into the existing codebase. It sets up the necessary build configurations, documentation, and client-side implementations for interacting with the CES services, ensuring the library is fully functional and discoverable within the project.

Highlights

  • New Library Introduction: Introduced the client library for the Gemini Enterprise for Customer Experience API (CES), enabling new functionalities for customer engagement.
  • Build System Integration: Updated README.md, ci/etc/expected_install_directories, and cmake/GoogleCloudCppFeatures.cmake to properly include and configure the new CES library within the project's build system.
  • Code Generation and Documentation: Added new protocol buffer dependency and list files, updated the library update script, and configured the generator for various CES services (AgentService, WidgetService, ToolService, SessionService). Comprehensive Doxygen documentation and quickstart examples were also added.
Changelog
  • README.md
    • Added an entry for the Gemini Enterprise for Customer Experience API.
  • ci/etc/expected_install_directories
    • Updated with new include and cmake directories for CES.
  • cmake/GoogleCloudCppFeatures.cmake
    • Added "ces" to the list of GA libraries.
  • external/googleapis/protodeps/ces.deps
    • Added a new file listing protocol buffer dependencies for CES.
  • external/googleapis/protolists/ces.list
    • Added a new file listing protocol buffer definitions for CES v1.
  • external/googleapis/update_libraries.sh
    • Updated to include the ces_cc_grpc target.
  • generator/generator_config.textproto
    • Added service configurations for AgentService, WidgetService, ToolService, and SessionService within CES.
  • google/cloud/ces/BUILD.bazel
    • Added a new Bazel build file for the CES library.
  • google/cloud/ces/CMakeLists.txt
    • Added a new CMake configuration for the CES library.
  • google/cloud/ces/README.md
    • Added a new README file for the CES C++ client library, including a quickstart example.
  • google/cloud/ces/doc/environment-variables.dox
    • Added new Doxygen documentation for CES environment variables.
  • google/cloud/ces/doc/main.dox
    • Added new main Doxygen documentation for the CES C++ client library.
  • google/cloud/ces/doc/options.dox
    • Added new Doxygen documentation for CES configuration options.
  • google/cloud/ces/doc/override-authentication.dox
    • Added new Doxygen documentation for overriding CES authentication.
  • google/cloud/ces/doc/override-endpoint.dox
    • Added new Doxygen documentation for overriding CES endpoints.
  • google/cloud/ces/doc/override-retry-policies.dox
    • Added new Doxygen documentation for overriding CES retry policies.
  • google/cloud/ces/doc/override-universe-domain.dox
    • Added new Doxygen documentation for overriding CES universe domains.
  • google/cloud/ces/quickstart/.bazelrc
    • Added a new Bazel configuration file for the CES quickstart.
  • google/cloud/ces/quickstart/BUILD.bazel
    • Added a new Bazel build file for the CES quickstart.
  • google/cloud/ces/quickstart/CMakeLists.txt
    • Added a new CMake configuration for the CES quickstart.
  • google/cloud/ces/quickstart/Makefile
    • Added a new Makefile for the CES quickstart.
  • google/cloud/ces/quickstart/README.md
    • Added a new README file for the CES quickstart, detailing usage with Bazel and CMake.
  • google/cloud/ces/quickstart/WORKSPACE.bazel
    • Added a new Bazel workspace file for the CES quickstart.
  • google/cloud/ces/quickstart/quickstart.cc
    • Added a new C++ quickstart example for the CES AgentService.
  • google/cloud/ces/v1/.repo-metadata.json
    • Added new repository metadata for the CES v1 API.
  • google/cloud/ces/v1/agent_client.cc
    • Added the client implementation for AgentService.
  • google/cloud/ces/v1/agent_connection.cc
    • Added the connection implementation for AgentService.
  • google/cloud/ces/v1/agent_connection.h
    • Added the connection header for AgentService.
  • google/cloud/ces/v1/agent_connection_idempotency_policy.cc
    • Added the idempotency policy implementation for AgentService.
  • google/cloud/ces/v1/agent_connection_idempotency_policy.h
    • Added the idempotency policy header for AgentService.
  • google/cloud/ces/v1/agent_options.h
    • Added the options header for AgentService.
  • google/cloud/ces/v1/internal/agent_auth_decorator.cc
    • Added the authentication decorator implementation for AgentService.
  • google/cloud/ces/v1/internal/agent_auth_decorator.h
    • Added the authentication decorator header for AgentService.
  • google/cloud/ces/v1/internal/agent_connection_impl.cc
    • Added the connection implementation details for AgentService.
  • google/cloud/ces/v1/internal/agent_connection_impl.h
    • Added the connection implementation header for AgentService.
  • google/cloud/ces/v1/internal/agent_logging_decorator.cc
    • Added the logging decorator implementation for AgentService.
  • google/cloud/ces/v1/internal/agent_logging_decorator.h
    • Added the logging decorator header for AgentService.
  • google/cloud/ces/v1/internal/agent_metadata_decorator.cc
    • Added the metadata decorator implementation for AgentService.
  • google/cloud/ces/v1/internal/agent_metadata_decorator.h
    • Added the metadata decorator header for AgentService.
  • google/cloud/ces/v1/internal/agent_option_defaults.cc
    • Added the default options implementation for AgentService.
  • google/cloud/ces/v1/internal/agent_option_defaults.h
    • Added the default options header for AgentService.
  • google/cloud/ces/v1/internal/agent_retry_traits.h
    • Added the retry traits header for AgentService.
  • google/cloud/ces/v1/internal/agent_sources.cc
    • Added the sources file for AgentService.
  • google/cloud/ces/v1/internal/agent_stub.cc
    • Added the stub implementation for AgentService.
  • google/cloud/ces/v1/internal/agent_stub.h
    • Added the stub header for AgentService.
  • google/cloud/ces/v1/internal/agent_stub_factory.cc
    • Added the stub factory implementation for AgentService.
  • google/cloud/ces/v1/internal/agent_stub_factory.h
    • Added the stub factory header for AgentService.
  • google/cloud/ces/v1/internal/agent_tracing_connection.cc
    • Added the tracing connection implementation for AgentService.
  • google/cloud/ces/v1/internal/agent_tracing_connection.h
    • Added the tracing connection header for AgentService.
  • google/cloud/ces/v1/internal/agent_tracing_stub.cc
    • Added the tracing stub implementation for AgentService.
  • google/cloud/ces/v1/internal/agent_tracing_stub.h
    • Added the tracing stub header for AgentService.
  • google/cloud/ces/v1/internal/session_auth_decorator.cc
    • Added the authentication decorator implementation for SessionService.
  • google/cloud/ces/v1/internal/session_auth_decorator.h
    • Added the authentication decorator header for SessionService.
  • google/cloud/ces/v1/internal/session_connection_impl.cc
    • Added the connection implementation details for SessionService.
  • google/cloud/ces/v1/internal/session_connection_impl.h
    • Added the connection implementation header for SessionService.
  • google/cloud/ces/v1/internal/session_logging_decorator.cc
    • Added the logging decorator implementation for SessionService.
  • google/cloud/ces/v1/internal/session_logging_decorator.h
    • Added the logging decorator header for SessionService.
  • google/cloud/ces/v1/internal/session_metadata_decorator.cc
    • Added the metadata decorator implementation for SessionService.
  • google/cloud/ces/v1/internal/session_metadata_decorator.h
    • Added the metadata decorator header for SessionService.
  • google/cloud/ces/v1/internal/session_option_defaults.cc
    • Added the default options implementation for SessionService.
  • google/cloud/ces/v1/internal/session_option_defaults.h
    • Added the default options header for SessionService.
  • google/cloud/ces/v1/internal/session_retry_traits.h
    • Added the retry traits header for SessionService.
  • google/cloud/ces/v1/internal/session_sources.cc
    • Added the sources file for SessionService.
  • google/cloud/ces/v1/internal/session_stub.cc
    • Added the stub implementation for SessionService.
  • google/cloud/ces/v1/internal/session_stub.h
    • Added the stub header for SessionService.
  • google/cloud/ces/v1/internal/session_stub_factory.cc
    • Added the stub factory implementation for SessionService.
  • google/cloud/ces/v1/internal/session_stub_factory.h
    • Added the stub factory header for SessionService.
  • google/cloud/ces/v1/internal/session_tracing_connection.cc
    • Added the tracing connection implementation for SessionService.
  • google/cloud/ces/v1/internal/session_tracing_connection.h
    • Added the tracing connection header for SessionService.
  • google/cloud/ces/v1/internal/session_tracing_stub.cc
    • Added the tracing stub implementation for SessionService.
  • google/cloud/ces/v1/internal/session_tracing_stub.h
    • Added the tracing stub header for SessionService.
  • google/cloud/ces/v1/internal/tool_auth_decorator.cc
    • Added the authentication decorator implementation for ToolService.
  • google/cloud/ces/v1/internal/tool_auth_decorator.h
    • Added the authentication decorator header for ToolService.
  • google/cloud/ces/v1/internal/tool_connection_impl.cc
    • Added the connection implementation details for ToolService.
  • google/cloud/ces/v1/internal/tool_connection_impl.h
    • Added the connection implementation header for ToolService.
  • google/cloud/ces/v1/internal/tool_logging_decorator.cc
    • Added the logging decorator implementation for ToolService.
  • google/cloud/ces/v1/internal/tool_logging_decorator.h
    • Added the logging decorator header for ToolService.
  • google/cloud/ces/v1/internal/tool_metadata_decorator.cc
    • Added the metadata decorator implementation for ToolService.
  • google/cloud/ces/v1/internal/tool_metadata_decorator.h
    • Added the metadata decorator header for ToolService.
  • google/cloud/ces/v1/internal/tool_option_defaults.cc
    • Added the default options implementation for ToolService.
  • google/cloud/ces/v1/internal/tool_option_defaults.h
    • Added the default options header for ToolService.
  • google/cloud/ces/v1/internal/tool_retry_traits.h
    • Added the retry traits header for ToolService.
  • google/cloud/ces/v1/internal/tool_sources.cc
    • Added the sources file for ToolService.
  • google/cloud/ces/v1/internal/tool_stub.cc
    • Added the stub implementation for ToolService.
  • google/cloud/ces/v1/internal/tool_stub.h
    • Added the stub header for ToolService.
  • google/cloud/ces/v1/internal/tool_stub_factory.cc
    • Added the stub factory implementation for ToolService.
  • google/cloud/ces/v1/internal/tool_stub_factory.h
    • Added the stub factory header for ToolService.
  • google/cloud/ces/v1/internal/tool_tracing_connection.cc
    • Added the tracing connection implementation for ToolService.
  • google/cloud/ces/v1/internal/tool_tracing_connection.h
    • Added the tracing connection header for ToolService.
  • google/cloud/ces/v1/internal/tool_tracing_stub.cc
    • Added the tracing stub implementation for ToolService.
  • google/cloud/ces/v1/internal/tool_tracing_stub.h
    • Added the tracing stub header for ToolService.
  • google/cloud/ces/v1/internal/widget_auth_decorator.cc
    • Added the authentication decorator implementation for WidgetService.
  • google/cloud/ces/v1/internal/widget_auth_decorator.h
    • Added the authentication decorator header for WidgetService.
  • google/cloud/ces/v1/internal/widget_connection_impl.cc
    • Added the connection implementation details for WidgetService.
  • google/cloud/ces/v1/internal/widget_connection_impl.h
    • Added the connection implementation header for WidgetService.
  • google/cloud/ces/v1/internal/widget_logging_decorator.cc
    • Added the logging decorator implementation for WidgetService.
  • google/cloud/ces/v1/internal/widget_logging_decorator.h
    • Added the logging decorator header for WidgetService.
  • google/cloud/ces/v1/internal/widget_metadata_decorator.cc
    • Added the metadata decorator implementation for WidgetService.
  • google/cloud/ces/v1/internal/widget_metadata_decorator.h
    • Added the metadata decorator header for WidgetService.
  • google/cloud/ces/v1/internal/widget_option_defaults.cc
    • Added the default options implementation for WidgetService.
  • google/cloud/ces/v1/internal/widget_option_defaults.h
    • Added the default options header for WidgetService.
  • google/cloud/ces/v1/internal/widget_retry_traits.h
    • Added the retry traits header for WidgetService.
  • google/cloud/ces/v1/internal/widget_sources.cc
    • Added the sources file for WidgetService.
  • google/cloud/ces/v1/internal/widget_stub.cc
    • Added the stub implementation for WidgetService.
  • google/cloud/ces/v1/internal/widget_stub.h
    • Added the stub header for WidgetService.
  • google/cloud/ces/v1/internal/widget_stub_factory.cc
    • Added the stub factory implementation for WidgetService.
  • google/cloud/ces/v1/internal/widget_stub_factory.h
    • Added the stub factory header for WidgetService.
  • google/cloud/ces/v1/internal/widget_tracing_connection.cc
    • Added the tracing connection implementation for WidgetService.
  • google/cloud/ces/v1/internal/widget_tracing_connection.h
    • Added the tracing connection header for WidgetService.
  • google/cloud/ces/v1/internal/widget_tracing_stub.cc
    • Added the tracing stub implementation for WidgetService.
  • google/cloud/ces/v1/internal/widget_tracing_stub.h
    • Added the tracing stub header for WidgetService.
  • google/cloud/ces/v1/session_client.cc
    • Added the client implementation for SessionService.
  • google/cloud/ces/v1/session_connection.cc
    • Added the connection implementation for SessionService.
  • google/cloud/ces/v1/session_connection.h
    • Added the connection header for SessionService.
  • google/cloud/ces/v1/session_connection_idempotency_policy.cc
    • Added the idempotency policy implementation for SessionService.
  • google/cloud/ces/v1/session_connection_idempotency_policy.h
    • Added the idempotency policy header for SessionService.
  • google/cloud/ces/v1/session_options.h
    • Added the options header for SessionService.
  • google/cloud/ces/v1/tool_client.cc
    • Added the client implementation for ToolService.
  • google/cloud/ces/v1/tool_connection.cc
    • Added the connection implementation for ToolService.
  • google/cloud/ces/v1/tool_connection.h
    • Added the connection header for ToolService.
  • google/cloud/ces/v1/tool_connection_idempotency_policy.cc
    • Added the idempotency policy implementation for ToolService.
  • google/cloud/ces/v1/tool_connection_idempotency_policy.h
    • Added the idempotency policy header for ToolService.
  • google/cloud/ces/v1/tool_options.h
    • Added the options header for ToolService.
  • google/cloud/ces/v1/widget_client.cc
    • Added the client implementation for WidgetService.
  • google/cloud/ces/v1/widget_connection.cc
    • Added the connection implementation for WidgetService.
  • google/cloud/ces/v1/widget_connection.h
    • Added the connection header for WidgetService.
  • google/cloud/ces/v1/widget_connection_idempotency_policy.cc
    • Added the idempotency policy implementation for WidgetService.
  • google/cloud/ces/v1/widget_connection_idempotency_policy.h
    • Added the idempotency policy header for WidgetService.
  • google/cloud/ces/v1/widget_options.h
    • Added the options header for WidgetService.
Activity
  • The pull request was created by scotthart.
  • The pull request introduces a new feature: the Gemini Enterprise for Customer Experience API (CES) library.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces the C++ client library for the Gemini Enterprise for Customer Experience API (CES). The changes primarily consist of auto-generated boilerplate code, build configurations, and documentation. The overall structure is consistent with other libraries in this repository. I have identified two minor issues: the copyright year is incorrectly set to a future date across all new files, and a CMake file contains a placeholder that needs to be resolved for local testing.

service {
service_proto_path: "google/cloud/ces/v1/agent_service.proto"
product_path: "google/cloud/ces/v1"
initial_copyright_year: "2026"

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The initial_copyright_year is set to "2026", which is a future year. This should be updated to the current year. This issue is present for all new ces service definitions in this file and results in incorrect copyright headers in all newly generated files.

Suggested change
initial_copyright_year: "2026"
initial_copyright_year: "2024"

COMMAND
cmake -P "${PROJECT_SOURCE_DIR}/cmake/quickstart-runner.cmake"
$<TARGET_FILE:ces_quickstart> GOOGLE_CLOUD_PROJECT
GOOGLE_CLOUD_CPP_TEST_REGION # EDIT HERE

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The placeholder # EDIT HERE needs to be replaced with a valid region or another appropriate value for the quickstart integration test to function correctly.

@codecov
Copy link

codecov bot commented Feb 27, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.64%. Comparing base (78e3fe1) to head (fd93e6c).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main   #16010   +/-   ##
=======================================
  Coverage   92.63%   92.64%           
=======================================
  Files        2333     2333           
  Lines      214631   214631           
=======================================
+ Hits       198827   198846   +19     
+ Misses      15804    15785   -19     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@scotthart scotthart enabled auto-merge (squash) February 27, 2026 15:59
@scotthart scotthart merged commit fc02353 into googleapis:main Feb 27, 2026
57 of 64 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants