chore: regens API reference docs (#889)

diff --git a/docs/dyn/clouddebugger_v2.debugger.debuggees.breakpoints.html b/docs/dyn/clouddebugger_v2.debugger.debuggees.breakpoints.html
index 3f1fb81..7b02115 100644
--- a/docs/dyn/clouddebugger_v2.debugger.debuggees.breakpoints.html
+++ b/docs/dyn/clouddebugger_v2.debugger.debuggees.breakpoints.html
@@ -72,7 +72,7 @@
 
 </style>
 
-<h1><a href="clouddebugger_v2.html">Stackdriver Debugger API</a> . <a href="clouddebugger_v2.debugger.html">debugger</a> . <a href="clouddebugger_v2.debugger.debuggees.html">debuggees</a> . <a href="clouddebugger_v2.debugger.debuggees.breakpoints.html">breakpoints</a></h1>
+<h1><a href="clouddebugger_v2.html">Cloud Debugger API</a> . <a href="clouddebugger_v2.debugger.html">debugger</a> . <a href="clouddebugger_v2.debugger.debuggees.html">debuggees</a> . <a href="clouddebugger_v2.debugger.debuggees.breakpoints.html">breakpoints</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#delete">delete(debuggeeId, breakpointId, clientVersion=None, x__xgafv=None)</a></code></p>
@@ -81,10 +81,10 @@
   <code><a href="#get">get(debuggeeId, breakpointId, clientVersion=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets breakpoint information.</p>
 <p class="toc_element">
-  <code><a href="#list">list(debuggeeId, includeAllUsers=None, includeInactive=None, x__xgafv=None, clientVersion=None, stripResults=None, action_value=None, waitToken=None)</a></code></p>
+  <code><a href="#list">list(debuggeeId, stripResults=None, includeInactive=None, x__xgafv=None, clientVersion=None, includeAllUsers=None, action_value=None, waitToken=None)</a></code></p>
 <p class="firstline">Lists all breakpoints for the debuggee.</p>
 <p class="toc_element">
-  <code><a href="#set">set(debuggeeId, body, clientVersion=None, x__xgafv=None)</a></code></p>
+  <code><a href="#set">set(debuggeeId, body=None, clientVersion=None, canaryOption=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Sets the breakpoint to the debuggee.</p>
 <h3>Method Details</h3>
 <div class="method">
@@ -92,9 +92,9 @@
   <pre>Deletes the breakpoint from the debuggee.
 
 Args:
-  debuggeeId: string, ID of the debuggee whose breakpoint to delete. (required)
-  breakpointId: string, ID of the breakpoint to delete. (required)
-  clientVersion: string, The client version making the call.
+  debuggeeId: string, Required. ID of the debuggee whose breakpoint to delete. (required)
+  breakpointId: string, Required. ID of the breakpoint to delete. (required)
+  clientVersion: string, Required. The client version making the call.
 Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
   x__xgafv: string, V1 error format.
     Allowed values
@@ -121,9 +121,9 @@
   <pre>Gets breakpoint information.
 
 Args:
-  debuggeeId: string, ID of the debuggee whose breakpoint to get. (required)
-  breakpointId: string, ID of the breakpoint to get. (required)
-  clientVersion: string, The client version making the call.
+  debuggeeId: string, Required. ID of the debuggee whose breakpoint to get. (required)
+  breakpointId: string, Required. ID of the breakpoint to get. (required)
+  clientVersion: string, Required. The client version making the call.
 Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
   x__xgafv: string, V1 error format.
     Allowed values
@@ -134,8 +134,11 @@
   An object of the form:
 
     { # Response for getting breakpoint information.
-    "breakpoint": { # Represents the breakpoint specification, status and results. # Complete breakpoint state.
+    "breakpoint": { # ------------------------------------------------------------------------------ # Complete breakpoint state.
         # The fields `id` and `location` are guaranteed to be set.
+        # ## Breakpoint (the resource)
+        #
+        # Represents the breakpoint specification, status and results.
       "status": { # Represents a contextual status message. # Breakpoint status.
           #
           # The status includes an error flag and a human readable message.
@@ -211,7 +214,7 @@
             # 3) A pointer where the pointee was captured:
             #
             #     T x = { 3, 7 };
-            #     T* p = &x;
+            #     T* p = &amp;x;
             #
             #     {   // Captured variable
             #         name: "p",
@@ -233,7 +236,7 @@
             #     }
             #
             # The status should describe the reason for the missing value,
-            # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+            # such as `&lt;optimized out&gt;`, `&lt;inaccessible&gt;`, `&lt;pointers limit reached&gt;`.
             #
             # Note that a null pointer should not have members.
             #
@@ -250,7 +253,7 @@
             # 6) An unnamed pointer where the pointee was not captured:
             #
             #     int* p = new int(7);
-            #     int** pp = &p;
+            #     int** pp = &amp;p;
             #
             #     {  // Captured variable
             #         name: "pp",
@@ -276,12 +279,12 @@
             # When using the shared variable table, the following variables:
             #
             #     T x = { 3, 7 };
-            #     T* p = &x;
-            #     T& r = x;
+            #     T* p = &amp;x;
+            #     T&amp; r = x;
             #
             #     { name: "x", var_table_index: 3, type: "T" }  // Captured variables
             #     { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
-            #     { name: "r", type="T&", var_table_index: 3 }
+            #     { name: "r", type="T&amp;", var_table_index: 3 }
             #
             #     {  // Shared variable table entry #3:
             #         members { name: "m1", value: "3", type: "int" },
@@ -356,6 +359,7 @@
           #
           # Example: `Message received, id = $0, count = $1` with
           # `expressions` = `[ message.id, message.count ]`.
+      "state": "A String", # The current state of the breakpoint.
       "logLevel": "A String", # Indicates the severity of the log. Only relevant when action is `LOG`.
       "labels": { # A set of custom breakpoint properties, populated by the agent, to be
           # displayed to the user.
@@ -394,7 +398,7 @@
                 # 3) A pointer where the pointee was captured:
                 #
                 #     T x = { 3, 7 };
-                #     T* p = &x;
+                #     T* p = &amp;x;
                 #
                 #     {   // Captured variable
                 #         name: "p",
@@ -416,7 +420,7 @@
                 #     }
                 #
                 # The status should describe the reason for the missing value,
-                # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+                # such as `&lt;optimized out&gt;`, `&lt;inaccessible&gt;`, `&lt;pointers limit reached&gt;`.
                 #
                 # Note that a null pointer should not have members.
                 #
@@ -433,7 +437,7 @@
                 # 6) An unnamed pointer where the pointee was not captured:
                 #
                 #     int* p = new int(7);
-                #     int** pp = &p;
+                #     int** pp = &amp;p;
                 #
                 #     {  // Captured variable
                 #         name: "pp",
@@ -459,12 +463,12 @@
                 # When using the shared variable table, the following variables:
                 #
                 #     T x = { 3, 7 };
-                #     T* p = &x;
-                #     T& r = x;
+                #     T* p = &amp;x;
+                #     T&amp; r = x;
                 #
                 #     { name: "x", var_table_index: 3, type: "T" }  // Captured variables
                 #     { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
-                #     { name: "r", type="T&", var_table_index: 3 }
+                #     { name: "r", type="T&amp;", var_table_index: 3 }
                 #
                 #     {  // Shared variable table entry #3:
                 #         members { name: "m1", value: "3", type: "int" },
@@ -559,7 +563,7 @@
                 # 3) A pointer where the pointee was captured:
                 #
                 #     T x = { 3, 7 };
-                #     T* p = &x;
+                #     T* p = &amp;x;
                 #
                 #     {   // Captured variable
                 #         name: "p",
@@ -581,7 +585,7 @@
                 #     }
                 #
                 # The status should describe the reason for the missing value,
-                # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+                # such as `&lt;optimized out&gt;`, `&lt;inaccessible&gt;`, `&lt;pointers limit reached&gt;`.
                 #
                 # Note that a null pointer should not have members.
                 #
@@ -598,7 +602,7 @@
                 # 6) An unnamed pointer where the pointee was not captured:
                 #
                 #     int* p = new int(7);
-                #     int** pp = &p;
+                #     int** pp = &amp;p;
                 #
                 #     {  // Captured variable
                 #         name: "pp",
@@ -624,12 +628,12 @@
                 # When using the shared variable table, the following variables:
                 #
                 #     T x = { 3, 7 };
-                #     T* p = &x;
-                #     T& r = x;
+                #     T* p = &amp;x;
+                #     T&amp; r = x;
                 #
                 #     { name: "x", var_table_index: 3, type: "T" }  // Captured variables
                 #     { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
-                #     { name: "r", type="T&", var_table_index: 3 }
+                #     { name: "r", type="T&amp;", var_table_index: 3 }
                 #
                 #     {  // Shared variable table entry #3:
                 #         members { name: "m1", value: "3", type: "int" },
@@ -705,6 +709,8 @@
         },
       ],
       "createTime": "A String", # Time this breakpoint was created by the server in seconds resolution.
+      "canaryExpireTime": "A String", # The deadline for the breakpoint to stay in CANARY_ACTIVE state. The value
+          # is meaningless when the breakpoint is not in CANARY_ACTIVE state.
       "location": { # Represents a location in the source code. # Breakpoint source location.
         "column": 42, # Column within a line. The first column in a line as the value `1`.
             # Agents that do not support setting breakpoints on specific columns ignore
@@ -758,7 +764,7 @@
             # 3) A pointer where the pointee was captured:
             #
             #     T x = { 3, 7 };
-            #     T* p = &x;
+            #     T* p = &amp;x;
             #
             #     {   // Captured variable
             #         name: "p",
@@ -780,7 +786,7 @@
             #     }
             #
             # The status should describe the reason for the missing value,
-            # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+            # such as `&lt;optimized out&gt;`, `&lt;inaccessible&gt;`, `&lt;pointers limit reached&gt;`.
             #
             # Note that a null pointer should not have members.
             #
@@ -797,7 +803,7 @@
             # 6) An unnamed pointer where the pointee was not captured:
             #
             #     int* p = new int(7);
-            #     int** pp = &p;
+            #     int** pp = &amp;p;
             #
             #     {  // Captured variable
             #         name: "pp",
@@ -823,12 +829,12 @@
             # When using the shared variable table, the following variables:
             #
             #     T x = { 3, 7 };
-            #     T* p = &x;
-            #     T& r = x;
+            #     T* p = &amp;x;
+            #     T&amp; r = x;
             #
             #     { name: "x", var_table_index: 3, type: "T" }  // Captured variables
             #     { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
-            #     { name: "r", type="T&", var_table_index: 3 }
+            #     { name: "r", type="T&amp;", var_table_index: 3 }
             #
             #     {  // Shared variable table entry #3:
             #         members { name: "m1", value: "3", type: "int" },
@@ -903,23 +909,23 @@
 </div>
 
 <div class="method">
-    <code class="details" id="list">list(debuggeeId, includeAllUsers=None, includeInactive=None, x__xgafv=None, clientVersion=None, stripResults=None, action_value=None, waitToken=None)</code>
+    <code class="details" id="list">list(debuggeeId, stripResults=None, includeInactive=None, x__xgafv=None, clientVersion=None, includeAllUsers=None, action_value=None, waitToken=None)</code>
   <pre>Lists all breakpoints for the debuggee.
 
 Args:
-  debuggeeId: string, ID of the debuggee whose breakpoints to list. (required)
-  includeAllUsers: boolean, When set to `true`, the response includes the list of breakpoints set by
-any user. Otherwise, it includes only breakpoints set by the caller.
+  debuggeeId: string, Required. ID of the debuggee whose breakpoints to list. (required)
+  stripResults: boolean, This field is deprecated. The following fields are always stripped out of
+the result: `stack_frames`, `evaluated_expressions` and `variable_table`.
   includeInactive: boolean, When set to `true`, the response includes active and inactive
 breakpoints. Otherwise, it includes only active breakpoints.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
       2 - v2 error format
-  clientVersion: string, The client version making the call.
+  clientVersion: string, Required. The client version making the call.
 Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
-  stripResults: boolean, This field is deprecated. The following fields are always stripped out of
-the result: `stack_frames`, `evaluated_expressions` and `variable_table`.
+  includeAllUsers: boolean, When set to `true`, the response includes the list of breakpoints set by
+any user. Otherwise, it includes only breakpoints set by the caller.
   action_value: string, Only breakpoints with the specified action will pass the filter.
   waitToken: string, A wait token that, if specified, blocks the call until the breakpoints
 list has changed, or a server selected timeout has expired.  The value
@@ -937,7 +943,10 @@
         # The fields `id` and `location` are guaranteed to be set on each breakpoint.
         # The fields: `stack_frames`, `evaluated_expressions` and `variable_table`
         # are cleared on each breakpoint regardless of its status.
-      { # Represents the breakpoint specification, status and results.
+      { # ------------------------------------------------------------------------------
+          # ## Breakpoint (the resource)
+          #
+          # Represents the breakpoint specification, status and results.
         "status": { # Represents a contextual status message. # Breakpoint status.
             #
             # The status includes an error flag and a human readable message.
@@ -1013,7 +1022,7 @@
               # 3) A pointer where the pointee was captured:
               #
               #     T x = { 3, 7 };
-              #     T* p = &x;
+              #     T* p = &amp;x;
               #
               #     {   // Captured variable
               #         name: "p",
@@ -1035,7 +1044,7 @@
               #     }
               #
               # The status should describe the reason for the missing value,
-              # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+              # such as `&lt;optimized out&gt;`, `&lt;inaccessible&gt;`, `&lt;pointers limit reached&gt;`.
               #
               # Note that a null pointer should not have members.
               #
@@ -1052,7 +1061,7 @@
               # 6) An unnamed pointer where the pointee was not captured:
               #
               #     int* p = new int(7);
-              #     int** pp = &p;
+              #     int** pp = &amp;p;
               #
               #     {  // Captured variable
               #         name: "pp",
@@ -1078,12 +1087,12 @@
               # When using the shared variable table, the following variables:
               #
               #     T x = { 3, 7 };
-              #     T* p = &x;
-              #     T& r = x;
+              #     T* p = &amp;x;
+              #     T&amp; r = x;
               #
               #     { name: "x", var_table_index: 3, type: "T" }  // Captured variables
               #     { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
-              #     { name: "r", type="T&", var_table_index: 3 }
+              #     { name: "r", type="T&amp;", var_table_index: 3 }
               #
               #     {  // Shared variable table entry #3:
               #         members { name: "m1", value: "3", type: "int" },
@@ -1158,6 +1167,7 @@
             #
             # Example: `Message received, id = $0, count = $1` with
             # `expressions` = `[ message.id, message.count ]`.
+        "state": "A String", # The current state of the breakpoint.
         "logLevel": "A String", # Indicates the severity of the log. Only relevant when action is `LOG`.
         "labels": { # A set of custom breakpoint properties, populated by the agent, to be
             # displayed to the user.
@@ -1196,7 +1206,7 @@
                   # 3) A pointer where the pointee was captured:
                   #
                   #     T x = { 3, 7 };
-                  #     T* p = &x;
+                  #     T* p = &amp;x;
                   #
                   #     {   // Captured variable
                   #         name: "p",
@@ -1218,7 +1228,7 @@
                   #     }
                   #
                   # The status should describe the reason for the missing value,
-                  # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+                  # such as `&lt;optimized out&gt;`, `&lt;inaccessible&gt;`, `&lt;pointers limit reached&gt;`.
                   #
                   # Note that a null pointer should not have members.
                   #
@@ -1235,7 +1245,7 @@
                   # 6) An unnamed pointer where the pointee was not captured:
                   #
                   #     int* p = new int(7);
-                  #     int** pp = &p;
+                  #     int** pp = &amp;p;
                   #
                   #     {  // Captured variable
                   #         name: "pp",
@@ -1261,12 +1271,12 @@
                   # When using the shared variable table, the following variables:
                   #
                   #     T x = { 3, 7 };
-                  #     T* p = &x;
-                  #     T& r = x;
+                  #     T* p = &amp;x;
+                  #     T&amp; r = x;
                   #
                   #     { name: "x", var_table_index: 3, type: "T" }  // Captured variables
                   #     { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
-                  #     { name: "r", type="T&", var_table_index: 3 }
+                  #     { name: "r", type="T&amp;", var_table_index: 3 }
                   #
                   #     {  // Shared variable table entry #3:
                   #         members { name: "m1", value: "3", type: "int" },
@@ -1361,7 +1371,7 @@
                   # 3) A pointer where the pointee was captured:
                   #
                   #     T x = { 3, 7 };
-                  #     T* p = &x;
+                  #     T* p = &amp;x;
                   #
                   #     {   // Captured variable
                   #         name: "p",
@@ -1383,7 +1393,7 @@
                   #     }
                   #
                   # The status should describe the reason for the missing value,
-                  # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+                  # such as `&lt;optimized out&gt;`, `&lt;inaccessible&gt;`, `&lt;pointers limit reached&gt;`.
                   #
                   # Note that a null pointer should not have members.
                   #
@@ -1400,7 +1410,7 @@
                   # 6) An unnamed pointer where the pointee was not captured:
                   #
                   #     int* p = new int(7);
-                  #     int** pp = &p;
+                  #     int** pp = &amp;p;
                   #
                   #     {  // Captured variable
                   #         name: "pp",
@@ -1426,12 +1436,12 @@
                   # When using the shared variable table, the following variables:
                   #
                   #     T x = { 3, 7 };
-                  #     T* p = &x;
-                  #     T& r = x;
+                  #     T* p = &amp;x;
+                  #     T&amp; r = x;
                   #
                   #     { name: "x", var_table_index: 3, type: "T" }  // Captured variables
                   #     { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
-                  #     { name: "r", type="T&", var_table_index: 3 }
+                  #     { name: "r", type="T&amp;", var_table_index: 3 }
                   #
                   #     {  // Shared variable table entry #3:
                   #         members { name: "m1", value: "3", type: "int" },
@@ -1507,6 +1517,8 @@
           },
         ],
         "createTime": "A String", # Time this breakpoint was created by the server in seconds resolution.
+        "canaryExpireTime": "A String", # The deadline for the breakpoint to stay in CANARY_ACTIVE state. The value
+            # is meaningless when the breakpoint is not in CANARY_ACTIVE state.
         "location": { # Represents a location in the source code. # Breakpoint source location.
           "column": 42, # Column within a line. The first column in a line as the value `1`.
               # Agents that do not support setting breakpoints on specific columns ignore
@@ -1560,7 +1572,7 @@
               # 3) A pointer where the pointee was captured:
               #
               #     T x = { 3, 7 };
-              #     T* p = &x;
+              #     T* p = &amp;x;
               #
               #     {   // Captured variable
               #         name: "p",
@@ -1582,7 +1594,7 @@
               #     }
               #
               # The status should describe the reason for the missing value,
-              # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+              # such as `&lt;optimized out&gt;`, `&lt;inaccessible&gt;`, `&lt;pointers limit reached&gt;`.
               #
               # Note that a null pointer should not have members.
               #
@@ -1599,7 +1611,7 @@
               # 6) An unnamed pointer where the pointee was not captured:
               #
               #     int* p = new int(7);
-              #     int** pp = &p;
+              #     int** pp = &amp;p;
               #
               #     {  // Captured variable
               #         name: "pp",
@@ -1625,12 +1637,12 @@
               # When using the shared variable table, the following variables:
               #
               #     T x = { 3, 7 };
-              #     T* p = &x;
-              #     T& r = x;
+              #     T* p = &amp;x;
+              #     T&amp; r = x;
               #
               #     { name: "x", var_table_index: 3, type: "T" }  // Captured variables
               #     { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
-              #     { name: "r", type="T&", var_table_index: 3 }
+              #     { name: "r", type="T&amp;", var_table_index: 3 }
               #
               #     {  // Shared variable table entry #3:
               #         members { name: "m1", value: "3", type: "int" },
@@ -1706,15 +1718,18 @@
 </div>
 
 <div class="method">
-    <code class="details" id="set">set(debuggeeId, body, clientVersion=None, x__xgafv=None)</code>
+    <code class="details" id="set">set(debuggeeId, body=None, clientVersion=None, canaryOption=None, x__xgafv=None)</code>
   <pre>Sets the breakpoint to the debuggee.
 
 Args:
-  debuggeeId: string, ID of the debuggee where the breakpoint is to be set. (required)
-  body: object, The request body. (required)
+  debuggeeId: string, Required. ID of the debuggee where the breakpoint is to be set. (required)
+  body: object, The request body.
     The object takes the form of:
 
-{ # Represents the breakpoint specification, status and results.
+{ # ------------------------------------------------------------------------------
+    # ## Breakpoint (the resource)
+    # 
+    # Represents the breakpoint specification, status and results.
   "status": { # Represents a contextual status message. # Breakpoint status.
       # 
       # The status includes an error flag and a human readable message.
@@ -1790,7 +1805,7 @@
         # 3) A pointer where the pointee was captured:
         #
         #     T x = { 3, 7 };
-        #     T* p = &x;
+        #     T* p = &amp;x;
         #
         #     {   // Captured variable
         #         name: "p",
@@ -1812,7 +1827,7 @@
         #     }
         #
         # The status should describe the reason for the missing value,
-        # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+        # such as `&lt;optimized out&gt;`, `&lt;inaccessible&gt;`, `&lt;pointers limit reached&gt;`.
         #
         # Note that a null pointer should not have members.
         #
@@ -1829,7 +1844,7 @@
         # 6) An unnamed pointer where the pointee was not captured:
         #
         #     int* p = new int(7);
-        #     int** pp = &p;
+        #     int** pp = &amp;p;
         #
         #     {  // Captured variable
         #         name: "pp",
@@ -1855,12 +1870,12 @@
         # When using the shared variable table, the following variables:
         #
         #     T x = { 3, 7 };
-        #     T* p = &x;
-        #     T& r = x;
+        #     T* p = &amp;x;
+        #     T&amp; r = x;
         #
         #     { name: "x", var_table_index: 3, type: "T" }  // Captured variables
         #     { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
-        #     { name: "r", type="T&", var_table_index: 3 }
+        #     { name: "r", type="T&amp;", var_table_index: 3 }
         #
         #     {  // Shared variable table entry #3:
         #         members { name: "m1", value: "3", type: "int" },
@@ -1935,6 +1950,7 @@
       # 
       # Example: `Message received, id = $0, count = $1` with
       # `expressions` = `[ message.id, message.count ]`.
+  "state": "A String", # The current state of the breakpoint.
   "logLevel": "A String", # Indicates the severity of the log. Only relevant when action is `LOG`.
   "labels": { # A set of custom breakpoint properties, populated by the agent, to be
       # displayed to the user.
@@ -1973,7 +1989,7 @@
             # 3) A pointer where the pointee was captured:
             #
             #     T x = { 3, 7 };
-            #     T* p = &x;
+            #     T* p = &amp;x;
             #
             #     {   // Captured variable
             #         name: "p",
@@ -1995,7 +2011,7 @@
             #     }
             #
             # The status should describe the reason for the missing value,
-            # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+            # such as `&lt;optimized out&gt;`, `&lt;inaccessible&gt;`, `&lt;pointers limit reached&gt;`.
             #
             # Note that a null pointer should not have members.
             #
@@ -2012,7 +2028,7 @@
             # 6) An unnamed pointer where the pointee was not captured:
             #
             #     int* p = new int(7);
-            #     int** pp = &p;
+            #     int** pp = &amp;p;
             #
             #     {  // Captured variable
             #         name: "pp",
@@ -2038,12 +2054,12 @@
             # When using the shared variable table, the following variables:
             #
             #     T x = { 3, 7 };
-            #     T* p = &x;
-            #     T& r = x;
+            #     T* p = &amp;x;
+            #     T&amp; r = x;
             #
             #     { name: "x", var_table_index: 3, type: "T" }  // Captured variables
             #     { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
-            #     { name: "r", type="T&", var_table_index: 3 }
+            #     { name: "r", type="T&amp;", var_table_index: 3 }
             #
             #     {  // Shared variable table entry #3:
             #         members { name: "m1", value: "3", type: "int" },
@@ -2138,7 +2154,7 @@
             # 3) A pointer where the pointee was captured:
             #
             #     T x = { 3, 7 };
-            #     T* p = &x;
+            #     T* p = &amp;x;
             #
             #     {   // Captured variable
             #         name: "p",
@@ -2160,7 +2176,7 @@
             #     }
             #
             # The status should describe the reason for the missing value,
-            # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+            # such as `&lt;optimized out&gt;`, `&lt;inaccessible&gt;`, `&lt;pointers limit reached&gt;`.
             #
             # Note that a null pointer should not have members.
             #
@@ -2177,7 +2193,7 @@
             # 6) An unnamed pointer where the pointee was not captured:
             #
             #     int* p = new int(7);
-            #     int** pp = &p;
+            #     int** pp = &amp;p;
             #
             #     {  // Captured variable
             #         name: "pp",
@@ -2203,12 +2219,12 @@
             # When using the shared variable table, the following variables:
             #
             #     T x = { 3, 7 };
-            #     T* p = &x;
-            #     T& r = x;
+            #     T* p = &amp;x;
+            #     T&amp; r = x;
             #
             #     { name: "x", var_table_index: 3, type: "T" }  // Captured variables
             #     { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
-            #     { name: "r", type="T&", var_table_index: 3 }
+            #     { name: "r", type="T&amp;", var_table_index: 3 }
             #
             #     {  // Shared variable table entry #3:
             #         members { name: "m1", value: "3", type: "int" },
@@ -2284,6 +2300,8 @@
     },
   ],
   "createTime": "A String", # Time this breakpoint was created by the server in seconds resolution.
+  "canaryExpireTime": "A String", # The deadline for the breakpoint to stay in CANARY_ACTIVE state. The value
+      # is meaningless when the breakpoint is not in CANARY_ACTIVE state.
   "location": { # Represents a location in the source code. # Breakpoint source location.
     "column": 42, # Column within a line. The first column in a line as the value `1`.
         # Agents that do not support setting breakpoints on specific columns ignore
@@ -2337,7 +2355,7 @@
         # 3) A pointer where the pointee was captured:
         #
         #     T x = { 3, 7 };
-        #     T* p = &x;
+        #     T* p = &amp;x;
         #
         #     {   // Captured variable
         #         name: "p",
@@ -2359,7 +2377,7 @@
         #     }
         #
         # The status should describe the reason for the missing value,
-        # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+        # such as `&lt;optimized out&gt;`, `&lt;inaccessible&gt;`, `&lt;pointers limit reached&gt;`.
         #
         # Note that a null pointer should not have members.
         #
@@ -2376,7 +2394,7 @@
         # 6) An unnamed pointer where the pointee was not captured:
         #
         #     int* p = new int(7);
-        #     int** pp = &p;
+        #     int** pp = &amp;p;
         #
         #     {  // Captured variable
         #         name: "pp",
@@ -2402,12 +2420,12 @@
         # When using the shared variable table, the following variables:
         #
         #     T x = { 3, 7 };
-        #     T* p = &x;
-        #     T& r = x;
+        #     T* p = &amp;x;
+        #     T&amp; r = x;
         #
         #     { name: "x", var_table_index: 3, type: "T" }  // Captured variables
         #     { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
-        #     { name: "r", type="T&", var_table_index: 3 }
+        #     { name: "r", type="T&amp;", var_table_index: 3 }
         #
         #     {  // Shared variable table entry #3:
         #         members { name: "m1", value: "3", type: "int" },
@@ -2479,8 +2497,9 @@
       # in a programming language at the source location.
 }
 
-  clientVersion: string, The client version making the call.
+  clientVersion: string, Required. The client version making the call.
 Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
+  canaryOption: string, The canary option set by the user upon setting breakpoint.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -2490,8 +2509,11 @@
   An object of the form:
 
     { # Response for setting a breakpoint.
-    "breakpoint": { # Represents the breakpoint specification, status and results. # Breakpoint resource.
-        # The field `id` is guaranteed to be set (in addition to the echoed fileds).
+    "breakpoint": { # ------------------------------------------------------------------------------ # Breakpoint resource.
+        # The field `id` is guaranteed to be set (in addition to the echoed fields).
+        # ## Breakpoint (the resource)
+        #
+        # Represents the breakpoint specification, status and results.
       "status": { # Represents a contextual status message. # Breakpoint status.
           #
           # The status includes an error flag and a human readable message.
@@ -2567,7 +2589,7 @@
             # 3) A pointer where the pointee was captured:
             #
             #     T x = { 3, 7 };
-            #     T* p = &x;
+            #     T* p = &amp;x;
             #
             #     {   // Captured variable
             #         name: "p",
@@ -2589,7 +2611,7 @@
             #     }
             #
             # The status should describe the reason for the missing value,
-            # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+            # such as `&lt;optimized out&gt;`, `&lt;inaccessible&gt;`, `&lt;pointers limit reached&gt;`.
             #
             # Note that a null pointer should not have members.
             #
@@ -2606,7 +2628,7 @@
             # 6) An unnamed pointer where the pointee was not captured:
             #
             #     int* p = new int(7);
-            #     int** pp = &p;
+            #     int** pp = &amp;p;
             #
             #     {  // Captured variable
             #         name: "pp",
@@ -2632,12 +2654,12 @@
             # When using the shared variable table, the following variables:
             #
             #     T x = { 3, 7 };
-            #     T* p = &x;
-            #     T& r = x;
+            #     T* p = &amp;x;
+            #     T&amp; r = x;
             #
             #     { name: "x", var_table_index: 3, type: "T" }  // Captured variables
             #     { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
-            #     { name: "r", type="T&", var_table_index: 3 }
+            #     { name: "r", type="T&amp;", var_table_index: 3 }
             #
             #     {  // Shared variable table entry #3:
             #         members { name: "m1", value: "3", type: "int" },
@@ -2712,6 +2734,7 @@
           #
           # Example: `Message received, id = $0, count = $1` with
           # `expressions` = `[ message.id, message.count ]`.
+      "state": "A String", # The current state of the breakpoint.
       "logLevel": "A String", # Indicates the severity of the log. Only relevant when action is `LOG`.
       "labels": { # A set of custom breakpoint properties, populated by the agent, to be
           # displayed to the user.
@@ -2750,7 +2773,7 @@
                 # 3) A pointer where the pointee was captured:
                 #
                 #     T x = { 3, 7 };
-                #     T* p = &x;
+                #     T* p = &amp;x;
                 #
                 #     {   // Captured variable
                 #         name: "p",
@@ -2772,7 +2795,7 @@
                 #     }
                 #
                 # The status should describe the reason for the missing value,
-                # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+                # such as `&lt;optimized out&gt;`, `&lt;inaccessible&gt;`, `&lt;pointers limit reached&gt;`.
                 #
                 # Note that a null pointer should not have members.
                 #
@@ -2789,7 +2812,7 @@
                 # 6) An unnamed pointer where the pointee was not captured:
                 #
                 #     int* p = new int(7);
-                #     int** pp = &p;
+                #     int** pp = &amp;p;
                 #
                 #     {  // Captured variable
                 #         name: "pp",
@@ -2815,12 +2838,12 @@
                 # When using the shared variable table, the following variables:
                 #
                 #     T x = { 3, 7 };
-                #     T* p = &x;
-                #     T& r = x;
+                #     T* p = &amp;x;
+                #     T&amp; r = x;
                 #
                 #     { name: "x", var_table_index: 3, type: "T" }  // Captured variables
                 #     { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
-                #     { name: "r", type="T&", var_table_index: 3 }
+                #     { name: "r", type="T&amp;", var_table_index: 3 }
                 #
                 #     {  // Shared variable table entry #3:
                 #         members { name: "m1", value: "3", type: "int" },
@@ -2915,7 +2938,7 @@
                 # 3) A pointer where the pointee was captured:
                 #
                 #     T x = { 3, 7 };
-                #     T* p = &x;
+                #     T* p = &amp;x;
                 #
                 #     {   // Captured variable
                 #         name: "p",
@@ -2937,7 +2960,7 @@
                 #     }
                 #
                 # The status should describe the reason for the missing value,
-                # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+                # such as `&lt;optimized out&gt;`, `&lt;inaccessible&gt;`, `&lt;pointers limit reached&gt;`.
                 #
                 # Note that a null pointer should not have members.
                 #
@@ -2954,7 +2977,7 @@
                 # 6) An unnamed pointer where the pointee was not captured:
                 #
                 #     int* p = new int(7);
-                #     int** pp = &p;
+                #     int** pp = &amp;p;
                 #
                 #     {  // Captured variable
                 #         name: "pp",
@@ -2980,12 +3003,12 @@
                 # When using the shared variable table, the following variables:
                 #
                 #     T x = { 3, 7 };
-                #     T* p = &x;
-                #     T& r = x;
+                #     T* p = &amp;x;
+                #     T&amp; r = x;
                 #
                 #     { name: "x", var_table_index: 3, type: "T" }  // Captured variables
                 #     { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
-                #     { name: "r", type="T&", var_table_index: 3 }
+                #     { name: "r", type="T&amp;", var_table_index: 3 }
                 #
                 #     {  // Shared variable table entry #3:
                 #         members { name: "m1", value: "3", type: "int" },
@@ -3061,6 +3084,8 @@
         },
       ],
       "createTime": "A String", # Time this breakpoint was created by the server in seconds resolution.
+      "canaryExpireTime": "A String", # The deadline for the breakpoint to stay in CANARY_ACTIVE state. The value
+          # is meaningless when the breakpoint is not in CANARY_ACTIVE state.
       "location": { # Represents a location in the source code. # Breakpoint source location.
         "column": 42, # Column within a line. The first column in a line as the value `1`.
             # Agents that do not support setting breakpoints on specific columns ignore
@@ -3114,7 +3139,7 @@
             # 3) A pointer where the pointee was captured:
             #
             #     T x = { 3, 7 };
-            #     T* p = &x;
+            #     T* p = &amp;x;
             #
             #     {   // Captured variable
             #         name: "p",
@@ -3136,7 +3161,7 @@
             #     }
             #
             # The status should describe the reason for the missing value,
-            # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+            # such as `&lt;optimized out&gt;`, `&lt;inaccessible&gt;`, `&lt;pointers limit reached&gt;`.
             #
             # Note that a null pointer should not have members.
             #
@@ -3153,7 +3178,7 @@
             # 6) An unnamed pointer where the pointee was not captured:
             #
             #     int* p = new int(7);
-            #     int** pp = &p;
+            #     int** pp = &amp;p;
             #
             #     {  // Captured variable
             #         name: "pp",
@@ -3179,12 +3204,12 @@
             # When using the shared variable table, the following variables:
             #
             #     T x = { 3, 7 };
-            #     T* p = &x;
-            #     T& r = x;
+            #     T* p = &amp;x;
+            #     T&amp; r = x;
             #
             #     { name: "x", var_table_index: 3, type: "T" }  // Captured variables
             #     { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
-            #     { name: "r", type="T&", var_table_index: 3 }
+            #     { name: "r", type="T&amp;", var_table_index: 3 }
             #
             #     {  // Shared variable table entry #3:
             #         members { name: "m1", value: "3", type: "int" },