@usine/core/attempt

Classes

Attempt

One try of a step on a worker. outcome is none while the attempt is in flight. salvage records what the executor preserved of the workspace after an unsuccessful end; the next attempt of the same Run resumes from a pushed salvage.

Extends

• Schema.Class

Constructors

Constructor

new Attempt(…args): Attempt

Parameters

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

Returns

Attempt

Properties

agent

readonly agent: string & Brand<"AgentName">

brain

readonly brain: BrainSpec

id

readonly id: string & Brand<"AttemptId">

number

readonly number: number & Brand<"AttemptNumber">

operatorIntervened

readonly operatorIntervened: boolean

outcome

readonly outcome: Option<AttemptSucceeded | AttemptFailed | AttemptCanceled>

parentModel

readonly parentModel: Option<string & Brand<"ModelId">>

runId

readonly runId: string & Brand<"RunId">

salvage

readonly salvage: Option<SalvagePushed | SalvageRetained>

startedAt

readonly startedAt: Utc

stepName

readonly stepName: string & Brand<"StepName">

task

readonly task: string & Brand<"AttemptTask">

worker

readonly worker: string & Brand<"WorkerName">

---

AttemptContext

The effective task and roster Agent an operator assigns to a Run’s later Attempts.

Extends

• Schema.Class

Constructors

Constructor

new AttemptContext(…args): AttemptContext

Parameters

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

Returns

AttemptContext

Properties

agent

readonly agent: Agent

parentModel

readonly parentModel: Option<string & Brand<"ModelId">>

task

readonly task: string & Brand<"AttemptTask">

Type Aliases

AttemptId

AttemptId = typeof AttemptId.Type

Identity of one execution try; each retry receives a new identity under the same Run and Step.

---

AttemptNumber

AttemptNumber = typeof AttemptNumber.Type

1-based position of a try under its step. Retries are attempt N+1 under the same step, and the auto-retry cap counts total attempts.

---

AttemptTask

AttemptTask = typeof AttemptTask.Type

Task text given to the agent after loop interpolation or an operator’s edit-and-retry amendment.

Variables

AttemptId

const AttemptId: Schema.brand<Schema.NonEmptyString, "AttemptId">

Identity of one execution try; each retry receives a new identity under the same Run and Step.

---

AttemptNumber

const AttemptNumber: Schema.brand<Schema.Int, "AttemptNumber">

1-based position of a try under its step. Retries are attempt N+1 under the same step, and the auto-retry cap counts total attempts.

---

AttemptTask

const AttemptTask: Schema.brand<Schema.String, "AttemptTask">

Task text given to the agent after loop interpolation or an operator’s edit-and-retry amendment.

---

shouldAutoRetry

const shouldAutoRetry: (options) => boolean

The auto-retry law: only an infra failure retries, and only while the attempt number is below maxAutoAttempts (ADR 0002). number is the failed try’s position; maxAutoAttempts includes the first try.

Parameters

Parameter	Type
options	{ failure: AttemptFailure; maxAutoAttempts: AttemptNumber; number: AttemptNumber; }
options.failure	AttemptFailure
options.maxAutoAttempts	AttemptNumber
options.number	AttemptNumber

Returns

boolean