fabro/lib/crates
fabro-sh-0530[bot] e3bbe91053
Add GET/POST /automations/{id}/runs endpoints (#442)
## Summary

Implements the two automation run endpoints from issue #399, backed by a
significant refactor of the worker control channel from stdin JSONL to a
WebSocket-based pub/sub bus.

## What changed

### New API endpoints (`automations.rs`)

- `GET /automations/{id}/runs` — lists cached runs filtered to those
linked to the given automation ID, sorted newest-first, with
`page[limit]`/`page[offset]` pagination and the standard `{ data, meta
}` envelope.
- `POST /automations/{id}/runs` — requires `RequiredRunToolActor` auth,
checks that the automation exists and has an enabled API trigger
(returning 409 with `automation_api_trigger_disabled` otherwise),
materializes the run manifest, and delegates to the shared
`create_run_from_manifest` helper with a fully-populated
`AutomationRef`.

### `enabled_api_trigger()` helper (`fabro-automation`)

A new method on `Automation` encapsulates the "automation is enabled
**and** has an enabled API trigger" check, keeping the handler clean.

### Worker control channel: stdin JSONL → WebSocket bus

The most significant structural change is how the server delivers
control messages (answers, cancel, pause/unpause, steer, pair events) to
running workers:

| Before | After |
|---|---|
| Server pipes JSONL lines to worker stdin | Server publishes to
`WorkerControlBus`; worker connects via WebSocket |
| Worker reads stdin on a blocking OS thread | Worker manages a
reconnecting WebSocket with ping/pong liveness |
| No delivery deduplication | `AppliedWorkerControlDeliveryIds`
deduplicates replayed frames |
| No reconnect / resume | Worker reconnects with exponential backoff;
replays from last applied cursor |

The `LocalWorkerControlBus` replaces the old `mpsc` channel and stdin
pipe. `RunAnswerTransport::Subprocess` is renamed `Worker` and holds a
`run_id` + `Arc<dyn WorkerControlBus>` instead of a channel sender.
Worker stdin is now `Stdio::null()`.

New control messages `RunPause` / `RunUnpause` are added to the
protocol, wired through to `RunControlState`.

### Plan Summary

- Add `enabled_api_trigger()` to `Automation`.
- Implement `list_automation_runs` and `create_automation_run` handlers;
route them under `/automations/{id}/runs`.
- Expose `create_run_from_manifest` from the runs handler for reuse.
- Add `RequiredRunToolActor` extractor.
- Replace stdin JSONL worker control with `WorkerControlBus` + WebSocket
reconnect loop in the CLI worker.
- Add integration tests for all 409/201 cases, run persistence, listing
filters, pagination, and sorting.


### Fabro Details

<details>
<summary>Ran 8 stages in 51m 5s for $21.34</summary>

| Stage | Duration | Cost | Retries |
|---|---|---|---|
| start | 0s | – | 0 |
| toolchain | 1s | – | 0 |
| preflight_compile | 2m 8s | – | 0 |
| preflight_lint | 2m 23s | – | 0 |
| implement | 20m 52s | $13.05 | 0 |
| simplify_opus | 11m 5s | $5.70 | 0 |
| simplify_gpt | 5m 0s | $2.60 | 0 |
| verify | 9m 4s | – | 0 |
| **Total** | **51m 5s** | **$21.34** | **0** |

</details>

<details>
<summary>Ran <code>ImplementPlan.fabro</code> (11 nodes and 14
edges)</summary>

```dot
digraph ImplementPlan {
    graph [
        goal="Implement and simplify",
        model_stylesheet="
            * { model: claude-opus-4-7; }
        "
    ]
    rankdir=LR

    start [shape=Mdiamond, label="Start"]
    exit  [shape=Msquare, label="Exit"]

    toolchain         [label="Toolchain", shape=parallelogram, script="command -v cargo >/dev/null || { curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y && sudo ln -sf $HOME/.cargo/bin/* /usr/local/bin/; }; cargo --version 2>&1", max_retries=0]
    preflight_compile [label="Preflight Compile", shape=parallelogram, script="cargo check -q --workspace 2>&1", max_retries=0]
    preflight_lint    [label="Preflight Lint", shape=parallelogram, script="cargo +nightly-2026-04-14 clippy -q --workspace --all-targets -- -D warnings 2>&1", max_retries=0]
    fix_lints         [label="Fix Lints", prompt="The preflight lint step failed. Read the build output from context and fix all clippy lint warnings.", max_visits=3]
    implement         [label="Implement", prompt="Read the plan file referenced in the goal and implement every step. Make all the code changes described in the plan. Use red/green TDD.", model="gpt-55", reasoning_effort="xhigh"]
    simplify_opus     [label="Simplify (Opus)", prompt="@prompts/simplify.md"]
    simplify_gpt      [label="Simplify (GPT-55)", prompt="@prompts/simplify.md", model="gpt-55"]
    verify            [label="Verify", shape=parallelogram, script="git fetch origin main 2>&1 && git merge --no-edit --no-stat origin/main 2>&1 && cargo +nightly-2026-04-14 fmt --all 2>&1 && cargo dev docs refresh 2>&1 && cargo +nightly-2026-04-14 fmt --check --all 2>&1 && { command -v rg >/dev/null 2>&1 || { echo 'rg is required for verify'; exit 127; }; } && ! rg -n 'AuthMode::Disabled|RunAuthMethod|RunSubjectProvenance|\bActorRef\b|\bActorKind\b|AuthenticatedSubject|AuthenticatedService|AuthorizeRunScoped|AuthorizeRunBlob|AuthorizeStageArtifact|AuthorizeCommandLog|auth_method\s*==\s*\"disabled\"' lib/crates apps lib/packages docs/public/api-reference/fabro-api.yaml 2>&1 && cargo +nightly-2026-04-14 clippy --workspace --all-targets -- -D warnings 2>&1 && cargo nextest run --workspace --status-level slow --profile ci 2>&1 && cargo dev docs check 2>&1 && bun install --frozen-lockfile 2>&1 && (cd apps/fabro-web && bun run typecheck) 2>&1 && (cd apps/fabro-web && bun run test) 2>&1 && (cd lib/packages/fabro-api-client && bun run typecheck) 2>&1 && cargo dev build -- -p fabro-cli --release 2>&1", goal_gate=true, retry_target="fixup"]
    fixup             [label="Fixup", prompt="The verify step failed. Read the build output from context and fix all format, clippy, Rust test, docs, TypeScript typecheck/test, and build failures.", max_visits=3]

    start -> toolchain
    toolchain -> preflight_compile [condition="outcome=succeeded"]
    toolchain -> exit
    preflight_compile -> preflight_lint [condition="outcome=succeeded"]
    preflight_compile -> exit
    preflight_lint -> implement [condition="outcome=succeeded"]
    preflight_lint -> fix_lints
    fix_lints -> preflight_lint
    implement -> simplify_opus -> simplify_gpt -> verify
    verify -> exit  [condition="outcome=succeeded"]
    verify -> fixup
    fixup -> verify
}

```

</details>

⚒️ Generated with [Fabro](https://fabro.sh)

---------

Co-authored-by: Fabro <noreply@fabro.sh>
2026-05-27 22:29:29 -04:00
..
build-support fix(build): refresh embedded git sha on branch commits 2026-05-09 14:10:04 -04:00
fabro-acp fix(workflow): capture configured artifacts once (#337) 2026-05-21 10:52:22 -04:00
fabro-agent fix(workflow): preserve usage across session compaction (#420) 2026-05-26 21:19:53 -04:00
fabro-api refactor: Remove inbound IP allowlisting (#443) 2026-05-27 22:29:08 -04:00
fabro-auth Replace vague expect/panic messages with invariant-explaining messages (#422) 2026-05-27 10:38:20 -04:00
fabro-automation Add GET/POST /automations/{id}/runs endpoints (#442) 2026-05-27 22:29:29 -04:00
fabro-checkpoint Make git metadata sandbox-native 2026-04-27 21:43:15 -07:00
fabro-cli refactor: Remove inbound IP allowlisting (#443) 2026-05-27 22:29:08 -04:00
fabro-client Add fabro variable CLI namespace for server-managed variables (#434) 2026-05-27 13:57:25 -04:00
fabro-config refactor: Remove inbound IP allowlisting (#443) 2026-05-27 22:29:08 -04:00
fabro-core Replace bare unwrap() with documented expect() across production runtim… (#415) 2026-05-26 17:46:39 -04:00
fabro-dev feat: add [run.agent] fabro_tools opt-in for worker run tools (#348) 2026-05-22 09:41:27 -04:00
fabro-dump Model run sandbox lifecycle explicitly (#431) 2026-05-27 12:48:56 -04:00
fabro-github fix(github): refresh installation tokens during workflows 2026-05-06 07:15:18 -04:00
fabro-graphviz Replace vague expect/panic messages with invariant-explaining messages (#422) 2026-05-27 10:38:20 -04:00
fabro-hooks Add event-sourced todo tools for OpenAI and Anthropic profiles (#353) 2026-05-22 13:44:42 -04:00
fabro-http refactor(static): centralize env var names 2026-04-24 12:29:51 -04:00
fabro-install Add provider-backed sandbox inventory API and rename SandboxProvider to… (#409) 2026-05-25 22:41:57 -04:00
fabro-interview Replace stdin JSONL control pipe with WebSocket worker control bus (#440) 2026-05-27 20:24:25 -04:00
fabro-llm Replace vague expect/panic messages with invariant-explaining messages (#422) 2026-05-27 10:38:20 -04:00
fabro-macros refactor(dev): simplify generated docs tooling 2026-04-24 18:41:00 -04:00
fabro-manifest feat(sandbox): secure daytona snapshot names (#429) 2026-05-27 11:52:35 -04:00
fabro-mcp Add legacy SSE MCP transport support (#386) 2026-05-24 15:29:01 -04:00
fabro-mcp-server feat: Add approve/deny run controls to MCP and CLI (#400) 2026-05-25 15:49:57 -04:00
fabro-model chore(model): update provider default models (#437) 2026-05-27 18:45:51 -04:00
fabro-oauth Replace bare unwrap() with documented expect() across production runtim… (#415) 2026-05-26 17:46:39 -04:00
fabro-options-metadata refactor(dev): simplify generated docs tooling 2026-04-24 18:41:00 -04:00
fabro-proc refactor(static): centralize env var names 2026-04-24 12:29:51 -04:00
fabro-redact refactor(integrations): make chat integrations Slack-only 2026-05-09 11:43:16 -04:00
fabro-sandbox Model run sandbox lifecycle explicitly (#431) 2026-05-27 12:48:56 -04:00
fabro-server Add GET/POST /automations/{id}/runs endpoints (#442) 2026-05-27 22:29:29 -04:00
fabro-slack Replace vague expect/panic messages with invariant-explaining messages (#422) 2026-05-27 10:38:20 -04:00
fabro-spa feat(dev): gitignore embedded spa assets 2026-04-26 21:31:11 -04:00
fabro-static refactor: rationalize server secret scopes (vault-only for optional int… (#401) 2026-05-25 17:26:01 -04:00
fabro-store Model run sandbox lifecycle explicitly (#431) 2026-05-27 12:48:56 -04:00
fabro-telemetry Replace vague expect/panic messages with invariant-explaining messages (#422) 2026-05-27 10:38:20 -04:00
fabro-template feat(template): resolve template error locations (#333) 2026-05-20 20:15:04 -04:00
fabro-test Add fabro variable CLI namespace for server-managed variables (#434) 2026-05-27 13:57:25 -04:00
fabro-tool feat: Add approve/deny run controls to MCP and CLI (#400) 2026-05-25 15:49:57 -04:00
fabro-tracker fix(github): refresh installation tokens during workflows 2026-05-06 07:15:18 -04:00
fabro-types refactor: Remove inbound IP allowlisting (#443) 2026-05-27 22:29:08 -04:00
fabro-util Replace vague expect/panic messages with invariant-explaining messages (#422) 2026-05-27 10:38:20 -04:00
fabro-validate fix(graph): support dotted Fabro graph attributes (#324) 2026-05-20 09:31:08 -04:00
fabro-variable feat(server): add variables API (#430) 2026-05-27 11:46:36 -04:00
fabro-vault feat(server): add variables API (#430) 2026-05-27 11:46:36 -04:00
fabro-workflow Replace stdin JSONL control pipe with WebSocket worker control bus (#440) 2026-05-27 20:24:25 -04:00