Stop runs

A React block (a whole screen) in Beamline's SaaS admin app.

Stopping an automation as two commands that say what they do. Stop new runs takes no new ones while the runs already going carry on, the count falling as they finish; stop everything now asks first, cancels the runs going and reports each as it ends: cancelled, finished first, or couldn't be stopped. It never reads stopped while work still runs. New runs resume with one press; a failed request is said with what didn't change and a retry. Every state is a word as well as a tint.

Use it for

The stop control of an automation, workflow, queue or scheduled job whose runs take time.
Any place where turning off new work and cancelling work in flight are different commands.

Not for

One run's steps and outcome (automation-runs).
Pausing a single media or timer (a play/pause control).

Anatomy

header: the product's mark, the automation, Stop (two commands, each with its consequence) or Take new runs again
state: taking new runs, not taking new runs with what's still going, stopping, partly stopped, stopped
outcome: of the runs asked to stop, how many were cancelled, finished first, couldn't be stopped
error: what failed, that nothing changed, Try again
runs: who, step, when started, how it stands

States

taking new runs, some going (green)
not taking new runs, still going (amber, counts down)
stopping (blue)
partly stopped (red): some couldn't be stopped
stopped: none new, none going
request failed (said, retry)
phone: one column
right to left: the page mirrors

Keyboard

Stop opens its menu; arrows choose; Enter runs it
Stop everything asks first; Keep running is focused

Motion

The state line's tint eases between states; nothing moves at rest.

Props

Prop	Type	Default	Description
`automation` (required)	`string`	—
`runs` (required)	`RunItem[]`	—	The runs as the host reports them; finishing runs update here.
`defaultAccepting`	`boolean`	—
`onStopNew`	`(() => Promise<void>)`	—	Stops admitting new runs; running ones carry on. Rejects with a reason to say.
`onStopAll`	`((ids: string[]) => Promise<void>)`	—	Stops admitting and asks the given runs to cancel; resolves once each has reported (via runs).
`onResume`	`(() => Promise<void>)`	—
`now`	`Date`	—
`product`	`string`	—	Your product's name, shown as its mark.
`className`	`string`	—	Classes on the documented visual root; no override by default.
`ref`	`Ref<HTMLDivElement>`	—	Receives the documented native target or imperative handle; omitted by default.
`steps`	`string[]`	—	The automation's steps in order; runs are drawn at the step they're on. Taken from the runs when omitted.

Built from

Import

import { StopRuns } from "@beamline/stop-runs";

Get it

Stop runs is part of Beamline UI. Install the parts you need in your React app as compiled packages or editable source. Get Beamline · Connect your agent