Class ChatJobError

Error thrown/streamed when a chat/LLM job fails, preserving the server's error contract so apps can branch on machine-readable fields instead of string-matching .message.

message stays the human-readable server message (unchanged from the plain Error this class replaces). code/errorCode carry the wire error code when present — for jobs submitted with billingMode: 'subscription', the subscription denial codes from SUBSCRIPTION_ERROR_CODES ('4078' not entitled, '4080' billing-grace renewal retry). errorType carries the server's error tag, e.g. 'subscription_unavailable'.

try {
  for await (const chunk of stream) { ... }
} catch (err) {
  if (err instanceof ChatJobError && err.errorType === 'subscription_unavailable') {
    // offer a "pay with Spark/SOGNI" fallback instead of retrying
  }
}
Copy