Skip to main content
Version: 1.x

Interface: AiResponseMetadata

Metadata attached to every AI response regardless of status.

Intent​

Track performance and provide self-healing hints.

Example​

const meta: AiResponseMetadata = {
  duration: 1200,
  retryable: true,
  suggestions: ['Reduce token count', 'Switch model'],
  model: 'gpt-4o',
  tokens: 842,
};

Properties​

duration​

readonly duration: number

Elapsed time in milliseconds for the AI call.

model?​

readonly optional model?: string

Model identifier used for this request, if available.

retryable​

readonly retryable: boolean

Whether the caller can retry this operation.

suggestions​

readonly suggestions: string[]

Human-readable recovery hints for agents and testers.

tokens?​

readonly optional tokens?: number

Total token count consumed, if available.