LookupResult
An adapter's answer about an operation it may have performed; each answer carries its own finality.
found: it happened (effect confirmed_success, model_response_recovered, ledger row live). not_found: final, the provider's contract proves nothing was created or sent (effect safe_to_retry, model attempt not_sent, ledger row released). not_found_nonfinal (not seen yet, may still appear) and unknown (lookup failed or can't answer) settle nothing: the effect parks, the model attempt is abandoned as unknown, the ledger row becomes unknown (resource_unknown). The runtime accepts not_found only from an operation whose declared LookupCapability is final and treats it as not_found_nonfinal otherwise; finality is never inferred from lookup being available.
A union discriminated by status.
found
status"found"required"found": the operation happened, and value is what it produced.
valueTrequiredWhat the found operation produced: the recovered model response, the sandbox session or the snapshot data.
not_found
status"not_found"required"not_found": the provider proves nothing was created or sent. Accepted only from an operation whose LookupCapability is final.
not_found_nonfinal
status"not_found_nonfinal"required"not_found_nonfinal": not seen yet, but it may still appear. Settles nothing.
unknown
status"unknown"required"unknown": the lookup failed or can't answer. Settles nothing.
reasonstringrequiredFree text saying why the lookup couldn't answer, for logs and people (for example transport_error).