@usine/core/attempt/failure

Classes

AgentFailure

The agent ran and failed the work itself. Never auto-retried, since the same agent would fail the same way; the operator decides what changes first.

Extends

• Schema.Class

Constructors

Constructor

new AgentFailure(…args): AgentFailure

Parameters

Parameter	Type
…args	[props: object, options?: MakeOptions]

Returns

AgentFailure

Properties

message

readonly message: string

---

ChildSessionBudgetFailure

The parent tried to spawn more child sessions than the Attempt allows. Never auto-retried, since the same parent would exhaust the same budget again.

Extends

• Schema.Class

Constructors

Constructor

new ChildSessionBudgetFailure(…args): ChildSessionBudgetFailure

Parameters

Parameter	Type
…args	[props: object, options?: MakeOptions]

Returns

ChildSessionBudgetFailure

Properties

attemptedChildren

readonly attemptedChildren: number & Brand<"ChildSessionCount">

maxChildren

readonly maxChildren: number & Brand<"ChildSessionBudget">

---

DefectFailure

A programmer defect captured at the durable execution boundary. Retains its cause for diagnosis and requires an operator retry.

Extends

• Schema.Class

Constructors

Constructor

new DefectFailure(…args): DefectFailure

Parameters

Parameter	Type
…args	[props: object, options?: MakeOptions]

Returns

DefectFailure

Properties

cause

readonly cause: unknown

message

readonly message: string

---

InfraFailure

Infrastructure failed around the agent: worker unreachable, checkout failed, parent task lost. The only class the engine retries on its own, capped.

Extends

• Schema.Class

Constructors

Constructor

new InfraFailure(…args): InfraFailure

Parameters

Parameter	Type
…args	[props: object, options?: MakeOptions]

Returns

InfraFailure

Properties

cause

readonly cause: unknown

message

readonly message: string

---

RunawayFailure

The runaway guard interrupted an attempt that burned without progress. Never auto-retried (ADR 0013).

Extends

• Schema.Class

Constructors

Constructor

new RunawayFailure(…args): RunawayFailure

Parameters

Parameter	Type
…args	[props: object, options?: MakeOptions]

Returns

RunawayFailure

Properties

ceiling

readonly ceiling: "wall-clock" | "tokens"

Type Aliases

AttemptFailure

AttemptFailure = typeof AttemptFailure.Type

---

RunawayCeiling

RunawayCeiling = typeof RunawayCeiling.Type

Which per-attempt ceiling the runaway guard tripped.

Variables

AttemptFailure

const AttemptFailure: Schema.Union<readonly [typeof InfraFailure, typeof DefectFailure, typeof AgentFailure, typeof RunawayFailure, typeof ChildSessionBudgetFailure]>

---

isAutoRetryableFailure

const isAutoRetryableFailure: <I>(input) => input is I & InfraFailure

The class half of the auto-retry law: only infra failures qualify. shouldAutoRetry adds the attempt cap.

Type Parameters

Type Parameter
I

Parameters

Parameter	Type
input	I

Returns

input is I & InfraFailure

---

RunawayCeiling

const RunawayCeiling: Schema.Literals<readonly ["wall-clock", "tokens"]>

Which per-attempt ceiling the runaway guard tripped.