Refactor ScheduleJobAsync to use ScheduleJobRequest struct

[Copilot]

ILocalDurableJobManager.ScheduleJobAsync took 4 individual parameters before the CancellationToken, making future API evolution breaking. Consolidated into a ScheduleJobRequest struct for extensibility.

Changes

• Added ScheduleJobRequest struct with Target, JobName, DueTime, and Metadata properties
• Updated method signatures:
  • ILocalDurableJobManager.ScheduleJobAsync(ScheduleJobRequest, CancellationToken)
  • IJobShard.TryScheduleJobAsync(ScheduleJobRequest, CancellationToken)
• Updated implementations in LocalDurableJobManager and JobShard
• Updated all call sites across test grains, test runners, and documentation

Example

Before:

await _jobManager.ScheduleJobAsync(
    this.GetGrainId(),
    "SendNotification",
    sendTime,
    metadata,
    CancellationToken.None);

After:

await _jobManager.ScheduleJobAsync(
    new ScheduleJobRequest
    {
        Target = this.GetGrainId(),
        JobName = "SendNotification",
        DueTime = sendTime,
        Metadata = metadata
    },
    CancellationToken.None);

New properties can now be added to ScheduleJobRequest without changing method signatures.

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Microsoft Reviewers: Open in CodeFlow

[Copilot]

Pull request overview

This PR refactors the ScheduleJobAsync API to improve extensibility by consolidating multiple parameters into a ScheduleJobRequest struct. This change prevents future API breaking changes when adding new properties, following a common pattern for evolving public APIs.

Changes:

• Introduced ScheduleJobRequest struct with Target, JobName, DueTime, and Metadata properties
• Updated method signatures in ILocalDurableJobManager and IJobShard to accept the struct instead of individual parameters
• Updated all implementations and call sites across test grains, test runners, and documentation

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
src/Orleans.DurableJobs/ScheduleJobRequest.cs	New struct defining the job scheduling request with required properties and optional metadata
src/Orleans.DurableJobs/ILocalDurableJobManager.cs	Updated interface to accept ScheduleJobRequest instead of individual parameters
src/Orleans.DurableJobs/LocalDurableJobManager.cs	Updated implementation to extract values from the request struct
src/Orleans.DurableJobs/JobShard.cs	Updated interface and implementation to use ScheduleJobRequest
src/Orleans.DurableJobs/README.md	Updated documentation examples to show new API usage (contains syntax error)
src/Azure/Orleans.DurableJobs.AzureStorage/README.md	Updated Azure-specific documentation examples (contains syntax error)
test/Grains/TestGrains/DurableJobGrain.cs	Updated test grain to construct ScheduleJobRequest
test/Grains/TestGrains/RetryTestGrain.cs	Updated test grain to construct ScheduleJobRequest
test/Grains/TestGrains/SchedulerGrain.cs	Updated test grain to construct ScheduleJobRequest
test/Tester/DurableJobs/JobShardManagerTestsRunner.cs	Updated test runner to use new struct initialization syntax
test/Extensions/TesterAzureUtils/DurableJobs/AzureStorageJobShardBatchingTests.cs	Updated Azure storage tests to use new struct initialization syntax