Rulvar API reference

---

Rulvar API reference / @rulvar/core / FailRunError

Class: FailRunError

Defined in: packages/core/src/l0/errors.ts:309

A declared fail-run policy engaged and closed the run as a failure (v1.35.0 review P2-1): budget.atCap: 'fail-run' after the journaled orchestrator cap decision, guards.fallback: 'fail-run' after the journaled guard verdict, or a violated orchestrate acceptance policy after the journaled acceptance decision (data.source 'orchestrator_acceptance', with the child status counts and degraded reasons in data). The run outcome is 'error' with this code; data.source names the policy ('orchestrator_budget_cap' or 'plan_guards') and data carries the decision entry reference, so the outcome is a pure roll forward of the journal on resume: no second decision, no model call, no spend.

Extends

• RulvarError

Constructors

Constructor

new FailRunError(message, opts?): FailRunError;

Defined in: packages/core/src/l0/errors.ts:312

Parameters

Parameter	Type
message	string
opts?	{ cause?: unknown; data?: Json; }
opts.cause?	unknown
opts.data?	Json

Returns

FailRunError

Overrides

RulvarError.constructor

Properties

Property	Modifier	Type	Overrides	Inherited from	Defined in
code	readonly	"fail_run"	RulvarError.code	-	packages/core/src/l0/errors.ts:310
data?	readonly	Json	-	RulvarError.data	packages/core/src/l0/errors.ts:64
retryable	readonly	boolean	-	RulvarError.retryable	packages/core/src/l0/errors.ts:63

Methods

toWire()

toWire(): WireError;

Defined in: packages/core/src/l0/errors.ts:75

Returns

WireError

Inherited from

RulvarError.toWire