feat(workflow): run and resume workflows from the CLI by Waishnav · Pull Request #97 · Waishnav/devspace

Waishnav · 2026-07-21T16:24:26Z

The engine from #96 was only an in-process API. Users still needed a durable way to resolve scripts, launch runs independently of the initiating shell, inspect or cancel them later, isolate agent changes, resume prior work, and request structured output.

Add named and file-based script resolution, per-call workflow worktrees, the initial replay implementation, and JSON Schema enforcement for agent() results. A detached CLI worker now owns run execution and heartbeat state, while workflow run, status, cancel, and ls provide the first user-facing lifecycle controls.

Stack

Based on #96 and merged into #94 before the MCP and skill integration in #98.

Named/file script resolve, agent worktree factory, resume matcher (index+key then consume-once), and Ajv schema enforcement wired into agent(). Adds ajv dependency. Co-Authored-By: Claude <noreply@anthropic.com>

Detached __worker with heartbeat/cancel, real adapters via runLocalAgentProvider, worktree isolation, and resume wiring. setScriptPath persists script after run create. Co-Authored-By: Claude <noreply@anthropic.com>

Always include bundled skills root when subagents enabled so seeding subagent-delegation no longer hides later skills. Seed dynamic-workflows alongside subagent-delegation on init. Co-Authored-By: Claude <noreply@anthropic.com>

Load ordered enable-list from config/env, probe available providers on init and doctor, and filter workflow CLI providers by enabled∩live. Co-Authored-By: Claude <noreply@anthropic.com>

Gate on config.subagents. run_workflow spawns the same detached worker as CLI; status long-polls journal events; cancel requests cooperative stop. Co-Authored-By: Claude <noreply@anthropic.com>

coderabbitai · 2026-07-21T16:24:32Z

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 0d3c0eb5-ccfa-4432-8970-e6834e11b050

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch pr/dw-4-cli-worker

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

Waishnav · 2026-07-21T17:25:23Z

+    });
+
+    const persisted =
+      priorScriptPath ??


[P0] Resume reuses the prior mutable script path and does not verify that the new run is in the same repository/workspace/base SHA. This can replay repository A in B, and prior.scriptHash can disagree with edited bytes executed later. Snapshot the exact validated source under the new run ID and require a matching repository identity/base revision (or an explicit override) before replay.

Partially addressed by stacked PR #108 (c8f0b65). Resume now reads the selected source, recomputes its hash, persists a fresh per-run script snapshot, updates the new run to that snapshot path, and the worker executes those exact bytes. That fixes the mutable prior-path / stale scriptHash half of this finding. The repository identity half is still open: resume does not require matching workspaceId/workspaceRoot/baseSha, so cross-workspace replay is still possible. Keeping this thread unresolved for that remaining check.

The mutable-source/hash half was addressed in #108, and PR #116 completes the replay contract with exact return-value persistence plus deterministic same-index prefix reuse. Mandatory workspace/repository identity matching is intentionally not added: runId and resume are designed to remain usable from Cursor, Pi, OpenCode, CLI, and other harnesses that do not own a DevSpace workspace ID. Project-local workflow path confinement is handled separately in the next follow-up rather than through workspace-ID authorization.

Waishnav · 2026-07-21T17:25:25Z

+    console.log(formatRunLine(run));
+    if (run.pid && (run.status === "running" || run.status === "starting")) {
+      try {
+        process.kill(run.pid, "SIGTERM");


[P0] Sending SIGTERM immediately after setting the cooperative flag usually kills the worker before it can observe cancellation, clean up worktrees, or write terminal events. Please centralize CLI/MCP cancellation in a supervisor: request cancel, wait a grace period, then use the cross-platform terminateProcessTree fallback and atomically mark the run cancelled. The supervisor should also schedule reapStale().

Addressed by follow-up PR #115 (15be40e, 5a7a3db). CLI cancellation now uses the shared lifecycle supervisor: set the cooperative flag, wait a grace period, terminate the detached process tree through the cross-platform helper, escalate to SIGKILL when necessary, and atomically mark the run cancelled as a fallback. The server also schedules stale-worker reaping.

Waishnav · 2026-07-21T17:25:27Z

+      }
+    }
+
+    store.completeRun(runId, { resultJson });


[P1] The run becomes completed before run_completed is appended. A status poll can observe terminal state and stop before the terminal event exists. Please update terminal status and append the corresponding terminal event in one SQLite transaction; use the same path for failed and cancelled runs.

Addressed by follow-up PR #115 (dfbf5a1). Completed, failed, and cancelled transitions now update the run row and append the matching terminal event inside one immediate SQLite transaction. Pollers can no longer observe terminal status before its terminal event exists.

