Align workflow task history token field

Author: durable-workflow-ops

src/durable_workflow/client.py

@@ -2043,7 +2043,8 @@ async def workflow_task_history(
         self,
         *,
         task_id: str,
-        page_token: str,
+        next_history_page_token: str | None = None,
+        page_token: str | None = None,
         lease_owner: str,
         workflow_task_attempt: int,
     ) -> Any:
@@ -2052,8 +2053,15 @@ async def workflow_task_history(
         Worker-plane endpoint. The first page of history is delivered inline
         with the workflow task; this endpoint fetches subsequent pages.
         """
+        if next_history_page_token is None:
+            next_history_page_token = page_token
+        elif page_token is not None and page_token != next_history_page_token:
+            raise ValueError("page_token must match next_history_page_token when both are provided")
+        if next_history_page_token is None:
+            raise ValueError("next_history_page_token is required")
+
         body: dict[str, Any] = {
-            "page_token": page_token,
+            "next_history_page_token": next_history_page_token,
             "lease_owner": lease_owner,
             "workflow_task_attempt": workflow_task_attempt,
         }

src/durable_workflow/worker.py

@@ -393,7 +393,7 @@ async def _run_workflow_task_core(self, task: dict[str, Any]) -> list[dict[str,
             try:
                 page_data = await self.client.workflow_task_history(
                     task_id=task_id,
-                    page_token=next_page_token,
+                    next_history_page_token=next_page_token,
                     lease_owner=self.worker_id,
                     workflow_task_attempt=attempt,
                 )

tests/fixtures/control-plane/workflow-task-history-parity.json

@@ -6,7 +6,7 @@
     "method": "POST",
     "path": "/worker/workflow-tasks/workflow-task-231/history",
     "body": {
-      "page_token": "history-page-2",
+      "next_history_page_token": "history-page-2",
       "lease_owner": "polyglot-worker-231",
       "workflow_task_attempt": 2
     }
@@ -15,7 +15,7 @@
     "task_id": "workflow-task-231",
     "lease_owner": "polyglot-worker-231",
     "workflow_task_attempt": 2,
-    "page_token": "history-page-2",
+    "next_history_page_token": "history-page-2",
     "last_sequence": 4,
     "next_page_token": "history-page-3"
   },
@@ -52,7 +52,7 @@
     "method": "workflow_task_history",
     "kwargs": {
       "task_id": "workflow-task-231",
-      "page_token": "history-page-2",
+      "next_history_page_token": "history-page-2",
       "lease_owner": "polyglot-worker-231",
       "workflow_task_attempt": 2
     }