Interface StructuredGenerationResult<T>

Result of structured output generation.

interface StructuredGenerationResult<T> {
    success: boolean;
    data?: T;
    rawOutput: string;
    validationErrors?: ValidationIssue[];
    strategyUsed: StructuredOutputStrategy;
    retryCount: number;
    tokenUsage?: {
        promptTokens: number;
        completionTokens: number;
        totalTokens: number;
    };
    latencyMs: number;
    reasoning?: string;
    modelId: string;
    providerId: string;
}

Type Parameters

  • T = unknown

    The expected type of the parsed data

Properties

success: boolean

Whether generation and validation succeeded

data?: T

The parsed, validated data (if successful)

rawOutput: string

Raw string output from the LLM

validationErrors?: ValidationIssue[]

Validation errors if any

The strategy that was used

retryCount: number

Number of retry attempts made

tokenUsage?: {
    promptTokens: number;
    completionTokens: number;
    totalTokens: number;
}

Token usage statistics

Type declaration

  • promptTokens: number
  • completionTokens: number
  • totalTokens: number
latencyMs: number

Generation latency in milliseconds

reasoning?: string

Reasoning/chain-of-thought if requested

modelId: string

Model that was used

providerId: string

Provider that was used