[Feature]: Add pause/resume to the local runner HTTP API and CLI
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 48/100
Research direction
Start by reading the web runner and HTTP route implementations, the dex-local-runner CLI entry points, and the pause/resume behavior introduced by #757. Define the HTTP and CLI contracts, including bounded waits and error handling, then add unit tests for routes and CLI arguments and E2E coverage for pause and resume. Done means an in-flight local execution can be paused and resumed through both interfaces, with documented behavior for timeouts and invalid or completed executions.
Written by the indexing model from the issue text.
Description
What would you like?
Expose execution pause and resume through the local emulator's HTTP API and the dex-local-runner CLI.
This follows the request in the approval of PR #757. It is separate work, not a merge requirement for that PR.
The reviewer notes that SAM CLI runs the emulator as a container and calls its HTTP routes. Adding these routes would let SAM CLI add pause/resume commands in a separate change.
Possible Implementation
- Add pause/resume support to the web runner and its HTTP routes.
- Add CLI commands that call those routes for a specified execution ARN.
- Reuse the pause/resume behavior introduced by #757.
- Define request and response formats, timeout behavior, and error mapping.
- Document HTTP and CLI usage, including the experimental status of these controls.
Acceptance criteria
- Users can pause and resume a local execution through HTTP and through the CLI.
- Pause waits are bounded. A timeout clearly reports that the pause request remains applied.
- Repeated requests, completed executions, invalid ARNs, and unknown executions have documented behavior consistent with the underlying runner.
- Unit tests cover routes, CLI argument handling, and error responses.
- E2E tests cover pausing an in-flight execution and resuming it to completion through the HTTP API and CLI.
Is this a breaking change?
No. This adds local testing controls.
Does this require an RFC?
No RFC is proposed. Confirm the HTTP and CLI contracts during implementation.
Additional Context
- Follow-up to #757.
- SAM CLI changes belong in a separate follow-up. This issue provides the emulator support they would need.
- Dominant language
- Python
- Stars
- 59
- Forks
- 32
- Avg merge
- 1d 5h
- Merged PRs (30d)
- 76
Getting set up
- No Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from aws/aws-durable-execution-sdk-python
-
needs-triage
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
aws/aws-durable-execution-sdk-python#977 ·
Maintainers usually reply within 1 day
-
[AgentCore session] Remove the unused session timeoutPossibly taken @srivilliamsai claimed this today. Openneeds-triage
Difficulty 2/5 1-3 hours Newbie friendliness 77/100
aws/aws-durable-execution-sdk-python#970 · 1 comment ·
Maintainers usually reply within 1 day
-
enhancement needs-triage
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
aws/aws-durable-execution-sdk-python#952 ·
Maintainers usually reply within 1 day
-
[AgentCore session] W4: Document sessions in the worker READMEPossibly taken @ParidelPooya claimed this 3 days ago. Openenhancement needs-triage
Difficulty 1/5 1-3 hours Newbie friendliness 76/100
aws/aws-durable-execution-sdk-python#950 ·
Maintainers usually reply within 1 day
-
[AgentCore session] W3: Add the session ID and job count to worker logsPossibly taken @ParidelPooya claimed this 3 days ago. Openenhancement needs-triage
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
aws/aws-durable-execution-sdk-python#949 ·
Maintainers usually reply within 1 day
All issues in aws/aws-durable-execution-sdk-python
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 73/100
Maintainers usually reply within 1 day
-
Unused loot bag group names left in dreamcraft en_US.langPossibly taken A pull request linked to this issue is open or already merged. OpenStatus: Triage Suggestion
Difficulty 1/5 Under an hour Newbie friendliness 90/100
GTNewHorizons/GT-New-Horizons-Modpack#27789 ·
Maintainers usually reply within 1 day
-
bug frontend sev-5
Difficulty 2/5 1-3 hours Newbie friendliness 83/100
-
core good first issue
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
-
b4b code health next
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
ESCOMP/CTSM#4330 · 1 comment ·
Maintainers usually reply within 1 day