Skip to content

🤖 feat: add dynamic workflows #3431

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ThomasK33 merged 17 commits into from
Jun 4, 2026
Merged

🤖 feat: add dynamic workflows #3431

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
dfdec28
🤖 feat: add dynamic workflows
ThomasK33 Jun 3, 2026
417999a
feat: add workflow applyPatch primitive
ThomasK33 Jun 4, 2026
ce0d7ca
fix: route deep research reasoning to exec agents
ThomasK33 Jun 4, 2026
7235aae
fix: route deep review reasoning to exec agents
ThomasK33 Jun 4, 2026
5e4c289
fix: keep workflow explore steps read-only compatible
ThomasK33 Jun 4, 2026
866f854
fix: keep slash workflow waits alive
ThomasK33 Jun 4, 2026
f3ea058
fix: unpin composer while workflows poll
ThomasK33 Jun 4, 2026
c0cbe01
fix: continue slash workflows from backend
ThomasK33 Jun 4, 2026
12a0fa0
fix: gate backend workflow continuations
ThomasK33 Jun 4, 2026
6aa3099
fix: skip superseded workflow tool continuations
ThomasK33 Jun 4, 2026
c59ee7e
fix: wait for workflow tool call persistence
ThomasK33 Jun 4, 2026
93bf9bd
fix: avoid queued workflow continuations
ThomasK33 Jun 4, 2026
b2c72d6
test: update workflow creation continuation expectation
ThomasK33 Jun 4, 2026
eeb7b33
test: relax workflow crash-retry wait
ThomasK33 Jun 4, 2026
5d7883f
fix: include TypeScript libs in Docker runtime
ThomasK33 Jun 4, 2026
e0094e6
fix: continue resumed backgrounded workflows
ThomasK33 Jun 4, 2026
4e96219
fix: wait for workflow invocation persistence
ThomasK33 Jun 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
110 changes: 0 additions & 110 deletions CONTEXT.md
View file
Open in desktop

This file was deleted.

