From b014ed83534e335bc12374ec82d99e03e4fae11f Mon Sep 17 00:00:00 2001
From: Fred Tzeng <fred.tzeng@temporal.io>
Date: Thu, 16 Apr 2026 15:54:48 -0700
Subject: [PATCH] add heartbeat count to ActivityExecutionInfo

---
 openapi/openapiv2.json                 | 5 +++++
 openapi/openapiv3.yaml                 | 3 +++
 temporal/api/activity/v1/message.proto | 3 +++
 3 files changed, 11 insertions(+)

diff --git a/openapi/openapiv2.json b/openapi/openapiv2.json
index 02e2d1436..4f2bc1940 100644
--- a/openapi/openapiv2.json
+++ b/openapi/openapiv2.json
@@ -11443,6 +11443,11 @@
             "$ref": "#/definitions/v1Link"
           },
           "description": "Links to related entities, such as the entity that started this activity."
+        },
+        "totalHeartbeatCount": {
+          "type": "string",
+          "format": "int64",
+          "description": "Total number of heartbeats recorded across all attempts of this activity, including retries."
         }
       },
       "description": "Information about a standalone activity."
diff --git a/openapi/openapiv3.yaml b/openapi/openapiv3.yaml
index 2ceca06b4..04cd92cf7 100644
--- a/openapi/openapiv3.yaml
+++ b/openapi/openapiv3.yaml
@@ -8243,6 +8243,9 @@ components:
           items:
             $ref: '#/components/schemas/Link'
           description: Links to related entities, such as the entity that started this activity.
+        totalHeartbeatCount:
+          type: string
+          description: Total number of heartbeats recorded across all attempts of this activity, including retries.
       description: Information about a standalone activity.
     ActivityExecutionListInfo:
       type: object
diff --git a/temporal/api/activity/v1/message.proto b/temporal/api/activity/v1/message.proto
index febddb3ad..8262cf88b 100644
--- a/temporal/api/activity/v1/message.proto
+++ b/temporal/api/activity/v1/message.proto
@@ -165,6 +165,9 @@ message ActivityExecutionInfo {
 
     // Links to related entities, such as the entity that started this activity.
     repeated temporal.api.common.v1.Link links = 33;
+
+    // Total number of heartbeats recorded across all attempts of this activity, including retries.
+    int64 total_heartbeat_count = 34;
 }
 
 // Limited activity information returned in the list response.