API and agentsAPI reference
AssistantAction
object
A known attempted action, never a raw tool-result body. Effects describe possible resources. Status distinguishes success, accepted asynchronous work (jobId), refusal and uncertainty. Additive facts recorded when the action happened: elapsedMs measures the dispatch alone, never a gate's wait; history names the map and change group of a qualifying change and is absent for excluded ones; decision says how a resolution settled a gated call; omitted marks an action whose arguments the terminal compaction dropped, so unavailable detail is never shown as empty. Missing text is covered by the receipt's incomplete flag. A map check carries render, its facts without bytes, observation, the separate later fact with its lifecycle, and automatic when the loop scheduled it itself. A terminal compaction may have dropped the render's detail lists, which is why this render's state has them optional while the check's own response does not.
idstringrequiredtoolstringrequiredargsobjectstatusstringrequiredOne of
attempted,succeeded,refused,uncertain,acceptedeffectsAssistantEffectsjobIdstringlabelstringThe record's line for the action, composed from the operation's declared display when it happened.
subjectAssistantSubjectelapsedMsintegerminimum0historyAssistantHistorydecisionstringOne of
approved,declinedomittedbooleanOne of
truerenderRecordedMapLookRenderobservationAssistantObservationautomaticbooleanOne of
true
7439201b