Interface ChatJobErrorFields

Structured fields preserved from a failed chat/LLM job.

interface ChatJobErrorFields {
    code?: string;
    errorType?: string;
    feature?: string;
    jobID?: string;
    limitation?: string;
    payload?: unknown;
    requiredPlans?: SubscriptionPlanId[];
    status?: number;
    subscriptionLimit?: boolean;
}

Properties

code?: string

Server error code exactly as sent on the wire (a string, e.g. '4080'). Currently attached by the socket server to subscription_unavailable denials — see SUBSCRIPTION_ERROR_CODES.

errorType?: string

Machine-readable error type tag from the server, e.g. 'subscription_unavailable', 'insufficient_balance', 'model_unavailable', 'invalid_request'.

feature?: string

Stable machine key for the gated capability, e.g. 'video_4k_render'.

jobID?: string

Chat job id the failure belongs to, when known (socket transport).

limitation?: string

Standalone user-facing English describing the limitation.

payload?: unknown

Raw error payload as received from the server (socket message or REST body).

requiredPlans?: SubscriptionPlanId[]

Plans that would satisfy the gated feature, cheapest-first.

status?: number

HTTP status when the failure came from a REST chat endpoint.

subscriptionLimit?: boolean

true when this failure is a subscription FEATURE-gate denial (4081).