Interface BenchResetActivityArgs

Replaces the bench's access for this call. When supplied, individual access shortcuts are ignored.

Name of the activity to reset, within the instance's current stage.

Actor for this call. Omit to use the bench's actor. Changing only the actor retains the bench's default grants and attributes.

URL path for grant resolution — see StartInstanceArgs.grantsFromPath.

Caller-supplied key that makes this call safe to retry blind (a network failure ate the response; a queue redelivered the message). The first commit records the key on the instance's processedRequests[] ledger — in the same CAS write as the operation itself — and a retry carrying the same key replays instead of double-applying (or, for a completed effect, throwing EffectNotFoundError): the operation is NOT re-applied, but the cascade runs to convergence (the original may have died before its own cascade), so changed is false unless that cascade repaired something. Keys live for the engine's idempotencyTtlMs (default 24h); reusing a live key on a different verb throws. The caller owns key uniqueness per logical request.

Only a commit records the key: a keyed call that no-ops (a setStage already at its target, an abort of a terminal instance) leaves no ledger row, so retrying it later re-evaluates fresh rather than replaying.

The target status. active (the default) reopens the activity for caller-fired actions. skipped counts the activity as resolved for $allActivitiesDone. Returning to active does not repeat a when action that already fired during this stage visit.