ContinueAsNew does not support specifying a new orchestration version

Summary

The continueAsNew() API does not expose a way to specify a new orchestration version for the restarted instance. The underlying protobuf field (CompleteOrchestrationAction.newVersion, field 4) has existed since the initial proto commit, but the Java SDK never populates it.

Problem

TaskOrchestrationContext.continueAsNew() only accepts (Object input, boolean preserveUnprocessedEvents). There is no parameter to pass a new version. In TaskOrchestrationExecutor, when building the CompleteOrchestrationAction, setNewVersion() is never called — the field is always left empty.

This prevents version migration scenarios for long-running/eternal orchestrations (e.g., monitoring loops that need to evolve their logic over time via continueAsNew with a new version).

What exists today

• Proto layer: CompleteOrchestrationAction.newVersion (field 4) is defined and supported by all backends (DurableTask.Core since 2014, DTS/Beskar, gRPC sidecar)
• Java API: continueAsNew(Object input) and continueAsNew(Object input, boolean preserveUnprocessedEvents) — no version parameter
• Java executor: CompleteOrchestrationAction.Builder never calls setNewVersion()

Proposed fix

Follow the pattern from the .NET SDK (microsoft/durabletask-dotnet#682):

1. Add a ContinueAsNewOptions class with newInput, preserveUnprocessedEvents, and newVersion properties
2. Add a continueAsNew(ContinueAsNewOptions options) overload to TaskOrchestrationContext
3. In TaskOrchestrationExecutor, when newVersion is non-null, call builder.setNewVersion(StringValue.of(newVersion)) on the CompleteOrchestrationAction

Related

• .NET SDK implementation: microsoft/durabletask-dotnet#682
• Azure Functions extension: Azure/azure-functions-durable-extension#3404
• Proto field: CompleteOrchestrationAction.newVersion (field 4) in orchestrator_service.proto

Bắt đầu bằng cách xác định TaskOrchestrationContext và TaskOrchestrationExecutor, sau đó kiểm tra các overload continueAsNew hiện có và việc tạo CompleteOrchestrationAction. Sử dụng issue của .NET SDK được liên kết trong phần mô tả làm tài liệu tham khảo cho dạng options được đề xuất. Công việc được xem là hoàn tất khi các caller Java có thể cung cấp một phiên bản mới và executor điền CompleteOrchestrationAction.newVersion mà vẫn giữ nguyên hành vi hiện tại.