[BATCH] Stale batch ${batch.id} has no item checkpoints; fai

Error message

[BATCH] Stale batch ${batch.id} has no item checkpoints; failing instead of replaying provider calls

What it means

Error "[BATCH] Stale batch ${batch.id} has no item checkpoints; failing instead of replaying provider calls" thrown in diegosouzapw/OmniRoute.

Source

Thrown at open-sse/services/batchProcessor.ts:118

    } else if (batch.status === "cancelling") {
      await cancelBatch(batch);
    }
  }

  // Cleanup task: delete files for batches completed more than completionWindow ago
  await cleanupExpiredBatches();
}

function recoverStaleBatch(batch: BatchRecord): void {
  const checkpointCount = countBatchItemCheckpoints(batch.id);
  const hasPotentialExternalEffects =
    batch.requestCountsTotal > 0 ||
    batch.requestCountsCompleted > 0 ||
    batch.requestCountsFailed > 0 ||
    batch.status === "finalizing";

  if (checkpointCount === 0 && hasPotentialExternalEffects) {
    console.warn(
      `[BATCH] Stale batch ${batch.id} has no item checkpoints; failing instead of replaying provider calls`
    );
    failBatch(
      batch.id,
      "Cannot safely recover stale batch because item checkpoints are unavailable; create a new batch to retry intentionally."
    );
    return;
  }

  console.log(`[BATCH] Recovering stale batch ${batch.id} (${batch.status}) → validating`);

  if (batch.outputFileId) {
    deleteFile(batch.outputFileId);
  }
  if (batch.errorFileId) {
    deleteFile(batch.errorFileId);
  }

View on GitHub (pinned to a179ffed5b)

When it happens

Trigger: Thrown at open-sse/services/batchProcessor.ts:118 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of diegosouzapw/OmniRoute@a179ffed5b (2026-08-25). Data as JSON: /api/errors/a62afa3cb56d4519. Report an issue: GitHub.