From ad26fa071a0a22de66cdfdbcd56fc342b4e75104 Mon Sep 17 00:00:00 2001
From: Sangkyoon Nam <sangkyoon.nam@namsang.co>
Date: Wed, 16 Sep 2026 21:24:06 +0900
Subject: [PATCH] Report the actual started event id on workflow task poll in
 the test server

---
 .../internal/testservice/StateMachines.java   |  4 +-
 .../WorkflowTaskStartedEventIdTest.java       | 79 +++++++++++++++++++
 2 files changed, 82 insertions(+), 1 deletion(-)
 create mode 100644 temporal-test-server/src/test/java/io/temporal/testserver/functional/WorkflowTaskStartedEventIdTest.java

diff --git a/temporal-test-server/src/main/java/io/temporal/internal/testservice/StateMachines.java b/temporal-test-server/src/main/java/io/temporal/internal/testservice/StateMachines.java
index fce9d3ae01..6454783c64 100644
--- a/temporal-test-server/src/main/java/io/temporal/internal/testservice/StateMachines.java
+++ b/temporal-test-server/src/main/java/io/temporal/internal/testservice/StateMachines.java
@@ -1815,7 +1815,9 @@ private static void startWorkflowTaskImpl(
     ctx.onCommit(
         (historySize) -> {
           PollWorkflowTaskQueueResponse.Builder task = data.workflowTask;
-          task.setStartedEventId(data.scheduledEventId + 1);
+          if (!queryOnly) {
+            task.setStartedEventId(startedEventId);
+          }
           WorkflowTaskToken taskToken = new WorkflowTaskToken(ctx.getExecutionId(), historySize);
           task.setTaskToken(taskToken.toBytes());
           GetWorkflowExecutionHistoryRequest getRequest =
diff --git a/temporal-test-server/src/test/java/io/temporal/testserver/functional/WorkflowTaskStartedEventIdTest.java b/temporal-test-server/src/test/java/io/temporal/testserver/functional/WorkflowTaskStartedEventIdTest.java
new file mode 100644
index 0000000000..e6c01c87db
--- /dev/null
+++ b/temporal-test-server/src/test/java/io/temporal/testserver/functional/WorkflowTaskStartedEventIdTest.java
@@ -0,0 +1,79 @@
+package io.temporal.testserver.functional;
+
+import static io.temporal.internal.common.InternalUtils.createNormalTaskQueue;
+import static org.junit.Assert.assertEquals;
+
+import com.google.protobuf.util.Durations;
+import io.temporal.api.common.v1.WorkflowExecution;
+import io.temporal.api.common.v1.WorkflowType;
+import io.temporal.api.enums.v1.EventType;
+import io.temporal.api.history.v1.HistoryEvent;
+import io.temporal.api.workflowservice.v1.PollWorkflowTaskQueueResponse;
+import io.temporal.api.workflowservice.v1.StartWorkflowExecutionRequest;
+import io.temporal.serviceclient.WorkflowServiceStubs;
+import io.temporal.serviceclient.WorkflowServiceStubsOptions;
+import io.temporal.testing.internal.TestServiceUtils;
+import io.temporal.testserver.TestServer;
+import java.util.UUID;
+import java.util.concurrent.TimeUnit;
+import org.junit.After;
+import org.junit.Before;
+import org.junit.Test;
+
+public class WorkflowTaskStartedEventIdTest {
+
+  private final String NAMESPACE = "namespace";
+  private final String TASK_QUEUE = "taskQueue";
+  private final String WORKFLOW_TYPE = "wfType";
+
+  private TestServer.InProcessTestServer testServer;
+  private WorkflowServiceStubs workflowServiceStubs;
+
+  @Before
+  public void setUp() {
+    this.testServer = TestServer.createServer(true);
+    this.workflowServiceStubs =
+        WorkflowServiceStubs.newServiceStubs(
+            WorkflowServiceStubsOptions.newBuilder()
+                .setChannel(testServer.getChannel())
+                .validateAndBuildWithDefaults());
+  }
+
+  @After
+  public void tearDown() {
+    this.workflowServiceStubs.shutdownNow();
+    this.workflowServiceStubs.awaitTermination(1, TimeUnit.SECONDS);
+    this.testServer.close();
+  }
+
+  @Test
+  public void startedEventIdMatchesStartedEventWhenSignalArrivesBeforePoll() throws Exception {
+    String workflowId = UUID.randomUUID().toString();
+    workflowServiceStubs
+        .blockingStub()
+        .startWorkflowExecution(
+            StartWorkflowExecutionRequest.newBuilder()
+                .setRequestId(UUID.randomUUID().toString())
+                .setNamespace(NAMESPACE)
+                .setWorkflowId(workflowId)
+                .setTaskQueue(createNormalTaskQueue(TASK_QUEUE))
+                .setWorkflowRunTimeout(Durations.fromSeconds(100))
+                .setWorkflowTaskTimeout(Durations.fromSeconds(100))
+                .setWorkflowType(WorkflowType.newBuilder().setName(WORKFLOW_TYPE))
+                .build());
+    // The signal lands between WorkflowTaskScheduled and WorkflowTaskStarted.
+    TestServiceUtils.signalWorkflow(
+        WorkflowExecution.newBuilder().setWorkflowId(workflowId).build(),
+        NAMESPACE,
+        workflowServiceStubs);
+
+    PollWorkflowTaskQueueResponse response =
+        TestServiceUtils.pollWorkflowTaskQueue(
+            NAMESPACE, createNormalTaskQueue(TASK_QUEUE), workflowServiceStubs);
+
+    HistoryEvent started =
+        response.getHistory().getEvents(response.getHistory().getEventsCount() - 1);
+    assertEquals(EventType.EVENT_TYPE_WORKFLOW_TASK_STARTED, started.getEventType());
+    assertEquals(started.getEventId(), response.getStartedEventId());
+  }
+}