3 changes: 3 additions & 0 deletions Dockerfile
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -113,6 +113,9 @@ COPY --from=builder /app/dist/*.html ./dist/
COPY --from=builder /app/dist/*.css ./dist/
COPY --from=builder /app/dist/*.js ./dist/

# Copy TypeScript lib files used by the bundled PTC validator at server startup.
COPY --from=builder /app/dist/typescript-lib ./dist/typescript-lib

# Copy runtime bundles last (most volatile layer during backend iteration).
COPY --from=builder /app/dist/runtime ./dist/runtime

Expand Down
1 change: 1 addition & 0 deletions Makefile
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -282,6 +282,7 @@ verify-docker-runtime-artifacts: build-docker-runtime ## Verify required Docker
@test -f dist/runtime/server-bundle.js
@test -f dist/runtime/tokenizer.worker.js
@test -f dist/static/splash.html
@test -f dist/typescript-lib/lib.es2023.d.ts.txt

# Bundle server runtime for Docker image to reduce runtime dependencies/image size.
# Depend on build-main explicitly because dist/cli/server.js is emitted as a side effect.
Expand Down
4 changes: 2 additions & 2 deletions bun.lock
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

37 changes: 30 additions & 7 deletions docs/hooks/tools.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -227,12 +227,15 @@ If a value is too large for the environment, it may be omitted (not set). Mux al
</details>

<details>
<summary>agent_report (2)</summary>
<summary>agent_report (5)</summary>

| Env var | JSON path | Type | Description |
| -------------------------------- | ---------------- | ------ | ----------- |
| `MUX_TOOL_INPUT_REPORT_MARKDOWN` | `reportMarkdown` | string | — |
| `MUX_TOOL_INPUT_TITLE` | `title` | string | — |
| Env var | JSON path | Type | Description |
| --------------------------------------- | ---------------------- | ------- | ------------------------------------------------------------------------------------ |
| `MUX_TOOL_INPUT_REPORT_MARKDOWN` | `reportMarkdown` | string | — |
| `MUX_TOOL_INPUT_REPORT_MARKDOWN_PATH` | `reportMarkdownPath` | string | Path to the markdown report file, usually report.md in the workspace root |
| `MUX_TOOL_INPUT_STRUCTURED_OUTPUT` | `structuredOutput` | unknown | — |
| `MUX_TOOL_INPUT_STRUCTURED_OUTPUT_PATH` | `structuredOutputPath` | string | Path to a JSON file containing the structured output, usually structured-output.json |
| `MUX_TOOL_INPUT_TITLE` | `title` | string | — |

</details>

Expand Down Expand Up @@ -633,8 +636,8 @@ If a value is too large for the environment, it may be omitted (not set). Mux al
| `MUX_TOOL_INPUT_FILTER` | `filter` | string | Optional regex to filter bash task output lines. By default, only matching lines are returned. When filter_exclude is true, matching lines are excluded instead. Non-matching lines are discarded and cannot be retrieved later. |
| `MUX_TOOL_INPUT_FILTER_EXCLUDE` | `filter_exclude` | boolean | When true, lines matching 'filter' are excluded instead of kept. Requires 'filter' to be set. |
| `MUX_TOOL_INPUT_MIN_COMPLETED` | `min_completed` | number | Number of awaited tasks that must complete before this call returns. Defaults to 1, so by default task_await returns as soon as the FIRST awaited task completes, letting you act on it while the rest keep running. The result still includes every task complete at that moment plus current status (running/queued) for the rest. Tasks that have not yet completed keep running and remain re-awaitable on a later task_await call. Raise this (e.g. set it to the total number of awaited tasks) when you genuinely need more before proceeding — for example best-of-N synthesis that must compare every candidate. Clamped to the number of awaited tasks; values above that behave like 'wait for all'. |
| `MUX_TOOL_INPUT_TASK_IDS_<INDEX>` | `task_ids[<INDEX>]` | string | List of task IDs to await — use only real IDs returned by prior task, bash, or task_list tool results; never fabricate an ID. When omitted, waits for all active descendant tasks of the current workspace. |
| `MUX_TOOL_INPUT_TASK_IDS_COUNT` | `task_ids.length` | number | Number of elements in task_ids (List of task IDs to await — use only real IDs returned by prior task, bash, or task_list tool results; never fabricate an ID. When omitted, waits for all active descendant tasks of the current workspace.) |
| `MUX_TOOL_INPUT_TASK_IDS_<INDEX>` | `task_ids[<INDEX>]` | string | List of task IDs or workflow run IDs to await — use only real IDs returned by prior task, bash, workflow_run, or task_list tool results; never fabricate an ID. When omitted, waits for all active descendant tasks and workflow runs of the current workspace. |
| `MUX_TOOL_INPUT_TASK_IDS_COUNT` | `task_ids.length` | number | Number of elements in task_ids (List of task IDs or workflow run IDs to await — use only real IDs returned by prior task, bash, workflow_run, or task_list tool results; never fabricate an ID. When omitted, waits for all active descendant tasks and workflow runs of the current workspace.) |
| `MUX_TOOL_INPUT_TIMEOUT_SECS` | `timeout_secs` | number | Maximum time to wait in seconds for each task. For bash tasks, this waits for NEW output (or process exit). If exceeded, the result returns status=queued\|running\|awaiting_report (task is still active). Defaults to 600 seconds (10 minutes) if not specified. Set to 0 for a non-blocking status check. |

</details>
Expand Down Expand Up @@ -679,6 +682,26 @@ If a value is too large for the environment, it may be omitted (not set). Mux al

</details>

<details>
<summary>workflow_read (1)</summary>

| Env var | JSON path | Type | Description |
| --------------------- | --------- | ------ | ----------- |
| `MUX_TOOL_INPUT_NAME` | `name` | string | — |

</details>

<details>
<summary>workflow_run (3)</summary>

| Env var | JSON path | Type | Description |
| ---------------------------------- | ------------------- | ------- | ----------- |
| `MUX_TOOL_INPUT_ARGS` | `args` | unknown | — |
| `MUX_TOOL_INPUT_NAME` | `name` | string | — |
| `MUX_TOOL_INPUT_RUN_IN_BACKGROUND` | `run_in_background` | boolean | — |

</details>

{/* END TOOL_HOOK_ENV_VARS */}

</Accordion>
Expand Down
4 changes: 2 additions & 2 deletions package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -121,8 +121,10 @@
"posthog-node": "^5.17.0",
"quickjs-emscripten": "^0.31.0",
"quickjs-emscripten-core": "^0.31.0",
"react": "18.3.1",
"react-colorful": "^5.6.1",
"react-resizable-panels": "^3.0.6",
"react-dom": "18.3.1",
"react-router-dom": "^7.11.0",
"recharts": "^2.15.3",
"rehype-harden": "^1.1.5",
Expand Down Expand Up @@ -211,13 +213,11 @@
"postcss": "^8.5.6",
"posthog-js": "^1.276.0",
"prettier": "^3.6.2",
"react": "^18.2.0",
"react-compiler-runtime": "^1.0.0",
"react-dnd": "^16.0.1",
"react-dnd-html5-backend": "^16.0.1",
"react-dnd-test-backend": "^16.0.1",
"react-dnd-test-utils": "^16.0.1",
"react-dom": "^18.2.0",
"rehype-katex": "^7.0.1",
"rehype-raw": "^7.0.0",
"remark-gfm": "^4.0.1",
Expand Down
Loading
Loading