TurnResponse interface

Validated response returned by a compiled agent.

Signature:

typescript

export interface TurnResponse

Properties

Property	Modifiers	Type	Description
artifacts	`readonly`	readonly Artifact[]	Structured outputs available to the host channel.
claims	`readonly`	readonly ResponseClaim[]	Evidence annotations for every factual business span.
grounded	`readonly`	boolean	True after citation validation and either semantic model review or trusted server-authored delivery.
interaction?	`readonly`	Interaction	(Optional) User interaction that remains active after this turn.
message	`readonly`	string	User-facing response text.
source	`readonly`	"model" \| "canonical" \| "technical_fallback"	Component responsible for the final response copy.
status	`readonly`	"completed" \| "failed"	Whether the conversational turn completed or failed closed.
traceId?	`readonly`	string	(Optional) Correlation identity included on a technical failure response.