Interface: ToolAbsence

Defined in: src/semantics/coverage/types.ts:258

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/semantics/coverage/types.ts:259

---

cannot_cover?

readonly optional cannot_cover?: readonly CoverageItem[]

Defined in: src/semantics/coverage/types.ts:266

---

checked

readonly checked: readonly CoverageItem[]

Defined in: src/semantics/coverage/types.ts:264

---

looked_for

readonly looked_for: string

Defined in: src/semantics/coverage/types.ts:263

---

not_checked?

readonly optional not_checked?: readonly CoverageItem[]

Defined in: src/semantics/coverage/types.ts:265

---

note

readonly note: string

Defined in: src/semantics/coverage/types.ts:283

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

---

outcome

readonly outcome: "nothing_found"

Defined in: src/semantics/coverage/types.ts:262

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

---

period?

readonly optional period?: object

Defined in: src/semantics/coverage/types.ts:281

What the search's read covered in time — queried, held (or 'unknown'), read_at — honesty step 7b.

held

readonly held: "unknown" | { from: string; to: string; }

queried

readonly queried: object

queried.from

readonly from: string

queried.to

readonly to: string

read_at?

readonly optional read_at?: string

---

provenance?

readonly optional provenance?: SemanticProvenance

Defined in: src/semantics/coverage/types.ts:278

Where the search looked and when that source was measured — the wire describedResult() mints (measured_at, source, …), honesty step 7b.

---

retry_returns_the_same

readonly retry_returns_the_same: true

Defined in: src/semantics/coverage/types.ts:269

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/semantics/coverage/types.ts:272

The author's sentence. A string, always — the typed tool rides its own key, so a reader of this one never has to narrow it.

---

try_instead_tool?

readonly optional try_instead_tool?: TryInsteadTool

Defined in: src/semantics/coverage/types.ts:275

The typed tool the suggestion points at (9.113.0), as declared — the author's words, { tool, why? }. The model reads it as written.