Waishnav · 2026-07-21T17:25:34Z

+function toHit(call: WorkflowAgentCallRecord): WorkflowReplayHit {
+  if (call.structuredJson) {
+    try {
+      return {


[P0] Replay restores only the previous return value; it does not recreate filesystem side effects or reconnect the preserved worktree. A cached mutating agent can report success while the new run contains none of its changes. Please make mutating calls non-cacheable by default, or persist/apply a patch or resume the exact worktree as part of the replay contract.

Addressed by follow-up PR #116 (57229cb, d12fc43). Resume now reuses only the longest unchanged same-index call prefix. The first mismatch closes replay for every later call. Worktree-isolated calls are explicitly non-replayable until DevSpace can restore their exact worktree, so a cached success can no longer stand in for absent worktree changes. Shared-checkout calls retain Claude Code-like prefix behavior and assume their filesystem effects remain in the checkout.

Wire LocalAgentRunInput.schema through CodexSdkLocalAgentRuntime to thread.run turn options, and surface parsed structured output.

Pass JSON Schema via outputFormat on query options and prefer structured_output from result messages. OpenCode stays prompt-path only.

Hardcode NATIVE_SCHEMA_PROVIDERS; attempt 0 uses adapter schema without prompt bloat, then prompt-repair retries with Ajv. Wire schema through runProvider / CLI worker. Document in skill.

refactor(agents): unify provider resolution and subagent guidance

feat(workflow): support agent profiles and project workflows

fix(workflow): replay deterministic call prefixes

fix(workflow): supervise cancellation and terminal lifecycle

feat(workflow): isolate workflow script execution

feat(ui): live workspace and workflow dashboards

feat(workflow): read-only project workflow TUI

feat(workflow): script iteration, replay provenance, and call inspection

refactor(workflow): model operational failures with better-result

refactor(workflow): strengthen contracts and zod boundaries

feat(agents): native schema for codex/claude agent({ schema })

feat(workflow): MCP tools, skill, agentProviders

Waishnav and others added 5 commits July 21, 2026 17:26

feat(workflow): add files, worktrees, replay, and schema

d5ea59d

Named/file script resolve, agent worktree factory, resume matcher (index+key then consume-once), and Ajv schema enforcement wired into agent(). Adds ajv dependency. Co-Authored-By: Claude <noreply@anthropic.com>

feat(workflow): add CLI run/status/cancel/ls and worker

d14d67c

Detached __worker with heartbeat/cancel, real adapters via runLocalAgentProvider, worktree isolation, and resume wiring. setScriptPath persists script after run create. Co-Authored-By: Claude <noreply@anthropic.com>

feat(agents): add agentProviders config + init/doctor probe

349b52c

Load ordered enable-list from config/env, probe available providers on init and doctor, and filter workflow CLI providers by enabled∩live. Co-Authored-By: Claude <noreply@anthropic.com>

feat(workflow): register MCP run/status/cancel tools

e1ec049

Gate on config.subagents. run_workflow spawns the same detached worker as CLI; status long-polls journal events; cancel requests cooperative stop. Co-Authored-By: Claude <noreply@anthropic.com>

Waishnav commented Jul 21, 2026

View reviewed changes

Comment thread src/workflow-schema.ts Outdated

Waishnav commented Jul 21, 2026

View reviewed changes

Comment thread src/workflow-files.test.ts Outdated

Waishnav commented Jul 21, 2026

View reviewed changes

Waishnav and others added 18 commits July 21, 2026 22:55

feat(agents): pass schema as Codex turn outputSchema

3030d86

Wire LocalAgentRunInput.schema through CodexSdkLocalAgentRuntime to thread.run turn options, and surface parsed structured output.

feat(agents): Claude native outputFormat + structured_output

6af99da

Pass JSON Schema via outputFormat on query options and prefer structured_output from result messages. OpenCode stays prompt-path only.

feat(workflow): native-first schema for codex/claude agent()

7d797e3

Hardcode NATIVE_SCHEMA_PROVIDERS; attempt 0 uses adapter schema without prompt bloat, then prompt-repair retries with Ajv. Wire schema through runProvider / CLI worker. Document in skill.

fix(workflow): make native schema fallback session-aware

a8b8e5a

test(workflow): normalize persisted paths on windows

3343404

refactor(workflow): strengthen contracts and zod boundaries

4cb4007

refactor(workflow): model operational failures with better-result

d5b00f5

feat(workflow): persist replay provenance

f9a1dc7

feat(workflow): add script iteration and call inspection

c8f0b65

docs(workflow): teach recovery without budget stub

058297b

feat(workflow): query runs by workspace

332aa8e

feat(workflow): project workflow read model

a499c2e

feat(workflow): add read-only project TUI

5ee0022

feat(workflow): add UI snapshot projections

dbe26f7

feat(workflow): expose read-only app snapshots

d3643e8

feat(ui): recognize workflow result cards

57296a6

feat(ui): add live workspace and workflow dashboards

4bc9558

docs(ui): document read-only workflow dashboards

4777bab

Waishnav added 25 commits July 27, 2026 13:01

refactor(config): remove experimental provider persistence

620b180

refactor(agents): share execution target resolution

d640cf8

refactor(agents): describe provider model and effort capabilities

f2482bb

refactor(features): separate subagent and workflow capabilities

321b81c

fix(workspace): expose only usable agent capabilities

69fee30

refactor(skills): replace subagent delegation guidance

f25d8e9

docs(skills): add provider-specific override references

2f17478

fix(skills): keep bundled agent skills package-managed

f214c19

refactor(workflow): name live provider availability accurately

1ace1f0

docs(agents): document experimental capability boundaries

5c1ddea

test(workflow): follow provider availability rename

691998e

docs(config): describe effective agent capability gates

5bf5374

feat(agents): discover usable delegation targets

562e54a

feat(workflow): merge dw-16 agent/subagent overhaul (#118)

b347a82

refactor(agents): unify provider resolution and subagent guidance

feat(workflow): merge dw-15 profiles and project workflows (#117)

b677c3e

feat(workflow): support agent profiles and project workflows

Merge pull request #116 from pr/dw-14-prefix-replay-integrity

8ce8274

fix(workflow): replay deterministic call prefixes

Merge pull request #115 from pr/dw-13-workflow-lifecycle-supervisor

0b0f5e2

fix(workflow): supervise cancellation and terminal lifecycle

Merge pull request #114 from pr/dw-12-sandbox-process-boundary

e3ffd22

feat(workflow): isolate workflow script execution

Merge pull request #112 from pr/dw-11-workflow-mcp-ui

0328090

feat(ui): live workspace and workflow dashboards

Merge pull request #111 from pr/dw-10-workflow-tui

6b449e6

feat(workflow): read-only project workflow TUI

Merge pull request #108 from pr/dw-9-resume-iteration-inspection

1a6764d

feat(workflow): script iteration, replay provenance, and call inspection

Merge pull request #101 from pr/dw-8-result-errors

1e21ad1

refactor(workflow): model operational failures with better-result

Merge pull request #100 from pr/dw-7-typed-contracts-zod

d052520

refactor(workflow): strengthen contracts and zod boundaries

Merge pull request #99 from pr/dw-6-native-schema

7304a6a

feat(agents): native schema for codex/claude agent({ schema })

Merge pull request #98 from pr/dw-5-mcp-skill

171d43f

feat(workflow): MCP tools, skill, agentProviders

Waishnav marked this pull request as ready for review July 27, 2026 15:05

Waishnav merged commit a28337e into pr/dw-3-engine Jul 27, 2026
3 checks passed

This was referenced Jul 30, 2026

feat(workflow): add composable workflow execution #96

Merged

feat(workflow): expose dynamic workflows through MCP #98

Merged

Waishnav changed the title ~~feat(workflow): CLI worker, worktrees, resume, schema~~ feat(workflow): run and resume workflows from the CLI Jul 30, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(workflow): run and resume workflows from the CLI - #97

feat(workflow): run and resume workflows from the CLI#97
Waishnav merged 70 commits into
pr/dw-3-enginefrom
pr/dw-4-cli-worker

Waishnav commented Jul 21, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot commented Jul 21, 2026 •

edited

Loading

Review skipped

Uh oh!

Waishnav Jul 21, 2026

Uh oh!

Waishnav Jul 26, 2026

Uh oh!

Waishnav Jul 26, 2026

Uh oh!

Waishnav Jul 21, 2026

Uh oh!

Waishnav Jul 26, 2026

Uh oh!

Waishnav Jul 21, 2026

Uh oh!

Waishnav Jul 26, 2026

Uh oh!

Uh oh!

Uh oh!

Waishnav Jul 21, 2026

Uh oh!

Waishnav Jul 26, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

Waishnav commented Jul 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Stack

Uh oh!

coderabbitai Bot commented Jul 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review skipped

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Waishnav commented Jul 21, 2026 •

edited

Loading

coderabbitai Bot commented Jul 21, 2026 •

edited

Loading