Skip to main content
ArgaAPIError carries statusCode, response and body. They can contain sensitive details; avoid logging raw responses or messages. Request timeouts raise ArgaError; unrelated network errors from fetch propagate separately. wait() validates positive finite intervals and timeouts and throws ArgaError when polling expires. Task edits and reviews use a revision. HTTP 409 indicates a stale revision; reload and review the current task. HTTP 422 can indicate insufficient trace coverage or invalid task evidence. Do not retry generation by inventing missing state. Tracing preserves the provider’s original return value or error. A projection failure records a coverage issue; it does not replace the provider result. await tracing.flush() reports queue drainage, not successful delivery. Check diagnostics().uploaded, failed and dropped, and inspect recentUploads(). BraintrustSync throws content-free SyncError diagnostics. A failed upload acknowledgement or read does not advance its window. Correct the problem and retry the same checkpoint. See sync progress and retries.