Function remapSequenceErrorStepIndex

src/core/dispatch-interactions.ts:478–496

(error: unknown, stepOffset: number)

// Sequence step errors carry a chunk-local failedStepIndex and completedSteps; rebase both onto the
// global series so the error names the true step and completed count across chunk boundaries.
function remapSequenceErrorStepIndex(error: unknown, stepOffset: number): unknown {
  if (stepOffset === 0 || !(error instanceof AppError) || !error.details) return error;
  const localIndex = error.details.failedStepIndex;
  if (typeof localIndex !== 'number') return error;
  const localCompletedSteps = error.details.completedSteps;
  return new AppError(
    error.code,
    error.message,
    {
      ...error.details,
      failedStepIndex: localIndex + stepOffset,
      chunkStepIndex: localIndex,
      ...(typeof localCompletedSteps === 'number'
        ? { completedSteps: stepOffset + localCompletedSteps }
        : {}),
    },
    error.cause,
  );
}

async function runDirectPressSeries(
  interactor: Interactor,