Interface: OutputAttempt

Defined in: src/core/agent/outputEnforcement.ts:50

One row per final-answer attempt an enforcing agent made, in order.

Rows exist ONLY on an agent that opted into retries. Without the option the schema is judged after the run as it always was, nothing in the loop looks at it, and this key is never written.

Properties

attempt

readonly attempt: number

Defined in: src/core/agent/outputEnforcement.ts:52

1-based attempt number within this run.

---

brokenBy?

readonly optional brokenBy?: string

Defined in: src/core/agent/outputEnforcement.ts:83

Set on an 'exhausted' row when the answer the MODEL produced satisfied the schema and an act({ output }) middleware's rewrite broke it — the name of that middleware (8.18.0).

Its presence is also why the row is 'exhausted' with retries still on the clock: a rule that turns a valid answer into an invalid one will do it to the next answer too, so the run stops paying for re-asks that cannot converge.

---

correctiveMessageHash?

readonly optional correctiveMessageHash?: string

Defined in: src/core/agent/outputEnforcement.ts:72

fnv1a of the corrective message this row's failure produced. Present only on a 'retried' row — it is the join back to the message in the conversation and to the output_schema_retry event's payload.

---

error?

readonly optional error?: string

Defined in: src/core/agent/outputEnforcement.ts:66

The validator's own message, verbatim. Absent on a passing row.

---

iteration

readonly iteration: number

Defined in: src/core/agent/outputEnforcement.ts:54

The ReAct iteration that produced the answer.

---

outcome

readonly outcome: "retried" | "passed" | "exhausted"

Defined in: src/core/agent/outputEnforcement.ts:62

What became of this attempt: • 'passed' — the answer satisfied the schema; the run returns it. • 'retried' — it failed and a corrective turn was sent. • 'exhausted' — it failed with no retries left; this answer stands, and runTyped() throws on it exactly as it always did.

---

path?

readonly optional path?: string

Defined in: src/core/agent/outputEnforcement.ts:68

Failing field path when the parser exposes one (Zod-style issues).

---

stage?

readonly optional stage?: "json-parse" | "schema-validate"

Defined in: src/core/agent/outputEnforcement.ts:64

Which half of validation failed. Absent on a passing row.