Interface: ToolAbsence

Defined in: src/core/agent/coverage/types.ts:106

The rendered absence — the exact object a tool hands back and the model reads. Field names are snake_case and English on purpose: this value is read by a language model far more often than by code, and af_absent is the only field here that exists for the machine.

The af_absent key is RESERVED vocabulary on the tool-result wire (the propose-transition / require-instruction precedent): a plain object carrying it is an absence, and nothing else in this library will treat any other shape as one.

Properties

af_absent

readonly af_absent: true

Defined in: src/core/agent/coverage/types.ts:107

---

cannot_cover?

readonly optional cannot_cover?: readonly CoverageItem[]

Defined in: src/core/agent/coverage/types.ts:114

---

checked

readonly checked: readonly CoverageItem[]

Defined in: src/core/agent/coverage/types.ts:112

---

looked_for

readonly looked_for: string

Defined in: src/core/agent/coverage/types.ts:111

---

not_checked?

readonly optional not_checked?: readonly CoverageItem[]

Defined in: src/core/agent/coverage/types.ts:113

---

note

readonly note: string

Defined in: src/core/agent/coverage/types.ts:120

The static sentence. Never interpolated — see absent.ts.

---

outcome

readonly outcome: "nothing_found"

Defined in: src/core/agent/coverage/types.ts:110

The plain-English handle. Present so a model that skims one key still reads the outcome rather than inferring it from a missing field.

---

retry_returns_the_same

readonly retry_returns_the_same: true

Defined in: src/core/agent/coverage/types.ts:117

Stated as data as well as prose — the note can be skimmed past, a true in a field named for the question cannot.

---

try_instead?

readonly optional try_instead?: string

Defined in: src/core/agent/coverage/types.ts:118